Fonction ExtTextOutWrap
[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 |
|