Metodo IDWriteFontSet1::GetMatchingFonts (dwrite_3.h)

Recupera un set di tipi di carattere corrispondente in base agli input richiesti, ordinato in modo che le corrispondenze più vicine siano precedenti.

Sintassi

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

Parametri

fontProperty

Tipo: DWRITE_FONT_PROPERTY const *

Proprietà font di interesse, ad esempio famiglia tipografica o famiglia peso/estensione/stile.

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.

matchingFonts

Tipo: IDWriteFontSet1**

Indirizzo di un puntatore a un'interfaccia IDWriteFontSet1. Al termine, la funzione imposta il puntatore su un elenco di tipi di carattere con priorità corrispondenti alle proprietà; 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 .

Osservazioni

Questo metodo può restituire elementi distinti non inclusi nel set di tipi di carattere originale, inclusi gli elementi con flag di simulazione (se si tratta di una corrispondenza più vicina alla richiesta) e le istanze non denominate dall'autore del tipo di carattere. Gli elementi delle stesse risorse del tipo di carattere vengono compressi in uno: la corrispondenza più vicina possibile.

Fabbisogno