Compartir a través de

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

  • Artículo

Crea un objeto de formato de texto utilizado para el diseño de texto.

Sintaxis

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 *

Nombre de la familia de fuentes de la colección.

fontCollection

Tipo: IDWriteFontCollection*

Colección de fuentes. Use nullptr para indicar la colección de fuentes del sistema.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Puntero a una matriz que contiene una lista de valores de eje de fuentes. La matriz debe ser el tamaño (el número de elementos) indicado por el argumento fontAxisValueCount .

fontAxisValueCount

Tipo: UINT32

Número de valores de eje de fuentes contenidos en la matriz fontAxisValues .

fontSize

Tipo: FLOAT

Tamaño lógico de la fuente en unidades DIP.

localeName

Tipo: WCHAR const *

Nombre de configuración regional (por ejemplo, "ja-JP", "en-US", "ar-EG").

textFormat

Tipo: IDWriteTextFormat3**

Dirección de un puntero a una interfaz IDWriteTextFormat3 . Al finalizar correctamente, la función establece el puntero en un objeto de formato de texto recién creado; de lo contrario, establece el puntero en nullptr.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de errorHRESULT.

Comentarios

Si fontCollection es nullptr, se usa la colección de fuentes del sistema, agrupada por nombre de familia tipográfico (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) sin fuentes descargables.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Servidor mínimo compatible compilación 20348 de Windows 10
Plataforma de destino Windows
Encabezado dwrite_3.h
Library Dwrite.lib