TTEmbedFontEx-Funktion (t2embapi.h)

Artikel
03/02/2024

Erstellt eine Schriftartstruktur, die die untergeordnete UCS-4-Zeichenschriftart (32-Bit) enthält. Die aktuelle Schriftart des Gerätekontexts (hDC) stellt die Schriftartinformationen bereit.

Diese Funktion übergibt die Daten an eine clientdefinierte Rückrufroutine zum Einfügen in den Dokumentdatenstrom.

TTEmbedFontEx wird auf die gleiche Weise wie TTEmbedFont verwendet, akzeptiert jedoch einen Zeichencodesatz, der in UCS-4 (32 Bits) angegeben ist.

Syntax

LONG TTEmbedFontEx(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           ULONG          *pulCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Parameter

[in] hDC

Gerätekontexthandle.

[in] ulFlags

Flag, das die Einbettungsanforderung angibt. Dieses Flag kann null oder mehr der folgenden Werte aufweisen.

Wert	Bedeutung
TTEMBED_EMBEDEUDC	Schließen Sie die zugeordneten EUDC-Schriftartdateidaten in die Schriftartstruktur ein.
TTEMBED_RAW	Gibt eine Schriftartstruktur zurück, die den vollständigen Zeichensatz enthält, nicht komprimiert. Dies ist das Standardverhalten der Funktion.
TTEMBED_SUBSET	Gibt eine untergeordnete Schriftart zurück, die nur die durch den Parameter pusCharCodeSet oder pulCharCodeSet angegebenen Glyphen enthält. Diese Zeichencodes müssen je nach Parameter als 16-Bit- oder UCS-4-Zeichen bezeichnet werden.
TTEMBED_TTCOMPRESSED	Gibt eine komprimierte Schriftartstruktur zurück.

[in] ulCharSet

Flag, das den Zeichensatz der einzubettenden Schriftart angibt. Dieses Flag kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
CHARSET_UNICODE	Unicode-Zeichensatz, der eine 16-Bit-Zeichencodierung erfordert.
CHARSET_SYMBOL	Symbolzeichensatz, der eine 16-Bit-Zeichencodierung erfordert.

[out] pulPrivStatus

Zeiger auf das Flag, das die Einbettungsberechtigungen der Schriftart angibt. Dieses Flag kann einen der folgenden Werte aufweisen. Diese Funktion gibt die am wenigsten restriktive Lizenz zurück.

Wert	Bedeutung
EMBED_PREVIEWPRINT	Vorschau und Druckeinbettung.
EMBED_EDITABLE	Bearbeitbare Einbettung.
EMBED_INSTALLABLE	Installierbare Einbettung.
EMBED_NOEMBEDDING	Einbettung eingeschränkter Lizenzen.

[out] pulStatus

Zeiger auf ein Bitfeld, das status Informationen zur Einbettungsanforderung enthält. Dieses Feld wird nach Abschluss dieser Funktion ausgefüllt. Für diesen Parameter sind derzeit keine Bits definiert.

lpfnWriteToStream

Zeiger auf die clientdefinierte Rückruffunktion, die die Schriftartstruktur in den Dokumentdatenstrom schreibt. Weitere Informationen finden Sie unter WRITEEMBEDPROC.

[in] lpvWriteStream

Ein Token zur Darstellung des Ausgabedatenstroms.

[in] pulCharCodeSet

Zeiger auf den Puffer, der die optionalen UCS-4-Zeichencodes für das Subsetting enthält. Dieses Feld wird nur zum Untersetzen einer Schriftart verwendet und ignoriert, wenn das UlFlags-Feld nicht TTEMBED_SUBSET angibt.

[in] usCharCodeCount

Die Anzahl der Zeichen in der Liste der Zeichen, die durch pulCharCodeSet angegeben werden. Dieses Feld wird nur zum Untersetzen einer Schriftart verwendet und ignoriert, wenn das UlFlags-Feld nicht TTEMBED_SUBSET angibt.

[in] usLanguage

Gibt an, welche Sprache in der Namenstabelle beim Subsetting beibehalten werden soll. Legen Sie auf 0 fest, um alle Sprachen beizubehalten. Dieses Feld wird nur zum Untersetzen einer Schriftart verwendet und ignoriert, wenn das UlFlags-Feld nicht TTEMBED_SUBSET angibt.

[in, optional] pTTEmbedInfo

Zeiger auf eine TTEMBEDINFO-Struktur , die die URLs enthält, von denen aus legitim auf das eingebettete Schriftartobjekt verwiesen werden kann. Wenn pTTEmbedInfoNULL ist, werden dem eingebetteten Schriftartobjekt keine URLs hinzugefügt, und es erfolgt keine URL-Überprüfung, wenn der Client TTLoadEmbeddedFont aufruft.

Rückgabewert

Wenn die Einbettung erfolgreich war, wird E_NONE zurückgegeben.

Die Schriftartstruktur wird vom Client in den Dokumentstream integriert.

pulPrivStatus ist festgelegt und gibt die Einbettungsberechtigungen der Schriftart an. und pulStatus wird so festgelegt, dass Ergebnisse des Einbettungsvorgangs bereitgestellt werden.

Andernfalls wird ein Fehlercode zurückgegeben, der unter Embedding-Function Error Messages beschrieben wird.

Hinweise

Diese Funktion verweist auf eine clientdefinierte Rückrufroutine zum Einbetten der Schriftartstruktur in den Dokumentdatenstrom.

Clients sind dafür verantwortlich, den Zeichensatz der Schriftart zu bestimmen und anzugeben.

Informationen zum Einbetten von Unicode-Zeichen finden Sie unter TTEmbedFont; Informationen zum Einbetten von Unicode-Zeichen aus einer Datei finden Sie unter TTEmbedFontFromFileA.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	t2embapi.h
Bibliothek	T2embed.lib
DLL	T2embed.dll

Weitere Informationen

Share via