GetThemeSysString, fonction (uxtheme.h)

Article
03/03/2024

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

Partager via