Compartilhar via


Função GetTextAlign (wingdi.h)

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:

  1. Aplique o operador OR bit a bit ao sinalizador e seus sinalizadores relacionados.
  2. Aplique o operador AND bit a bit ao resultado e ao valor retornado.
  3. 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

Confira também

Exttextout

Funções de fonte e texto

Visão geral de fontes e texto

Gettextextentpoint32

Settextalign

Textout