IDWriteFontCollection2::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
11/20/2024

Ruft eine Liste der Schriftarten in der angegebenen Schriftfamilie ab, die in der Reihenfolge bewertet 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 Schriftartenfamilie. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet, muss aber andernfalls genau mit einem Familiennamen in der Auflistung übereinstimmen.

fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE const *

Ein Zeiger auf ein Array, das eine Liste von Schriftachsenwerten enthält. Das Array sollte die Größe (die Anzahl der Elemente) sein, die durch das argument fontAxisValueCount angegeben ist.

fontAxisValueCount

Typ: UINT32-

Die Anzahl der Schriftachsenwerte, die in der fontAxisValues Array enthalten sind.

[out] fontList

Typ: IDWriteFontList2**

Die Adresse eines Zeigers auf eine IDWriteFontList2 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf ein neu erstelltes Schriftartlistenobjekt fest.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Bemerkungen

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10 Build 16299
mindestens unterstützte Server-	Windows 10 Build 16299
Zielplattform-	Fenster
Header-	dwrite_3.h
Library	Dwrite.lib

Freigeben über