TTEnableEmbeddingForFacename 函式 (t2embapi.h)

  • 發行項

從字樣排除清單中新增或移除臉部名稱。

語法

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

參數

[in] lpszFacename

要從字樣排除清單中新增或移除之字型臉部名稱的指標。

[in] bEnable

字樣排除清單上的布爾值控制作業。 如果非零，則臉部名稱將會從清單中移除;如果為零，則臉部名稱會新增至清單。

傳回值

如果成功，則會傳回E_NONE。

lpszFacename 所指示的 facename 將會從字樣排除清單中新增或移除。

否則，傳回 Embedding-Function Error Messages 中所述的錯誤碼。

備註

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
Times New Roman Bold REG_DWORD 0
Times New Roman Bold Italic REG_DWORD 0
Times New Roman Italic REG_DWORD 0

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 t2embapi.h
程式庫 T2embed.lib
Dll T2embed.dll

另請參閱

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename