GetThemeSysString-Funktion (uxtheme.h)

  • Artikel

Ruft den Wert einer Systemzeichenfolge ab.

Syntax

HRESULT GetThemeSysString(
  [in]  HTHEME hTheme,
  [in]  int    iStringId,
  [out] LPWSTR pszStringBuff,
  [in]  int    cchMaxStringChars
);

Parameter

[in] hTheme

Typ: HTHEME

Behandeln von Designdaten.

[in] iStringId

Typ: int

Der Wert vom Typ int , der eine Systemzeichenfolge angibt. Kann einer der folgenden Werte sein.

Wert Bedeutung
TMT_CSSNAME
 Der Name der CSS-Datei, die dem von hTheme angegebenen Design zugeordnet ist.
TMT_XMLNAME
 Der Name der XML-Datei, die dem von hTheme angegebenen Design zugeordnet ist.

[out] pszStringBuff

Typ: LPWSTR

Zeiger auf den Puffer, der den Zeichenfolgenwert von dieser Funktion empfängt.

[in] cchMaxStringChars

Typ: int

Der Wert vom Typ int , der die maximale Anzahl von Zeichen angibt, die der Zeichenfolgenpuffer enthalten kann.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn das Designdatenhandle kein NULL-Handle ist, gibt diese Funktion die gewünschte Zeichenfolge aus dem Abschnitt SysMetrics des visuellen Stils zurück. Wenn das Designdatenhandle NULL ist, gibt diese Funktion den Wert der globalen Systemmetrik desselben Typs zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll