Fonction PolyTextOutA (wingdi.h)

Article
11/20/2024

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 vers 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 de retour

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 de 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 comment le point de référence est utilisé en appelant la fonction SetTextAlign. Une application peut déterminer le paramètre d’alignement de 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 ExtTextOut à la place. 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 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.

Pourboire

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

Note

L’en-tête wingdi.h définit PolyTextOut 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]
plateforme cible	Windows
d’en-tête	wingdi.h (include Windows.h)
bibliothèque	Gdi32.lib
DLL	Gdi32.dll