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

Weitere Informationen

IDWriteFactory