Função SetTextAlign (wingdi.h)

Artigo
08/27/2023

A função SetTextAlign define os sinalizadores de alinhamento de texto para o contexto do dispositivo especificado.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] align

O alinhamento de texto usando uma máscara dos valores na lista a seguir. Somente um sinalizador pode ser escolhido daqueles que afetam o alinhamento horizontal e vertical. Além disso, apenas um dos dois sinalizadores que alteram a posição atual pode ser escolhido.

Valor	Significado
TA_BASELINE	O ponto de referência estará na linha base do texto.
TA_BOTTOM	O ponto de referência estará na borda inferior do retângulo delimitador.
TA_TOP	O ponto de referência estará na borda superior do retângulo delimitador.
TA_CENTER	O ponto de referência será alinhado horizontalmente com o centro do retângulo delimitador.
TA_LEFT	O ponto de referência estará na borda esquerda do retângulo delimitador.
TA_RIGHT	O ponto de referência estará na borda direita do retângulo delimitador.
TA_NOUPDATECP	A posição atual não é atualizada após cada chamada de saída de texto. O ponto de referência é passado para a função de saída de texto.
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 se aplica somente quando a fonte selecionada no contexto do dispositivo é hebraica ou árabe.
TA_UPDATECP	A posição atual é atualizada após cada chamada de saída de texto. A posição atual é usada como o ponto de referência.

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

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

Os valores padrão são TA_LEFT, TA_TOP e TA_NOUPDATECP.

Valor retornado

Se a função for bem-sucedida, o valor retornado será a configuração de alinhamento de texto anterior.

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

Comentários

As funções TextOut e ExtTextOut usam os sinalizadores de alinhamento de texto para posicionar uma cadeia de caracteres de texto em uma tela ou em outro dispositivo. Os sinalizadores especificam a relação entre um ponto de referência e um retângulo que vincula o texto. O ponto de referência é a posição atual ou um ponto passado para uma função de saída de texto.

O retângulo que vincula o texto é formado pelas células de caractere na cadeia de caracteres de texto.

A melhor maneira de obter um texto alinhado à esquerda é usar qualquer um


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


SetTextAlign (hdc,TA_LEFT | <other flags>)

Você também pode usar SetTextAlign (hdc, TA_LEFT) para essa finalidade, mas isso perde todas as configurações verticais ou da direita para a esquerda.

Nota Você não deve usar SetTextAlign com TA_UPDATECP quando estiver usando ScriptStringOut, pois o texto selecionado não é renderizado corretamente. Se você precisar usar esse sinalizador, poderá desajustá-lo e redefini-lo conforme necessário para evitar o problema.

Exemplos

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

Requisitos


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