GetThemeSysString-Funktion (uxtheme.h)

Artikel
03/03/2024

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

Freigeben über