IDWriteFontSet::GetMatchingFonts(DWRITE_FONT_PROPERTYconst*,UINT32,IDWriteFontSet**)-Methode (dwrite_3.h)

Gibt eine Teilmenge von Schriftarten zurück, die nach den angegebenen Eigenschaften gefiltert werden.

Syntax

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const *properties,
  UINT32                     propertyCount,
  IDWriteFontSet             **filteredSet
);

Parameter

properties

Typ: [in] const DWRITE_FONT_PROPERTY*

Liste der Eigenschaften, mit der gefiltert werden soll.

propertyCount

Typ: UINT32

Die Anzahl der zu filternden Eigenschaften.

filteredSet

Typ: [out] IDWriteFontSet**

Die Teilmenge der Schriftarten, die den Eigenschaften entsprechen, oder nullptr bei Fehlern.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn keine Schriftarten mit dem Filter übereinstimmen, ist die Teilmenge leer (GetFontCount gibt 0 zurück), aber die Funktion gibt keinen Fehler zurück. Die Teilmenge ist immer gleich oder kleiner als die ursprüngliche Menge. Wenn Sie nur Remoteschriftarten herausfiltern möchten, können Sie null in eigenschaften und null in propertyCount übergeben.

Anforderungen

Weitere Informationen

IDWriteFontSet