TTEmbedFont-Funktion (t2embapi.h)

Artikel
08/26/2023

Erstellt eine Schriftartstruktur, die die untergeordnete Breitzeichenschriftart (16 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.

Syntax

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [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	Fügen Sie die zugehörigen DATEN der EUDC-Schriftartdatei in die Schriftartstruktur ein.
TTEMBED_RAW	Gibt eine Schriftartstruktur zurück, die den vollständigen Zeichensatz nicht komprimiert enthält. 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 entsprechend dem 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 ein Flag, das die Einbettungsberechtigungen der Schriftart angibt. Dieses Flag kann einen der folgenden Werte aufweisen. Diese Funktion gibt die am wenigsten einschränkende Lizenz zurück, die gewährt wurde.

Wert	Bedeutung
EMBED_PREVIEWPRINT	Vorschau- und Druckeinbettung.
EMBED_EDITABLE	Bearbeitbare Einbettung.
EMBED_INSTALLABLE	Installierbare Einbettung.
EMBED_NOEMBEDDING	Eingeschränkte Lizenzeinbettung.

[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 Dokumentstream schreibt. Weitere Informationen finden Sie unter WRITEEMBEDPROC.

[in] lpvWriteStream

Ein Token zur Darstellung des Ausgabedatenstroms.

[in] pusCharCodeSet

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

[in] usCharCodeCount

Die Anzahl der Zeichen in der Liste der Zeichen, die von pusCharCodeSet angegeben werden. Dieses Feld wird nur zum Untersetzen einer Schriftart verwendet und ignoriert, wenn das Feld ulFlags nicht TTEMBED_SUBSET angibt.

[in] usLanguage

Gibt an, welche Sprache in der Namenstabelle beim Untersetzen 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 Feld ulFlags nicht TTEMBED_SUBSET angibt.

[in, optional] pTTEmbedInfo

Zeiger auf eine TTEMBEDINFO-Struktur , die die URLs enthält, von denen auf das eingebettete Schriftartobjekt legitim verwiesen werden kann. Wenn pTTEmbedInfoNULL ist, werden dem eingebetteten Schriftartobjekt keine URLs hinzugefügt, und es wird keine URL-Überprüfung durchgeführt, 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 ist so festgelegt, dass ergebnisse des Einbettungsvorgangs bereitgestellt werden.

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

Hinweise

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

Informationen zum Einbetten von UCS-4-Zeichen finden Sie unter TTEmbedFontEx. Informationen zum Einbetten von Schriftartzeichen 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