Metodo IDWriteFactory6::CreateFontFaceReference (dwrite_3.h)

Crea un riferimento a un'istanza del tipo di carattere specifica all'interno di un file.

Sintassi

HRESULT CreateFontFaceReference(
        IDWriteFontFile              *fontFile,
        UINT32                       faceIndex,
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

Parametri

fontFile

Tipo: IDWriteFontFile*

File di tipo di carattere fornito dall'utente che rappresenta il viso del tipo di carattere.

faceIndex

Tipo: UINT32

Indice in base zero di un viso del tipo di carattere nei casi in cui il file di tipo di carattere contiene una raccolta di visi del tipo di carattere. Se il file di tipo di carattere contiene un singolo viso, impostare questo valore su zero.

fontSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Flag di simulazione del viso dei tipi di carattere per l'emboldening algoritmico e corsivo.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Puntatore a una matrice contenente un elenco di valori dell'asse dei caratteri. La matrice deve essere la dimensione (il numero di elementi) indicato dall'argomento fontAxisValueCount .

fontAxisValueCount

Tipo: UINT32

Numero di valori dell'asse dei caratteri contenuti nella matrice fontAxisValues.

[out] fontFaceReference

Tipo: IDWriteFontFaceReference1**

Indirizzo di un puntatore a un'interfaccia IDWriteFontFaceReference1. Al termine, la funzione imposta il puntatore su un oggetto di riferimento del viso del tipo di carattere appena creato; in caso contrario, imposta il puntatore su nullptr.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di erroreHRESULT .

Fabbisogno