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

Crea un objeto de formato de texto usado 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 de

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 de 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 ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Observaciones

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	Valor
cliente mínimo admitido	Compilación 16299 de Windows 10
servidor mínimo admitido	Compilación 16299 de Windows 10
de la plataforma de destino de	Windows
encabezado de	dwrite_3.h
biblioteca de	Dwrite.lib