Fonction PolyTextOutA (wingdi.h)

Article
08/27/2023

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 PolyTextOutA(
  [in] HDC             hdc,
  [in] const POLYTEXTA *ppt,
  [in] int             nstrings
);

Paramètres

[in] hdc

Handle dans 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 lots interne d’appels avant de passer au 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 comme un 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.

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