ExtTextOutWrap fonction)

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

Dessine le 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 [ dans]

Type : HDC

Handle vers le contexte de périphérique (Device Context).

X [ dans]

Type : int

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

Y [ dans]

Type : int

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

uOptions [ dans]

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 [ dans]

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 [ dans]

Type : LPCTSTR

Pointeur vers une mémoire tampon qui contient le texte à dessiner. Il n’est pas nécessaire que la chaîne se termine par zéro, car cbCount spécifie la longueur de la chaîne.

cbCount [ dans]

Type : uint

Longueur de la chaîne, en octets, vers laquelle pointe lpString.

lpDx [ dans]

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 correctement. Toutefois, si la version ANSI de ExtTextOut est appelée avec l' _ index de glyphes ETO _ , la fonction retourne la valeur 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 de ComCtl32.dll pour obtenir un pointeur de fonction.

Pour des remarques supplémentaires, consultez ExtTextOut.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
DLL
Comctl32.dll (version 6,0 ou ultérieure)