SetTextAlign

9/8/2008

Essa função define o texto-valor alinhamento para o contexto dispositivo especificado.

Syntax

WINGDIAPI UINT WINAPI SetTextAlign(
  HDC hdc,
  UINT fmode
);

Parameters

• hDC
  [no] Identificador para o contexto dispositivo.

• fmode
  [no] Inteiro sem sinal que especifica o alinhamento de texto, usando uma máscara dos valores. A seguinte tabela mostra os valores possíveis. Você pode combinar somente um dos valores que afeta horizontal e com apenas um dos valores que afeta alinhamento vertical. Além disso, você pode combinar o horizontal e vertical valores com somente um dos dois sinalizadores que alterar o atual posição. Os valores usar como padrão são TA_LEFT, TA_TOP e TA_NOUPDATECP.

  Valor	Descrição
  TA_BASELINE	O apontar de referência consta o linha de base do texto.
  TA_BOTTOM	O apontar de referência está na borda inferior da retângulo delimitador.
  TA_CENTER	Apontar a referência é alinhada horizontalmente com a centralizar da retângulo delimitador.
  TA_LEFT	Apontar a referência está na borda esquerda do retângulo delimitador.
  TA_NOUPDATECP	O atual posição não é atualizada após cada chamar saída de texto.
  TA_RIGHT	O apontar de referência consta o direito Borda da retângulo delimitador.
  TA_RTLREADING	O texto é apresentado na ordem de leitura right-to-Left, as opposed to usar como padrão ESQUERDA - para - direito ordem. Isso se aplica somente quando a fonte selecionada no contexto de dispositivo é hebraico ou árabe.
  TA_TOP	O apontar de referência consta o parte superior Borda da retângulo delimitador.
  TA_UPDATECP	O atual posição é atualizada após cada chamar saída de texto.

Return Value

O texto anterior-alinhamento configuração indica sucesso. GDI_ERROR indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

A função ExtTextOut usa o texto-valor alinhamento a posição de seqüência de caracteres de texto em um exibir ou outro dispositivo. Especificar os valores o relacionamento entre uma apontar de referência e um retângulo que circunda o texto. Apontar a referência é ambos o atual posição ou um apontar que transmitir para ExtTextOut. O retângulo que circunda o texto é formado pelas células caractere no seqüência de caracteres texto.

O seguinte exemplo de código mostra os dois métodos melhores para especificando texto alinhado à esquerda.

SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))
SetTextAlign (hdc, TA_LEFT | <other flags>)

O seguinte exemplo de código mostra um método para especificar texto left-aligned que não é recomendado porque esse método perde qualquer vertical configurações que você especificou anteriormente.

SetTextAlign (hdc, TA_LEFT)

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

ExtTextOut
GetTextAlign