Structure POLYTEXTA (wingdi.h)

Article
11/20/2024

La structure POLYTEXT décrit comment la fonction PolyTextOut doit dessiner une chaîne de texte.

Syntaxe

typedef struct tagPOLYTEXTA {
  int    x;
  int    y;
  UINT   n;
  LPCSTR lpstr;
  UINT   uiFlags;
  RECT   rcl;
  int    *pdx;
} POLYTEXTA, *PPOLYTEXTA, *NPPOLYTEXTA, *LPPOLYTEXTA;

Membres

x

Point de référence horizontal de la chaîne. La chaîne est alignée sur ce point à l’aide du mode d’alignement de texte actuel.

y

Point de référence vertical de la chaîne. La chaîne est alignée sur ce point à l’aide du mode d’alignement de texte actuel.

n

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

lpstr

Pointeur vers une chaîne de texte à dessiner par la fonction PolyTextOut. Cette chaîne n’a pas besoin d’être terminée par null, car n spécifie la longueur de la chaîne.

uiFlags

Spécifie si la chaîne doit être opaque ou clippée et si la chaîne est accompagnée d’un tableau de valeurs de largeur de caractères. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
ETO_OPAQUE	Le rectangle de chaque chaîne doit être opaque avec la couleur d’arrière-plan actuelle.
ETO_CLIPPED	Chaque chaîne doit être clippée dans son rectangle spécifié.

rcl

Structure de rectangle qui contient les dimensions du rectangle d’opaquing ou de découpage. Ce membre n’est ignoré si aucun des ETO_OPAQUE ni la valeur de ETO_CLIPPED n’est spécifiée pour le membre uiFlags.

pdx

Pointeur vers un tableau contenant la valeur de largeur pour chaque caractère de la chaîne.

Remarques

Note

L’en-tête wingdi.h définit POLYTEXT comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	wingdi.h (include Windows.h)

Voir aussi

structures de police et de texte

Vue d’ensemble des polices et du texte

PolyTextOut

Partager via