TTEnableEmbeddingForFacename function (t2embapi.h)
Adds or removes facenames from the typeface exclusion list.
Syntax
LONG TTEnableEmbeddingForFacename(
[in] LPCSTR lpszFacename,
[in] BOOL bEnable
);
Parameters
[in] lpszFacename
Pointer to the facename of the font to be added or removed from the typeface exclusion list.
[in] bEnable
Boolean controlling operation on typeface exclusion list. If nonzero, then the facename will be removed from the list; if zero, the facename will be added to the list.
Return value
If successful, returns E_NONE.
The facename indicated by lpszFacename will be added or removed from the typeface exclusion list.
Otherwise, returns an error code described in Embedding-Function Error Messages.
Remarks
The function TTEnableEmbeddingForFacename uses a typeface exclusion list to control whether a specific font can be embedded. This list identifies all fonts that should NOT be embedded and is shared by all authoring clients on a single system.
An authoring client can embed fonts without referencing the typeface exclusion list (that is, without using TTEnableEmbeddingForFacename). Embedding fonts in a document results in the following tradeoffs.
- Provides all font information within a document so the appropriate client can render the document.
- Adds size to a document.
- Complicates streaming read and write operations to a document and uses more processing bandwidth.
- Makes a document less readable by other applications.
- Can leave copyright issues unmanaged, if the type exclusion list is not used.
The typeface exclusion list is stored in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed. The default typeface exclusion list should contain the following named value entries representing the Microsoft Windows core fonts.
Value name | Data type | Data value |
---|---|---|
Arial | REG_DWORD | 0 |
Arial Bold | REG_DWORD | 0 |
Arial Bold Italic | REG_DWORD | 0 |
Arial Italic | REG_DWORD | 0 |
Courier New | REG_DWORD | 0 |
Courier New Bold | REG_DWORD | 0 |
Courier New Bold Italic | REG_DWORD | 0 |
Courier New Italic | 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 |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | t2embapi.h |
Library | T2embed.lib |
DLL | T2embed.dll |