Método IDWriteFactory6::CreateTextFormat (dwrite_3.h)

Artigo
11/20/2024

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

Sintaxe

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

Parâmetros

fontFamilyName

Tipo: WCHAR const *

Nome da família de fontes da coleção.

fontCollection

Tipo: * IDWriteFontCollection

Coleção de fontes. Use nullptr para indicar a coleção de fontes do sistema.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Um ponteiro para uma matriz que contém uma lista de valores de eixo de fonte. A matriz deve ser o tamanho (o número de elementos) indicado pelo argumento fontAxisValueCount.

fontAxisValueCount

Tipo: UINT32

O número de valores de eixo de fonte contidos na matriz de fontAxisValues.

fontSize

Tipo: float

Tamanho lógico da fonte em unidades DIP.

localeName

Tipo: WCHAR const *

Nome da localidade (por exemplo, "ja-JP", "en-US", "ar-EG").

textFormat

Tipo: ** IDWriteTextFormat3

O endereço de um ponteiro para uma interface IDWriteTextFormat3 . Após a conclusão bem-sucedida, a função define o ponteiro para um objeto de formato de texto recém-criado, caso contrário, define o ponteiro como nullptr.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um de código de erro HRESULT.

Observações

Se fontCollection for nullptr, a coleção de fontes do sistema será usada, agrupada pelo nome da família tipográfica (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) sem fontes para download.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 Build 16299
servidor com suporte mínimo	Windows 10 Build 16299
da Plataforma de Destino	Windows
cabeçalho	dwrite_3.h
biblioteca	Dwrite.lib

Compartilhar via