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

Artikel
04/08/2024

Ruft eine Teilmenge von Schriftarten ab, die nach den angegebenen Eigenschaften gefiltert werden.

Syntax

HRESULT GetFilteredFonts(
        DWRITE_FONT_PROPERTY const *properties,
        UINT32                     propertyCount,
        BOOL                       selectAnyProperty,
  [out] IDWriteFontSet1            **filteredFontSet
);

Parameter

properties

Typ: DWRITE_FONT_PROPERTY const *

Liste der Eigenschaften, nach der gefiltert werden soll.

propertyCount

Typ: UINT32

Die Anzahl der zu filternden Eigenschaften.

selectAnyProperty

Typ: BOOL

true , wenn GetFilteredFontIndices eine eigenschaft 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 den Eigenschaften entsprechen. 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