CDC::SetTextAlign

Artigo
06/10/2015

Defina os sinalizadores do texto - alinhamento.

UINT SetTextAlign( 
   UINT nFlags  
);

Parâmetros

nFlags
Especifica o texto - sinalizadores de alinhamento. Os sinalizadores especificam o relacionamento entre um ponto e um retângulo que limitam o texto. O ponto pode ser ou a posição atual ou as coordenadas específicas por uma o texto - saída funcionam. O retângulo que limita o texto é definido pelas células adjacentes de caracteres na cadeia de caracteres. O parâmetro de nFlags pode ser um ou vários sinalizadores das três categorias. Escolha somente um sinalizador de cada categoria. A primeira categoria afeta o alinhamento de texto na direção x:
- O pontoTA_CENTER alinha com o centro horizontal do retângulo delimitador.
- O pontoTA_LEFT alinha com o lado esquerdo do retângulo delimitador. Isso é a configuração padrão.
- O pontoTA_RIGHT alinha com o lado direito do retângulo delimitador.
A segunda categoria afeta o alinhamento de texto na direção y:
- O pontoTA_BASELINE alinha com a linha de base de fonte escolhida.
- O pontoTA_BOTTOM alinha com a parte inferior do retângulo delimitador.
- O pontoTA_TOP alinha com a parte superior do retângulo delimitador. Isso é a configuração padrão.
A terceira categoria determina se a posição atual é atualizado quando o texto escrito:
- TA_NOUPDATECP não atualiza a posição atual após cada chamada à função do texto - saída. Isso é a configuração padrão.
- XTA_UPDATECP atualiza a posição atual após cada chamada à função do texto - saída. A nova posição está no lado direito do retângulo delimitador do texto. Quando esse sinalizador é definido, as coordenadas especificado em chamadas para a função de membro de TextOut são ignoradas.

Valor de retorno

A configuração anterior do texto - alinhamento, se com êxito. O byte de ordem baixa contém a configuração horizontal e o byte de alta-ordem contém a configuração vertical; se não 0.

Comentários

As funções de membro de TextOut e de ExtTextOut usam esses sinalizadores para posicionar uma cadeia de caracteres de texto em uma exibição ou em um dispositivo. Os sinalizadores especificam o relacionamento entre um ponto específico e um retângulo que limitam o texto. As coordenadas de este ponto são passadas como parâmetros para a função de membro de TextOut . O retângulo que limita o texto é formado pelas células adjacentes de caracteres na cadeia de caracteres.