IDWriteFontFamily2::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

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

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.

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