Compartilhar via

Método IDWriteTextFormat::SetTextAlignment (dwrite.h)

  • Artigo

Define o alinhamento do texto em um parágrafo, em relação à borda à esquerda e à direita de uma caixa de layout para uma interface IDWriteTextFormat .

Sintaxe

HRESULT SetTextAlignment(
  DWRITE_TEXT_ALIGNMENT textAlignment
);

Parâmetros

textAlignment

Tipo: DWRITE_TEXT_ALIGNMENT

A opção de alinhamento de texto que está sendo definida para o parágrafo do tipo DWRITE_TEXT_ALIGNMENT. Para obter mais informações, consulte Comentários.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 O argumento textAlignment é inválido.

Comentários

O texto pode ser alinhado à borda à esquerda ou à direita da caixa de layout ou pode ser centralizado. A ilustração a seguir mostra o texto com o alinhamento definido como DWRITE_TEXT_ALIGNMENT_LEADING, DWRITE_TEXT_ALIGNMENT_CENTER e DWRITE_TEXT_ALIGNMENT_TRAILING, respectivamente.

Ilustração de parágrafos de texto com alinhamento à esquerda, centralizado e à direita
Nota O alinhamento depende da direção da leitura, o acima é para a direção de leitura da esquerda para a direita. Para a direção da leitura da direita para a esquerda, seria o oposto.
 
Consulte DWRITE_TEXT_ALIGNMENT para obter mais informações.

Exemplos

if (SUCCEEDED(hr))
{
    hr = pTextFormat_->SetTextAlignment(DWRITE_TEXT_ALIGNMENT_CENTER);
}

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteTextFormat