Metodo IDWriteFontSetBuilder2::AddFont (dwrite_3.h)

Aggiunge un tipo di carattere al set da compilare, con il chiamante che fornisce informazioni sufficienti per cercare e determinare gli intervalli di assi, evitando la necessità di aprire il tipo di carattere potenzialmente non locale.

Sintassi

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Parametri

fontFile

Tipo: IDWriteFontFile*

Oggetto riferimento file di tipo carattere da aggiungere al set.

fontFaceIndex

Tipo: UINT32

Indice in base zero di un viso del tipo di carattere in una raccolta.

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.

fontAxisRanges

Tipo: DWRITE_FONT_AXIS_RANGE const *

Elenco di intervalli di assi.

fontAxisRangeCount

Tipo: UINT32

Numero di intervalli dell'asse.

properties

Tipo: DWRITE_FONT_PROPERTY const *

Elenco di proprietà da associare al riferimento.

propertyCount

Tipo: UINT32

Numero di proprietà definite.

Valore restituito

Tipo: HRESULT

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

Osservazioni

Le proprietà del tipo di carattere devono includere almeno una famiglia (tipografico o peso/stile/estensione). In caso contrario, il tipo di carattere sarà accessibile nel IDWriteFontSet solo per indice, non per nome.

Fabbisogno