TTEmbedFontFromFileA-Funktion (t2embapi.h)

Artikel
08/26/2023

Erstellt eine Schriftartstruktur, die die subsetierte Breitzeichenschriftart (16-Bit) enthält. Eine externe Datei stellt die Schriftartinformationen bereit.

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

Syntax

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

Der Name der Schriftartdatei und der pfad, der einbettet werden soll. Dies ist eine ANSI-Zeichenfolge.

[in] usTTCIndex

Nullbasierter Index in der Schriftartdatei (TTC), der die einzubettende physische Schriftart identifiziert. Wenn die Datei eine einzelne Schriftart enthält (z. B. eine TTF- oder OTF-Gliederungsdatei), sollte dieser Parameter auf 0 festgelegt werden.

[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 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 Subsetting enthält. Dieses Feld wird nur zum Untersetzen einer Schriftart verwendet und ignoriert, wenn das FeldulFlags keine TTEMBED_SUBSET angibt.

[in] usCharCodeCount

Die Anzahl der Zeichen in der Liste der Zeichen, die durch pusCharCodeSet 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 die TTLoadEmbeddedFont-Funktion 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 aus einem Gerätekontext finden Sie unter TTEmbedFont; Informationen zum Einbetten von UCS-4-Zeichen aus einem Gerätekontext finden Sie unter TTEmbedFontEx.

Anforderungen


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

Freigeben über