GetThemeFilename Function


This is preliminary documentation and is subject to change.

Retrieves the value of a specified COLOR property.

Syntax

HRESULT GetThemeFilename(
    HTHEME hTheme, 
    int iPartId, 
    int iStateId, 
    int iPropId, 
    LPWSTR *pszBuff, 
    DWORD dwMaxBuffChars
);

Parameters

hTheme
Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.
iPartId
Integer that specifies the part that contains the FILENAME property.
iStateId
Integer that specifies the state of the part.
iPropId
Integer that specifies the property to retrieve.
pszBuff
[out] Pointer to a buffer that receives the retrieved filename.
dwMaxBuffChars
DWORD that receives the maximum number of characters in the filename

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Certain primitive property types are defined for use with the theme-aware controls. The FILENAME property is defined as a relative path to a file.

Function Information

Stock ImplementationUxTheme.dll
Custom ImplementationNo
HeaderThemeApi.h
Import libraryUxTheme.lib
Minimum operating systems Windows NT Whistler


© 2000 Microsoft Corporation. All rights reserved. Terms of use.