Metodo IDWriteFontSet4::GetMatchingFonts (dwrite_3.h)

Articolo
07/16/2024

Genera 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(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

Parametri

familyName

Tipo: _In_z_ WCHAR const*

Nome della famiglia di caratteri. Può trattarsi di un nome di famiglia tipografico, di un nome di famiglia di spessore/stretch/stile, di un nome di famiglia GDI (RBIZ) o di un nome completo.

fontAxisValues

Tipo: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Matrice di valori dell'asse dei caratteri.

fontAxisValueCount

Tipo: UINT32

Numero di valori dell'asse dei caratteri.

allowedSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Specifica quali simulazioni (ovvero, l'emboldening algoritmico e/o l'inclinazione) possono essere applicate ai tipi di carattere corrispondenti per trovare una corrispondenza migliore con i valori dell'asse specificati. Se l'argomento è DWRITE_FONT_SIMULATIONS_NONE (0), non vengono applicate simulazioni.

matchingFonts

Tipo: _COM_Outptr_ IDWriteFontSet4**

Riceve un puntatore a un set di caratteri appena creato, che contiene un elenco di tipi di carattere con priorità corrispondenti agli input specificati.

Valore restituito

Tipo: HRESULT

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

Osservazioni

Ciò può produrre elementi distinti non inclusi nel set di caratteri 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

Requisito	Valore
client minimo supportato	Windows 11 Build 22621
intestazione	dwrite_3.h
libreria	Dwrite.lib
dll	Dwrite.dll

Condividi tramite