Partager via


GetThemeSysString, fonction (uxtheme.h)

Récupère la valeur d’une chaîne système.

Syntaxe

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

Paramètres

[in] hTheme

Type : HTHEME

Gérez les données du thème.

[in] iStringId

Type : int

Valeur de type int qui spécifie une chaîne système. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
TMT_CSSNAME
Nom du fichier CSS associé au thème spécifié par hTheme.
TMT_XMLNAME
Nom du fichier XML associé au thème spécifié par hTheme.

[out] pszStringBuff

Type : LPWSTR

Pointeur vers la mémoire tampon qui reçoit la valeur de chaîne de cette fonction.

[in] cchMaxStringChars

Type : int

Valeur de type int qui spécifie le nombre maximal de caractères que la mémoire tampon de chaîne peut contenir.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si le handle de données de thème n’est pas un handle NULL , cette fonction retourne la chaîne souhaitée à partir de la section SysMetrics du style visuel. Si le handle de données de thème est NULL, cette fonction retourne la valeur de la métrique système globale du même type.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uxtheme.h
Bibliothèque UxTheme.lib
DLL UxTheme.dll