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
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite_3.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |