Partager via


PolyTextOutW, fonction (wingdi.h)

La fonction PolyTextOut dessine plusieurs chaînes à l’aide des couleurs de police et de texte actuellement sélectionnées dans le contexte d’appareil spécifié.

Syntaxe

BOOL PolyTextOutW(
  [in] HDC             hdc,
  [in] const POLYTEXTW *ppt,
  [in] int             nstrings
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] ppt

Pointeur vers un tableau de structures POLYTEXT décrivant les chaînes à dessiner. Le tableau contient une structure pour chaque chaîne à dessiner.

[in] nstrings

Nombre de structures POLYTEXT dans le tableau pptxt .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

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

Remarques

Chaque structure POLYTEXT contient les coordonnées d’un point de référence que Windows utilise pour aligner la chaîne de texte correspondante. Une application peut spécifier la façon dont le point de référence est utilisé en appelant la fonction SetTextAlign . Une application peut déterminer le paramètre d’alignement du texte actuel pour le contexte d’appareil spécifié en appelant la fonction GetTextAlign .

Pour dessiner une seule chaîne de texte, l’application doit appeler la fonction ExtTextOut .

PolyTextOut ne gère pas automatiquement la prise en charge des scripts internationaux. Pour obtenir la prise en charge des scripts internationaux, utilisez à la place ExtTextOut . ExtTextOut utilise Uniscribe si nécessaire, ce qui entraîne une secours de police. En outre, ExtTextOut effectue un traitement par lot interne des appels avant la transition vers le mode noyau, ce qui atténue certains problèmes de performances lors de la pondération de l’utilisation de PolyTextOut par rapport à ExtTextOut.

Conseil

ExtTextOut est fortement recommandé par rapport à PolyTextOut pour le développement moderne en raison de sa capacité à gérer l’affichage de différents langages.

Notes

L’en-tête wingdi.h définit PolyTextOut en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

ExtTextOut

Fonctions de police et de texte

Vue d’ensemble des polices et du texte

GetTextAlign

POLYTEXT

SetTextAlign