AddSubsettedFontA

文字, 字型

描述

結尾的 A 表示 ANSI(char)DLL 進入點;ActiveX/COM 介面只提供 Unicode 形式。行為與 AddSubsettedFont 完全相同,字串參數依目前 SetAnsiMode 的字碼頁解讀

此函式用來內嵌字型的「子集」。也就是只內嵌指定字元的字型資訊,縮減文件大小。此函式也允許內嵌任何 Unicode 字元,因此可以使用中文、日文、韓文與其他語言的字元。

較新的 AddTrueTypeSubsettedFont 函式提供更進階的字型子集化功能

語法

Delphi

Function DLAddSubsettedFontA(InstanceID: Integer; FontName: PAnsiChar; CharsetIndex: Integer; SubsetChars: PAnsiChar): Integer;

DLL

int DLAddSubsettedFontA(int InstanceID, const char * FontName, int CharsetIndex, const char * SubsetChars);

參數

FontName要安裝的 TrueType 字型名稱。可以是 Windows\Fonts 資料夾顯示的字型名稱(例如 "Times New Roman Bold"),或字型家族名稱加方括號的選配樣式指示(例如 "Times New Roman [BoldItalic]")。可用的樣式指示為:[Bold]、[Italic] 或 [BoldItalic]。
CharsetIndex必須指定包含想子集化字元的字元集:1 = ANSI 2 = 預設 3 = 符號 4 = Shift JIS 5 = 韓文 6 = GB2312 7 = 繁體中文 Big 5 8 = OEM 9 = Johab 10 = 希伯來文 11 = 阿拉伯文 12 = 希臘文 13 = 土耳其文 14 = 越南文 15 = 泰文 16 = 東歐 17 = 俄文 18 = Mac 19 = 波羅的海
SubsetChars字串,內含想要子集化的字元。重複字元會被忽略。每個字型子集最多 255 個字元。任何 Unicode 字元都能內嵌,但你必須確認該字元存在於指定的字元集。

傳回值

0無法加入子集化字型,或 CharSet 參數超出範圍
Non-zero加入字型的 FontID。此 ID 可搭配 SelectFont 函式選取該字型。