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
- 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 |