Método IDWriteFactory::CreateTextFormat (dwrite.h)

Artigo
08/23/2023

Cria um objeto de formato de texto usado para layout de texto.

Sintaxe

HRESULT CreateTextFormat(
  [in]  WCHAR const           *fontFamilyName,
        IDWriteFontCollection *fontCollection,
        DWRITE_FONT_WEIGHT    fontWeight,
        DWRITE_FONT_STYLE     fontStyle,
        DWRITE_FONT_STRETCH   fontStretch,
        FLOAT                 fontSize,
  [in]  WCHAR const           *localeName,
  [out] IDWriteTextFormat     **textFormat
);

Parâmetros

[in] fontFamilyName

Tipo: const WCHAR*

Uma matriz de caracteres que contém o nome da família de fontes

fontCollection

Tipo: IDWriteFontCollection*

Um ponteiro para um objeto de coleção de fontes. Quando isso é NULL, indica a coleção de fontes do sistema.

fontWeight

Tipo: DWRITE_FONT_WEIGHT

Um valor que indica o peso da fonte para o objeto de texto criado por esse método.

fontStyle

Tipo: DWRITE_FONT_STYLE

Um valor que indica o estilo da fonte para o objeto de texto criado por esse método.

fontStretch

Tipo: DWRITE_FONT_STRETCH

Um valor que indica o alongamento de fonte para o objeto de texto criado por esse método.

fontSize

Tipo: FLOAT

O tamanho lógico da fonte em unidades DIP ("pixel independente do dispositivo"). Um DIP é igual a 1/96 polegada.

[in] localeName

Tipo: const WCHAR*

Uma matriz de caracteres que contém o nome da localidade.

[out] textFormat

Tipo: IDWriteTextFormat**

Quando esse método retorna, contém um endereço de um ponteiro para um objeto de formato de texto recém-criado ou NULL em caso de falha.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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 Atualização de Plataforma 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

IDWriteFactory

Compartilhar via