TTEmbedFont 函式 (t2embapi.h)

  • 發行項

建立字型結構，其中包含子集寬字元 (16 位) 字型。 裝置內容的目前字型 (hDC) 會提供字型資訊。

此函式會將數據傳遞至用戶端定義的回呼例程，以插入至檔數據流。

語法

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

參數

[in] hDC

裝置內容句柄。

[in] ulFlags

指定內嵌要求的旗標。 此旗標可以有下列零或多個值。

值 意義
TTEMBED_EMBEDEUDC
 包含與字型結構相關聯的 EUDC 字型檔案數據。
TTEMBED_RAW
 傳回包含完整字元集的非壓縮字型結構。 這是函式的預設行為。
TTEMBED_SUBSET
 傳回僅包含 pusCharCodeSet 或 pulCharCodeSet 參數所指示字元的子集字型。 這些字元碼必須表示為16位或UCS-4個字元，適用於參數。
TTEMBED_TTCOMPRESSED
 傳回壓縮的字型結構。

[in] ulCharSet

旗標，指定要內嵌之字型的字元集。 此旗標可以有下列其中一個值。

值 意義
CHARSET_UNICODE
 Unicode 字元集，需要16位字元編碼。
CHARSET_SYMBOL
 符號字元集，需要16位字元編碼。

[out] pulPrivStatus

旗標指標指出字型的內嵌許可權。 此旗標可以有下列其中一個值。 此函式會傳回授與的最低限制授權。

值 意義
EMBED_PREVIEWPRINT
 預覽和列印內嵌。
EMBED_EDITABLE
 可編輯的內嵌。
EMBED_INSTALLABLE
 可安裝的內嵌。
EMBED_NOEMBEDDING
 限制的授權內嵌。

[out] pulStatus

位欄位的指標，其中包含有關內嵌要求的狀態資訊。 完成此函式時會填入此欄位。 此參數目前未定義任何位。

lpfnWriteToStream

用戶端定義回呼函式的指標，它會將字型結構寫入檔數據流。 請參閱 WRITEEMBEDPROC。

[in] lpvWriteStream

表示輸出數據流的令牌。

[in] pusCharCodeSet

緩衝區的指標，其中包含子設定的選擇性 Unicode 字元碼。 此欄位僅用於子設定字型，如果 ulFlags 欄位未指定TTEMBED_SUBSET，則會忽略此欄位。

[in] usCharCodeCount

pusCharCodeSet 所指示字元清單中的字元數。 此欄位僅用於子設定字型，如果 ulFlags 欄位未指定TTEMBED_SUBSET，則會忽略此欄位。

[in] usLanguage

指定要在子設定時保留的名稱數據表語言。 設定為 0 以保留所有語言。 此欄位僅用於子設定字型，如果 ulFlags 欄位未指定TTEMBED_SUBSET，則會忽略此欄位。

[in, optional] pTTEmbedInfo

TTEMBEDINFO 結構的指標，其中包含可合法參考內嵌字型物件的 URL。 如果 pTTEmbedInfo 為 NULL，則不會將任何 URL 新增至內嵌字型物件，而且用戶端呼叫 TTLoadEmbeddedFont 時不會進行 URL 檢查。

傳回值

如果內嵌成功，則會傳回E_NONE。

字型結構會由用戶端併入文件數據流中。 已設定 pulPrivStatus ，表示字型的內嵌許可權;和 pulStatus 會設定為提供內嵌作業的結果。

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

備註

用戶端負責判斷並指出字型的字元集。

如需內嵌 UCS-4 字元的相關信息，請參閱 TTEmbedFontEx。 如需從檔案內嵌字型字元的資訊，請參閱 TTEmbedFontFromFileA。

規格需求

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

另請參閱

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont