共用方式為

TTEmbedFontFromFileA 函式 (t2embapi.h)

  • 發行項

建立字型結構，其中包含子集寬字元 (16 位) 字型。 外部檔案會提供字型資訊。

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

語法

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

要內嵌的字型檔案名和路徑。 這是 ANSI 字串。

[in] usTTCIndex

以零起始的索引到字型檔案， (TTC) 識別要內嵌的實體字型。 如果檔案包含單一字型 (，例如 TTF 或 OTF 大綱檔案) ，此參數應該設定為 0。

[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 字元碼。 此欄位僅用於子設定字型，如果 theulFlagsfield 未指定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 中所述的錯誤碼。

備註

此函式會參考用戶端定義的回呼常式，以將字型結構內嵌至檔資料流程。

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

如需從裝置內容內嵌 Unicode 字元的資訊，請參閱 TTEmbedFont;如需從裝置內容內嵌 UCS-4 字元的相關資訊，請參閱 TTEmbedFontEx。

規格需求

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

另請參閱

TTEMBEDINFO

TTEmbedFont

TTEmbedFontEx

TTLoadEmbeddedFont