Funzione PolyTextOutA (wingdi.h)

Articolo
03/13/2024

La funzione PolyTextOut disegna diverse stringhe utilizzando i colori del tipo di carattere e del testo attualmente selezionati nel contesto di dispositivo specificato.

Sintassi

BOOL PolyTextOutA(
  [in] HDC             hdc,
  [in] const POLYTEXTA *ppt,
  [in] int             nstrings
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] ppt

Puntatore a una matrice di strutture POLYTEXT che descrivono le stringhe da disegnare. La matrice contiene una struttura per ogni stringa da disegnare.

[in] nstrings

Numero di strutture POLYTEXT nella matrice pptxt .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Ogni struttura POLYTEXT contiene le coordinate di un punto di riferimento utilizzato da Windows per allineare la stringa di testo corrispondente. Un'applicazione può specificare come viene usato il punto di riferimento chiamando la funzione SetTextAlign . Un'applicazione può determinare l'impostazione di allineamento del testo corrente per il contesto di dispositivo specificato chiamando la funzione GetTextAlign .

Per disegnare una singola stringa di testo, l'applicazione deve chiamare la funzione ExtTextOut .

PolyTextOut non gestirà automaticamente il supporto di scripting internazionale. Per ottenere il supporto di scripting internazionale, usare extTextOut . ExtTextOut userà Uniscribe quando necessario, con conseguente fallback del tipo di carattere. ExtTextOut eseguirà inoltre l'invio in batch interno delle chiamate prima della transizione alla modalità kernel, riducendo alcuni dei problemi di prestazioni quando si pesa l'utilizzo di PolyTextOut rispetto a ExtTextOut.

Suggerimento

ExtTextOut è fortemente consigliato su PolyTextOut per lo sviluppo moderno grazie alla capacità di gestire la visualizzazione di linguaggi diversi.

Nota

L'intestazione wingdi.h definisce PolyTextOut come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll