ExtTextOutA, fonction (wingdi.h)

La fonction ExtTextOut dessine du texte à l’aide de la police, de la couleur d’arrière-plan et de la couleur de texte actuellement sélectionnée. Vous pouvez éventuellement fournir des dimensions à utiliser pour le découpage, l’opaquage ou les deux.

Syntaxe

BOOL ExtTextOutA(
  [in] HDC        hdc,
  [in] int        x,
  [in] int        y,
  [in] UINT       options,
  [in] const RECT *lprect,
  [in] LPCSTR     lpString,
  [in] UINT       c,
  [in] const INT  *lpDx
);

Paramètres

[in] hdc

Handle vers le contexte de l’appareil.

[in] x

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

[in] y

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

[in] options

Spécifie comment utiliser le rectangle défini par l’application. Ce paramètre peut être une ou plusieurs des valeurs suivantes.

Les valeurs ETO_GLYPH_INDEX et ETO_RTLREADING ne peuvent pas être utilisées ensemble. Étant donné que ETO_GLYPH_INDEX implique que tout le traitement du langage a été effectué, la fonction ignore l’indicateur de ETO_RTLREADING si elle est également spécifiée.

[in] lprect

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

[in] lpString

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

[in] c

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

Cette valeur peut ne pas dépasser 8192.

[in] lpDx

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

Valeur de retour

Si la chaîne est dessinée, la valeur de retour est différente de zéro. Toutefois, si la version ANSI de 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.

Remarques

Les paramètres d’alignement de texte actuels pour le contexte d’appareil spécifié déterminent la façon dont le point de référence est utilisé pour positionner le texte. Les paramètres d’alignement du texte sont récupérés en appelant la fonction GetTextAlign. Les paramètres d’alignement du texte sont modifiés en appelant la fonction SetTextAlign. Vous pouvez utiliser les valeurs suivantes pour l’alignement du texte. Un seul indicateur peut être choisi parmi ceux qui affectent l’alignement horizontal et vertical. En outre, seul un des deux indicateurs qui modifient la position actuelle peut être choisi.

Si le paramètre lpDx est NULL, la fonction ExtTextOut utilise l’espacement par défaut entre les caractères. Les origines des cellules caractères et le contenu du tableau pointés par le paramètre lpDx sont spécifiés en unités logiques. Une origine de cellule de caractère est définie comme l’angle supérieur gauche de la cellule de caractère.

Par défaut, la position actuelle n’est pas utilisée ou mise à jour par cette fonction. Toutefois, une application peut appeler la fonction SetTextAlign avec le paramètre fMode défini sur TA_UPDATECP pour permettre au système d’utiliser et de mettre à jour la position actuelle chaque fois que l’application appelle ExtTextOut pour un contexte d’appareil spécifié. Lorsque cet indicateur est défini, le système ignore les paramètres X et Y des appels ExtTextOut suivants.

Pour la version ANSI de ExtTextOut, le tableau lpDx a le même nombre de valeurs INT qu’il existe des octets dans lpString. Pour les caractères DBCS, vous pouvez répartir le dx dans le lpDx entrées entre l’octet du prospect et l’octet de fin, tant que la somme des deux octets s’ajoute au dx souhaité. Pour les caractères DBCS avec la version Unicode de ExtTextOut, chaque glyphe Unicode obtient une entrée de pdx unique.

Notez que les valeurs alpDx de GetTextExtentExPoint ne sont pas identiques aux valeurs lpDx pour ExtTextOut. Pour utiliser les valeurs alpDx dans lpDx, vous devez d’abord les traiter.

ExtTextOut utilise uniscribe si nécessaire, ce qui entraîne une secours de police. L’indicateur ETO_IGNORELANGUAGE empêche ce comportement et ne doit pas être passé.

En outre, ExtTextOut effectue un traitement par lots interne d’appels avant de passer en mode noyau, ce qui atténue certaines des préoccupations en matière de performances lors du pesage de l’utilisation de PolyTextOut par rapport à ExtTextOut.

Exemples

Pour obtenir un exemple, consultez « Définition de polices pour Menu-Item chaînes de texte » dans Utilisation de menus.

Exigences

Voir aussi

fonctions de police et de texte

Vue d’ensemble des polices et du texte

GetTextAlign

RECT

SelectObject

SetBkColor

SetTextAlign

SetTextColor