TTEnableEmbeddingForFacename-Funktion (t2embapi.h)

Artikel
03/02/2024

Fügt Gesichtsnamen hinzu oder entfernt sie aus der Ausschlussliste für Schriftarten.

Syntax

LONG TTEnableEmbeddingForFacename(
  [in] LPCSTR lpszFacename,
  [in] BOOL   bEnable
);

Parameter

[in] lpszFacename

Zeiger auf den Gesichtsnamen der Schriftart, die der Schreibschriftausschlussliste hinzugefügt oder entfernt werden soll.

[in] bEnable

Boolescher Steuerungsvorgang in der Schreibschriftausschlussliste. Wenn nichtzero, wird der Gesichtsname aus der Liste entfernt. wenn null, wird der Gesichtsname der Liste hinzugefügt.

Rückgabewert

Bei erfolgreicher Ausführung wird E_NONE zurückgegeben.

Der durch lpszFacename angegebene Gesichtsname wird der Ausschlussliste für Schriftarten hinzugefügt oder entfernt.

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

Hinweise

Die Funktion TTEnableEmbeddingForFacename verwendet eine Schriftartausschlussliste, um zu steuern, ob eine bestimmte Schriftart eingebettet werden kann. In dieser Liste werden alle Schriftarten identifiziert, die NICHT eingebettet werden sollen, und die von allen Erstellungsclients auf einem einzelnen System freigegeben werden sollen.

Ein Erstellungsclient kann Schriftarten einbetten, ohne auf die Schreibschriftausschlussliste zu verweisen (d. a. ohne TTEnableEmbeddingForFacename). Das Einbetten von Schriftarten in ein Dokument führt zu den folgenden Kompromissen.

Stellt alle Schriftartinformationen in einem Dokument bereit, damit der entsprechende Client das Dokument rendern kann.
Fügt einem Dokument größe hinzu.
Das Streaming von Lese- und Schreibvorgängen zu einem Dokument wird komplizierter und benötigt mehr Verarbeitungsbandbreite.
Macht ein Dokument für andere Anwendungen weniger lesbar.
Kann Urheberrechtsprobleme nicht verwaltet lassen, wenn die Typausschlussliste nicht verwendet wird.

Zwei zusätzliche Funktionen, TTIsEmbeddingEnabled und TTIsEmbeddingEnabledForFacename, greifen auf die Schreibschriftausschlussliste zu, um die Aktivierung status bereitzustellen.

Die Schriftartausschlussliste wird im Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embedgespeichert. Die Standardschriftausschlussliste sollte die folgenden benannten Werteinträge enthalten, die die Microsoft Windows Core-Schriftarten darstellen.

Wertname	Datentyp	Datenwert
Arial	REG_DWORD	0
Arial, fett	REG_DWORD	0
Arial, fett kursiv	REG_DWORD	0
Arial, kursiv	REG_DWORD	0
Courier New	REG_DWORD	0
Courier New Bold	REG_DWORD	0
Courier New Bold Italic	REG_DWORD	0
Courier New Kursiv	REG_DWORD	0
Times New Roman	REG_DWORD	0
Times New Roman Bold	REG_DWORD	0
Times New Roman Bold Italic	REG_DWORD	0
Times New Roman Italic	REG_DWORD	0

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

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename

Freigeben über