Fonction DrawThemeTextEx (uxtheme.h)

Dessine du texte à l’aide de la couleur et de la police définies par le style visuel. Étend DrawThemeText en autorisant des options de format de texte supplémentaires.

Syntaxe

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

Paramètres

[in] hTheme

Type : HTHEME

Gérez les données de thème spécifiées d’une fenêtre. Utilisez OpenThemeData pour créer un HTHEME.

[in] hdc

Type : HDC

HDC à utiliser pour le dessin.

[in] iPartId

Type : int

Composant du contrôle ayant l’apparence de texte désirée. Consultez Parties et états. Si cette valeur est égale à 0, le texte est dessiné avec la police par défaut ou une police sélectionnée dans le contexte de l’appareil.

[in] iStateId

Type : int

État du contrôle ayant l’apparence de texte désirée. Consultez Parties et états.

[in] pszText

Type : LPCWSTR

Pointeur vers une chaîne qui contient le texte à dessiner.

[in] cchText

Type : int

Valeur de type int qui contient le nombre de caractères à dessiner. Si le paramètre a la valeur -1, tous les caractères de la chaîne sont dessinés.

[in] dwTextFlags

Type : DWORD

DWORD qui contient une ou plusieurs valeurs qui spécifient la mise en forme de la chaîne. Pour connaître les valeurs de paramètres possibles, consultez Format des valeurs .

[in, out] pRect

Type : LPRECT

Pointeur vers une structure RECT qui contient le rectangle, en coordonnées logiques, dans lequel le texte doit être dessiné.

[in] pOptions

Type : const DTTOPTS*

Structure DTTOPTS qui définit des options de mise en forme supplémentaires qui seront appliquées au texte en cours de dessin.

Valeur retournée

Type : HRESULT

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

Remarques

La fonction utilise toujours la police de thème pour la partie et l’état spécifiés, le cas échéant. Sinon, il utilise la police actuellement sélectionnée dans le contexte de l’appareil. Pour savoir si une police à thème est définie, vous pouvez appeler GetThemeFont ou GetThemePropertyOrigin avec TMT_FONT comme identificateur de propriété.

Configuration requise

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