Fonction ExtTextOutWrap

Article
06/13/2023

[ExtTextOutWrap est disponible via Windows XP avec Service Pack 2 (SP2). Il peut être modifié ou indisponible dans les versions ultérieures. Il est recommandé d’utiliser ExtTextOut directement à la place.]

Dessine du texte à l’aide de la police, de la couleur d’arrière-plan et de la couleur de texte actuellement sélectionnées. Vous pouvez éventuellement fournir des dimensions à utiliser pour le découpage, l’opacité ou les deux. Cette fonction encapsule un appel à ExtTextOut.

Syntaxe

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

Paramètres

hdc [in]

Type : HDC

Handle pour le contexte de l’appareil.

X [in]

Type : int

Coordonnée x, en coordonnées logiques, du point de référence utilisé pour positionner la chaîne.

Y [in]

Type : int

Coordonnée y, en coordonnées logiques, du point de référence utilisé pour positionner la chaîne.

uOptions [in]

Type : UINT

Valeurs qui spécifient comment utiliser le rectangle défini par l’application. Pour obtenir la liste complète des options, consultez ExtTextOut .

lprc [in]

Type : const RECT*

Pointeur vers une structure RECT facultative qui spécifie les dimensions, en coordonnées logiques, d’un rectangle utilisé pour le découpage, l’opacité ou les deux.

lpString [in]

Type : LPCTSTR

Pointeur vers une mémoire tampon qui contient le texte à dessiner. La chaîne n’a pas besoin d’être terminée à zéro, car cbCount spécifie la longueur de la chaîne.

cbCount [in]

Type : UINT

Longueur de la chaîne, en octets, pointée par lpString.

lpDx [in]

Type : const INT*

Pointeur vers un tableau facultatif de valeurs qui indiquent la distance entre les origines des cellules de caractères adjacentes. Par exemple, les unités logiques lpDx[x] séparent les origines de la cellule de caractère x et de la cellule de caractère (x + 1).

Valeur retournée

Type : BOOL

Retourne une valeur différente de zéro si la chaîne est dessinée avec succès. Toutefois, si la version ANSI d’ExtTextOut est appelée avec ETO_GLYPH_INDEX, la fonction retourne TRUE même si la fonction ne fait rien.

Si la fonction échoue, la valeur de retour est égale à zéro.

Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

ExtTextOutWrap n’est pas exporté par nom ou déclaré dans un fichier d’en-tête public. Pour l’utiliser, vous devez utiliser GetProcAddress et demander l’ordinal 417 à partir de ComCtl32.dll pour obtenir un pointeur de fonction.

Pour obtenir des remarques supplémentaires, consultez ExtTextOut.

Spécifications

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]
DLL	Comctl32.dll (version 6.0 ou ultérieure)

Partager via