IDWriteFactory::GetSystemFontCollection-Methode (dwrite.h)
Ruft ein -Objekt ab, das den Satz der installierten Schriftarten darstellt.
Syntax
HRESULT GetSystemFontCollection(
[out] IDWriteFontCollection **fontCollection,
BOOL checkForUpdates
);
Parameter
[out] fontCollection
Typ: IDWriteFontCollection**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das Systemschriftartensammlungsobjekt oder NULL im Falle eines Fehlers.
checkForUpdates
Typ: BOOL
Wenn dieser Parameter nichtzero ist, führt die Funktion eine sofortige Überprüfung auf Änderungen am Satz installierter Schriftarten durch. Wenn dieser Parameter FALSE ist, erkennt die Funktion weiterhin Änderungen, wenn der Schriftartcachedienst ausgeführt wird, aber es kann zu einer gewissen Latenz kommen. Beispielsweise kann eine Anwendung TRUE angeben, wenn sie selbst gerade eine Schriftart installiert hat und sicherstellen möchte, dass die Schriftartsammlung diese Schriftart enthält.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |