TTEnableEmbeddingForFacename 函数 (t2embapi.h)

  • 项目

在字体排除列表中添加或删除人脸名称。

语法

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

参数

[in] lpszFacename

指向要从字体排除列表中添加或删除的字体的人脸名称的指针。

[in] bEnable

对字体排除列表执行布尔控制操作。 如果不是零，则人脸名称将从列表中删除;如果为零，则人脸名称将添加到列表中。

返回值

如果成功，则返回E_NONE。

lpszFacename 指示的 facename 将从字体排除列表中添加或删除。

否则，返回 嵌入函数错误消息中所述的错误代码。

注解

函数 TTEnableEmbeddingForFacename 使用字体排除列表来控制是否可以嵌入特定字体。 此列表标识不应嵌入且由单个系统上的所有创作客户端共享的所有字体。

创作客户端可以嵌入字体，而无需引用字体排除列表 (即，无需使用 TTEnableEmbeddingForFacename) 。 在文档中嵌入字体会导致以下权衡。

  • 提供文档内的所有字体信息，以便相应的客户端可以呈现文档。
  • 向文档添加大小。
  • 使文档的流式读取和写入操作复杂化，并且使用更多处理带宽。
  • 使文档更易于其他应用程序阅读。
  • 如果未使用类型排除列表，则可以将版权问题保留为非托管。
另外两个函数 （TTIsEmbeddingEnabled 和 TTIsEmbeddingEnabledForFacename）访问字体排除列表以提供启用状态。

字体排除列表存储在注册表项 中，HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed。 默认字体排除列表应包含以下表示 Microsoft Windows 核心字体的命名值条目。

值名称 数据类型 数据值
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
时代新罗马粗体 REG_DWORD 0
时代新罗马粗体斜体 REG_DWORD 0
泰晤士新罗马斜体 REG_DWORD 0

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 t2embapi.h
Library T2embed.lib
DLL T2embed.dll

另请参阅

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename