IDWriteFontCollection2::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
03/01/2024

Ruft eine Liste der Schriftarten in der angegebenen Schriftartfamilie ab, die in der Reihenfolge sortiert wird, wie gut sie den angegebenen Achsenwerten entsprechen.

Syntax

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

Parameter

familyName

Typ: WCHAR const *

Name der Schriftfamilie. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet, andernfalls muss er genau mit einem Familiennamen in der Auflistung übereinstimmen.

fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE const *

Ein Zeiger auf ein Array, das eine Liste von Schriftartachsenwerten enthält. Das Array sollte die Größe (die Anzahl der Elemente) aufweisen, die durch das Argument fontAxisValueCount angegeben wird.

fontAxisValueCount

Typ: UINT32

Die Anzahl der im fontAxisValues-Array enthaltenen Schriftartachsenwerte.

[out] fontList

Typ: IDWriteFontList2**

Die Adresse eines Zeigers auf eine IDWriteFontList2-Schnittstelle . Nach erfolgreicher Fertigstellung legt die Funktion den Zeiger auf ein neu erstelltes Schriftlistenobjekt fest.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn keine Schriftarten übereinstimmen, wird ein leeres Listenobjekt zurückgegeben (beim Aufrufen von IDWriteFontList::GetFontCount wird 0 zurückgegeben), aber die Funktion gibt keinen Fehler zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib

Freigeben über