Funzione GetTextAlign (wingdi.h)

Articolo
08/27/2023

La funzione GetTextAlign recupera l'impostazione di allineamento del testo per il contesto di dispositivo specificato.

Sintassi

UINT GetTextAlign(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito corrisponde allo stato dei flag di allineamento del testo. Per altre informazioni sul valore restituito, vedere la sezione Osservazioni. Il valore restituito è una combinazione dei valori seguenti.

Valore	Significato
TA_BASELINE	Il punto di riferimento si trova sulla riga di base del testo.
TA_BOTTOM	Il punto di riferimento si trova sul bordo inferiore del rettangolo di delimitazione.
TA_TOP	Il punto di riferimento si trova sul bordo superiore del rettangolo di delimitazione.
TA_CENTER	Il punto di riferimento è allineato orizzontalmente al centro del rettangolo di delimitazione.
TA_LEFT	Il punto di riferimento si trova sul bordo sinistro del rettangolo di delimitazione.
TA_RIGHT	Il punto di riferimento si trova sul bordo destro del rettangolo di delimitazione.
TA_RTLREADING	Edizione del linguaggio Medio Oriente di Windows: Il testo viene disposto in ordine di lettura da destra a sinistra, anziché dall'ordine predefinito da sinistra a destra. Questo vale solo quando il tipo di carattere selezionato nel contesto del dispositivo è ebraico o arabo.
TA_NOUPDATECP	La posizione corrente non viene aggiornata dopo ogni chiamata di output di testo.
TA_UPDATECP	La posizione corrente viene aggiornata dopo ogni chiamata di output di testo.

Quando il tipo di carattere corrente ha una linea di base predefinita verticale (come con Kanji), vengono usati i valori seguenti anziché TA_BASELINE e TA_CENTER.

Valore	Significato
VTA_BASELINE	Il punto di riferimento si trova sulla riga di base del testo.
VTA_CENTER	Il punto di riferimento è allineato verticalmente al centro del rettangolo di delimitazione.

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

Commenti

Il rettangolo di delimitazione è un rettangolo che delimita tutte le celle di caratteri in una stringa di testo. Le dimensioni possono essere ottenute chiamando la funzione GetTextExtentPoint32 .

I flag di allineamento del testo determinano il modo in cui le funzioni TextOut e ExtTextOut allineano una stringa di testo in relazione al punto di riferimento della stringa fornito a TextOut o ExtTextOut.

I flag di allineamento del testo non sono necessariamente flag a bit singolo e possono essere uguali a zero. I flag devono essere esaminati in gruppi di flag correlati, come illustrato nell'elenco seguente.

TA_LEFT, TA_RIGHT e TA_CENTER
TA_BOTTOM, TA_TOP e TA_BASELINE
TA_NOUPDATECP e TA_UPDATECP

Se il tipo di carattere corrente ha una linea di base predefinita verticale, i flag correlati sono indicati nell'elenco seguente.

TA_LEFT, TA_RIGHT e VTA_BASELINE
TA_BOTTOM, TA_TOP e VTA_CENTER
TA_NOUPDATECP e TA_UPDATECP

Per verificare che un flag specifico sia impostato nel valore restituito di questa funzione:

Applicare l'operatore OR bit per bit al flag e ai relativi flag correlati.
Applicare l'operatore AND bit per bit al risultato e al valore restituito.
Verificare l'uguaglianza di questo risultato e il flag.

Esempio

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

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