Funzione SetTextAlign (wingdi.h)

Articolo
08/27/2023

La funzione SetTextAlign imposta i flag di allineamento del testo per il contesto del dispositivo specificato.

Sintassi

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] align

Allineamento del testo usando una maschera dei valori nell'elenco seguente. È possibile scegliere un solo flag da quelli che influiscono sull'allineamento orizzontale e verticale. Inoltre, è possibile scegliere solo uno dei due flag che modificano la posizione corrente.

Valore	Significato
TA_BASELINE	Il punto di riferimento sarà sulla riga di base del testo.
TA_BOTTOM	Il punto di riferimento sarà sul bordo inferiore del rettangolo di selezione.
TA_TOP	Il punto di riferimento sarà sul bordo superiore del rettangolo di selezione.
TA_CENTER	Il punto di riferimento verrà allineato orizzontalmente al centro del rettangolo di selezione.
TA_LEFT	Il punto di riferimento sarà sul bordo sinistro del rettangolo di selezione.
TA_RIGHT	Il punto di riferimento sarà sul bordo destro del rettangolo di selezione.
TA_NOUPDATECP	La posizione corrente non viene aggiornata dopo ogni chiamata di output di testo. Il punto di riferimento viene passato alla funzione di output del testo.
TA_RTLREADING	Edizione del linguaggio Middle East di Windows: Il testo viene disposto a destra per sinistra, anziché all'ordine di lettura predefinito a destra. Ciò si applica solo quando il tipo di carattere selezionato nel contesto del dispositivo è ebraico o arabo.
TA_UPDATECP	La posizione corrente viene aggiornata dopo ogni chiamata di output del testo. La posizione corrente viene usata come punto di riferimento.

Quando il carattere corrente ha una riga di base predefinita verticale, come con Kanji, i valori seguenti devono essere usati anziché TA_BASELINE e TA_CENTER.

Valore	Significato
VTA_BASELINE	Il punto di riferimento sarà sulla riga di base del testo.
VTA_CENTER	Il punto di riferimento verrà allineato verticalmente con il centro del rettangolo di selezione.

I valori predefiniti sono TA_LEFT, TA_TOP e TA_NOUPDATECP.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'impostazione precedente di allineamento del testo.

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

Commenti

Le funzioni TextOut e ExtTextOut usano i flag di allineamento del testo per posizionare una stringa di testo in una visualizzazione o in un altro dispositivo. I flag specificano la relazione tra un punto di riferimento e un rettangolo che delimita il testo. Il punto di riferimento è la posizione corrente o un punto passato a una funzione di output di testo.

Il rettangolo che delimita il testo è formato dalle celle dei caratteri nella stringa di testo.

Il modo migliore per ottenere testo allineato a sinistra consiste nell'usare entrambi


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

oppure


SetTextAlign (hdc,TA_LEFT | <other flags>)

È anche possibile usare SetTextAlign (hdc, TA_LEFT) per questo scopo, ma ciò perde qualsiasi impostazione verticale o da destra a sinistra.

Nota Non è consigliabile usare SetTextAlign con TA_UPDATECP quando si usa ScriptStringOut, perché il testo selezionato non viene eseguito correttamente. Se è necessario usare questo flag, è possibile annullare e reimpostarlo in base alle esigenze per evitare il problema.

Esempio

Per un esempio, vedere Impostazione dell'allineamento del testo.

Requisiti


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