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) 的情況下 (內嵌字型,而不參考字型排除清單。 在檔中內嵌字型會導致下列取捨。

  • 提供檔內的所有字型資訊,讓適當的用戶端可以轉譯檔。
  • 將大小新增至檔。
  • 將串流讀取和寫入作業串流處理至檔,並使用更多處理頻寬。
  • 讓其他應用程式更容易讀取檔。
  • 如果未使用類型排除清單,可以保留未受管理的著作權問題。
兩個額外的函式 TTIsEmbeddingEnabledTTIsEmbeddingEnabledForFacename,存取字樣排除清單以提供啟用狀態。

字樣排除清單會儲存在登錄機碼 中,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