Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GetThemeSysString
Collapse the table of content
Expand the table of content

GetThemeSysString function

Retrieves the value of a system string.

Syntax


HRESULT GetThemeSysString(
  _In_  HTHEME hTheme,
  _In_  int    iStringID,
  _Out_ LPWSTR pszStringBuff,
  _In_  int    cchMaxStringChars
);

Parameters

hTheme [in]

Type: HTHEME

Handle to theme data.

iStringID [in]

Type: int

Value of type int that specifies a system string. May be one of the following values.

ValueMeaning
TMT_CSSNAME

The name of the CSS file associated with the theme specified by hTheme.

TMT_XMLNAME

The name of the XML file associated with the theme specified by hTheme.

 

pszStringBuff [out]

Type: LPWSTR

Pointer to the buffer that receives the string value from this function.

cchMaxStringChars [in]

Type: int

Value of type int that specifies the maximum number of characters the string buffer can hold.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the theme data handle is not a NULL handle, this function returns the desired string from the SysMetrics section of the visual style. If the theme data handle is NULL, this function returns the value of the global system metric of the same type.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft