Interface IDWriteTextFormat (dwrite.h)

A interface IDWriteTextFormat descreve as propriedades de fonte e parágrafo usadas para formatar texto e descreve informações de localidade.

Herança

A interface IDWriteTextFormat herda da interface IUnknown . IDWriteTextFormat também tem estes tipos de membros:

Métodos

A interface IDWriteTextFormat tem esses métodos.

IDWriteTextFormat::GetFlowDirection Obtém a direção em que as linhas de texto fluem.
IDWriteTextFormat::GetFontCollection Obtém a coleção de fontes atual.
IDWriteTextFormat::GetFontFamilyName Obtém uma cópia do nome da família de fontes.
IDWriteTextFormat::GetFontFamilyNameLength Obtém o comprimento do nome da família de fontes.
IDWriteTextFormat::GetFontSize Obtém o tamanho da fonte em uniões DIP.
IDWriteTextFormat::GetFontStretch Obtém o trecho de fonte do texto.
IDWriteTextFormat::GetFontStyle Obtém o estilo da fonte do texto.
IDWriteTextFormat::GetFontWeight Obtém o peso da fonte do texto.
IDWriteTextFormat::GetIncrementalTabStop Obtém a posição de parada de tabulação incremental.
IDWriteTextFormat::GetLineSpacing Obtém o ajuste de espaçamento entre linhas definido para um parágrafo de texto de várias linhas. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName Obtém uma cópia do nome da localidade.
IDWriteTextFormat::GetLocaleNameLength Obtém o comprimento do nome da localidade.
IDWriteTextFormat::GetParagraphAlignment Obtém a opção de alinhamento de um parágrafo relativo às bordas superior e inferior de uma caixa de layout.
IDWriteTextFormat::GetReadingDirection Obtém a direção de leitura atual do texto em um parágrafo.
IDWriteTextFormat::GetTextAlignment Obtém a opção de alinhamento do texto em relação à borda à esquerda e à direita da caixa de layout.
IDWriteTextFormat::GetTrimming Obtém as opções de corte do texto que estoura a caixa de layout.
IDWriteTextFormat::GetWordWrapping Obtém a opção de disposição da palavra.
IDWriteTextFormat::SetFlowDirection Define a direção do fluxo do parágrafo.
IDWriteTextFormat::SetIncrementalTabStop Define uma distância fixa entre duas paradas de tabulação adjacentes.
IDWriteTextFormat::SetLineSpacing Define o espaçamento entre linhas.
IDWriteTextFormat::SetParagraphAlignment Define a opção de alinhamento de um parágrafo em relação à borda superior e inferior da caixa de layout.
IDWriteTextFormat::SetReadingDirection Define a direção de leitura do parágrafo.
IDWriteTextFormat::SetTextAlignment 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.
IDWriteTextFormat::SetTrimming Define opções de corte para texto que estoura a largura do layout.
IDWriteTextFormat::SetWordWrapping Define a opção de disposição da palavra.

Comentários

Para obter uma referência à interface IDWriteTextFormat , o aplicativo deve chamar o método IDWriteFactory::CreateTextFormat , conforme mostrado no código a seguir.

if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}

Ao criar um objeto IDWriteTextFormat usando a função CreateTextFormat , o aplicativo especifica a família de fontes, a coleção de fontes, o peso da fonte, o tamanho da fonte e o nome da localidade para o formato de texto.

Essas propriedades não podem ser alteradas depois que o objeto IDWriteTextFormat é criado. Para alterar essas propriedades, um novo objeto IDWriteTextFormat deve ser criado com as propriedades desejadas.

A interface IDWriteTextFormat é usada para desenhar texto com um único formato

Para desenhar texto com vários formatos ou usar um renderizador de texto personalizado, use a interface IDWriteTextLayout . IDWriteTextLayout permite que o aplicativo altere o formato para intervalos de texto dentro da cadeia de caracteres. O IDWriteFactory::CreateTextLayout usa um objeto IDWriteTextFormat como um parâmetro e inicialmente aplica as informações de formato a toda a cadeia de caracteres.

Esse objeto pode não ser thread-safe e pode conter o estado da alteração de formato de texto.

DirectWrite e Direct2D

Para desenhar texto simples com um único formato, o Direct2D fornece o método ID2D1RenderTarget::D rawText , que desenha uma cadeia de caracteres usando as informações de formato fornecidas por um objeto IDWriteTextFormat .

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