Função GetTextAlign (wingdi.h)

Artigo
03/13/2024

A função GetTextAlign recupera a configuração de alinhamento de texto para o contexto do dispositivo especificado.

Sintaxe

UINT GetTextAlign(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o status dos sinalizadores de alinhamento de texto. Para obter mais informações sobre o valor retornado, consulte a seção Comentários. O valor retornado é uma combinação dos valores a seguir.

Valor	Significado
TA_BASELINE	O ponto de referência está na linha base do texto.
TA_BOTTOM	O ponto de referência está na borda inferior do retângulo delimitador.
TA_TOP	O ponto de referência está na borda superior do retângulo delimitador.
TA_CENTER	O ponto de referência é alinhado horizontalmente com o centro do retângulo delimitador.
TA_LEFT	O ponto de referência está na borda esquerda do retângulo delimitador.
TA_RIGHT	O ponto de referência está na borda direita do retângulo delimitador.
TA_RTLREADING	Edição de idioma do Oriente Médio do Windows: O texto é disposto na ordem de leitura da direita para a esquerda, em oposição à ordem padrão da esquerda para a direita. Isso só se aplica quando a fonte selecionada no contexto do dispositivo é hebraica ou árabe.
TA_NOUPDATECP	A posição atual não é atualizada após cada chamada de saída de texto.
TA_UPDATECP	A posição atual é atualizada após cada chamada de saída de texto.

Quando a fonte atual tem uma linha base padrão vertical (como com Kanji), os valores a seguir são usados em vez de TA_BASELINE e TA_CENTER.

Valor	Significado
VTA_BASELINE	O ponto de referência está na linha base do texto.
VTA_CENTER	O ponto de referência é alinhado verticalmente com o centro do retângulo delimitador.

Se a função falhar, o valor retornado será GDI_ERROR.

Comentários

O retângulo delimitador é um retângulo que limita todas as células de caracteres em uma cadeia de caracteres de texto. Suas dimensões podem ser obtidas chamando a função GetTextExtentPoint32 .

Os sinalizadores de alinhamento de texto determinam como as funções TextOut e ExtTextOut alinham uma cadeia de caracteres de texto em relação ao ponto de referência da cadeia de caracteres fornecido a TextOut ou ExtTextOut.

Os sinalizadores de alinhamento de texto não são necessariamente sinalizadores de bit único e podem ser iguais a zero. Os sinalizadores devem ser examinados em grupos de sinalizadores relacionados, conforme mostrado na lista a seguir.

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

Se a fonte atual tiver uma linha base padrão vertical, os sinalizadores relacionados serão mostrados na lista a seguir.

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

Para verificar se um sinalizador específico está definido no valor retornado dessa função:

Aplique o operador OR bit a bit ao sinalizador e seus sinalizadores relacionados.
Aplique o operador AND bit a bit ao resultado e ao valor retornado.
Teste a igualdade desse resultado e o sinalizador.

Exemplos

Para obter um exemplo, consulte Configurando o alinhamento de texto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll