IDWriteFontSet1::GetFilteredFonts(DWRITE_FONT_AXIS_RANGEconst*,UINT32,BOOL,IDWriteFontSet1**)-Methode (dwrite_3.h)

Artikel
02/29/2024

Ruft eine Teilmenge der Schriftarten ab, die nach den angegebenen Bereichen gefiltert werden, endpunkt inklusive.

Syntax

HRESULT GetFilteredFonts(
        DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
        UINT32                       fontAxisRangeCount,
        BOOL                         selectAnyRange,
  [out] IDWriteFontSet1              **filteredFontSet
);

Parameter

fontAxisRanges

Typ: DWRITE_FONT_AXIS_RANGE const *

Liste der Achsenwertbereiche, nach der gefiltert werden soll.

fontAxisRangeCount

Typ: UINT32

Die Anzahl der zu filternden Achsenwertbereiche.

selectAnyRange

Typ: BOOL

true , wenn GetFilteredFonts einen beliebigen Bereich auswählen soll; false , wenn sie die Schnittmenge aller auswählen soll.

[out] filteredFontSet

Typ: IDWriteFontSet1**

Die Adresse eines Zeigers auf eine IDWriteFontSet1-Schnittstelle . Bei erfolgreicher Fertigstellung legt die Funktion den Zeiger auf ein Objekt fest, das die Teilmenge der Schriftarten darstellt, die innerhalb der Bereiche liegen. Andernfalls wird der Zeiger auf nullptrfestgelegt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn keine Schriftarten mit dem Filter übereinstimmen, ist das zurückgegebene Teilmengenobjekt leer (beim Aufrufen von IDWriteFontSet::GetFontCount wird 0 zurückgegeben), aber die Funktion gibt keinen Fehler zurück. Die Teilmenge ist immer gleich oder kleiner als die ursprüngliche Menge.

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