Metodo IDWriteFontSetBuilder2::AddFont (dwrite_3.h)

Aggiunge un tipo di carattere al set in fase di compilazione, 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 di riferimento del file di tipo di carattere da aggiungere al set.

fontFaceIndex

Tipo: UINT32

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

fontSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Flag di simulazione viso 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) indicati 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 di assi.

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.

Commenti

Le proprietà del tipo di carattere devono includere almeno una famiglia (tipografico o spessore/stile/estensione). In caso contrario, il tipo di carattere sarebbe accessibile solo in IDWriteFontSet in base all'indice, non al nome.

Requisiti

Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Piattaforma di destinazione	Windows
Intestazione	dwrite_3.h
Libreria	Dwrite.lib