Fonction PolyTextOutA (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 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 |