IDWriteFactory::CreateCustomFontFileReference-Methode (dwrite.h)

  • Artikel

Erstellt einen Verweis auf eine anwendungsspezifische Schriftartdateiressource.

Syntax

HRESULT CreateCustomFontFileReference(
  [in]  void const            *fontFileReferenceKey,
        UINT32                fontFileReferenceKeySize,
        IDWriteFontFileLoader *fontFileLoader,
  [out] IDWriteFontFile       **fontFile
);

Parameter

[in] fontFileReferenceKey

Typ: const void*

Ein Referenzschlüssel für die Schriftartdatei, der die Schriftartdateiressource während der Lebensdauer von fontFileLoader eindeutig identifiziert.

fontFileReferenceKeySize

Typ: UINT32

Die Größe des Referenzschlüssels der Schriftartdatei in Byte.

fontFileLoader

Typ: IDWriteFontFileLoader*

Das Ladeprogramm für schriftartendateien, das vom Schriftartensystem zum Laden von Daten aus der durch fontFileReferenceKey identifizierten Datei verwendet wird.

[out] fontFile

Typ: IDWriteFontFile**

Enthält eine Adresse eines Zeigers auf das neu erstellte Schriftartdateiobjekt, wenn diese Methode erfolgreich ist, oder NULL im Falle eines Fehlers.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion wird für Fälle bereitgestellt, in denen eine Anwendung oder ein Dokument eine private Schriftart verwenden muss, ohne sie auf dem System installieren zu müssen. fontFileReferenceKey muss nur im Bereich des in diesem Aufruf verwendeten fontFileLoader eindeutig sein.

Anforderungen

   
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