Condividi tramite


Funzione GetTextAlign (wingdi.h)

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:

  1. Applicare l'operatore OR bit per bit al flag e ai relativi flag correlati.
  2. Applicare l'operatore AND bit per bit al risultato e al valore restituito.
  3. 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

Vedi anche

Exttextout

Funzioni per tipi di carattere e testo

Cenni preliminari su tipi di carattere e testo

GetTextExtentPoint32

SetTextAlign

TextOut