Metodo IDWriteFontCollection2::GetMatchingFonts (dwrite_3.h)

Articolo
11/20/2024

Recupera un elenco di tipi di carattere nella famiglia di caratteri specificata, classificati in ordine di corrispondenza con i valori dell'asse specificati.

Sintassi

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

Parametri

familyName

Tipo: WCHAR const *

Nome della famiglia di caratteri. Il nome non fa distinzione tra maiuscole e minuscole, ma deve in caso contrario corrispondere esattamente a un nome di famiglia nella raccolta.

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] fontList

Tipo: IDWriteFontList2**

Indirizzo di un puntatore a un'interfaccia IDWriteFontList2. Al termine, la funzione imposta il puntatore su un oggetto elenco di caratteri appena creato.

Valore restituito

Tipo: HRESULT

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

Osservazioni

Se non corrispondono tipi di carattere, viene restituito un oggetto elenco vuoto (chiamando IDWriteFontList::GetFontCount su di esso restituisce 0), ma la funzione non restituisce un errore.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 Build 16299
server minimo supportato	Windows 10 Build 16299
piattaforma di destinazione	Finestre
intestazione	dwrite_3.h
libreria	Dwrite.lib

Condividi tramite