IDWriteFactory3::CreateFontFaceReference(WCHARconst*,FILETIMEconst*,UINT32,DWRITE_FONT_SIMULATIONS,IDWriteFontFaceReference**) (dwrite_3.h)

Crea una referencia a una fuente dada una ruta de acceso completa.

Sintaxis

HRESULT CreateFontFaceReference(
  WCHAR const              *filePath,
  FILETIME const           *lastWriteTime,
  UINT32                   faceIndex,
  DWRITE_FONT_SIMULATIONS  fontSimulations,
  IDWriteFontFaceReference **fontFaceReference
);

Parámetros

filePath

Tipo: [in] WCHAR

Ruta de acceso absoluta al archivo. Las operaciones posteriores en el objeto construido pueden producir un error si el filePath proporcionado por el usuario no corresponde a un archivo válido en el disco.

lastWriteTime

Tipo: [in, opcional] FILETIME

Hora de la última modificación de la ruta de acceso del archivo de entrada. Si se omite el parámetro ,
la función tendrá acceso al archivo de fuente para obtener su última hora de escritura, por lo que se recomienda a los clientes especificar este valor.
para evitar el acceso adicional al disco. Se puede producir un error en las operaciones posteriores en el objeto construido
si el usuario proporcionó lastWriteTime no coincide con el archivo en el disco.

faceIndex

Tipo: UINT32

Índice de base cero de una cara de fuente en casos en los que los archivos de fuente contienen una colección de caras de fuente.
Si los archivos de fuente contienen una sola cara, este valor debe ser cero.

fontSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Marcas de simulación de caras de fuente para la embolia algorítmica y cursiva.

fontFaceReference

Tipo: [out] IDWriteFontFaceReference**

Contiene el objeto de referencia de la cara de fuente recién creado o nullptr en caso de error.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dwrite_3.h
Library	Dwrite.lib
Archivo DLL	Dwrite.dll

Consulte también

IDWriteFactory3