共用方式為


EM_SETCHARFORMAT訊息

在豐富的編輯控制項中設定字元格式設定。

參數

wParam

套用至控制項的字元格式設定。 如果此參數為零,則會設定預設字元格式。 否則,它可以是下列其中一個值。

意義
SCF_ALL
將格式設定套用至控制項中的所有文字。 SCF_SELECTION或SCF_WORD無效。
SCF_ASSOCIATEFONT
RichEdit 4.1: 將字型關聯至指定的腳本,因此變更該腳本的預設字型。 若要指定字型,請使用下列 CHARFORMAT2成員: yHeightbCharSetbPitchAndFamilyszFaceNamelcid
SCF_ASSOCIATEFONT2
RichEdit 4.1: 將代理 (平面 2) 字型關聯至指定的腳本,因此變更該腳本的預設字型。 若要指定字型,請使用下列 CHARFORMAT2成員: yHeightbCharSetbPitchAndFamilyszFaceNamelcid
SCF_CHARREPFROMLCID
從 LCID 取得字元 Repertoire。
SCF_DEFAULT
RichEdit 4.1: 設定控制項的預設字型。
SPF_DONTSETDEFAULT
當豐富編輯控制項是空的時,防止設定預設段落格式。
SCF_NOKBUPDATE
RichEdit 4.1: 防止鍵盤切換以符合字型。 例如,如果已設定阿拉伯字型,則 Bidi 語言的自動鍵盤功能通常會將鍵盤變更為阿拉伯文鍵盤。
SCF_SELECTION
將格式設定套用至目前的選取範圍。 如果選取範圍是空的,則會將字元格式套用至插入點,而新的字元格式只會生效,直到插入點變更為止。
SPF_SETDEFAULT
設定預設段落格式設定屬性。
SCF_SMARTFONT
只有當字型可以處理腳本時,才套用字型。
SCF_USEUIRULES
RichEdit 4.1:SCF_SELECTION搭配使用。 表示格式來自工具列或其他 UI 工具,因此應該使用 UI 格式規則,而不是常值格式設定。
SCF_WORD
將格式設定套用至選取的單字或單字。 如果選取範圍是空的,但插入點位於單字內,則會將格式設定套用至該字。 SCF_WORD值必須與SCF_SELECTION值搭配使用。

lParam

CHARFORMAT結構的指標,指定要使用的字元格式設定。 只會變更 dwMask 成員所指定的格式化屬性。

Microsoft Rich Edit 2.0 和更新版本:此參數可以是 CHARFORMAT2 結構的指標,這是 CHARFORMAT 結構的延伸。 傳送 EM_SETCHARFORMAT 訊息之前,請將結構的 cbSize 成員設定為 sizeof(CHARFORMAT)sizeof(CHARFORMAT2) 指出正在使用哪一個結構版本。

當字元無效時,可能會覆寫 szFaceNamebCharSet 成員,例如:中文字元的 Arial。

傳回值

如果作業成功,傳回值為非零值。

如果作業失敗,則傳回值為零。

備註

如果使用相同的參數多次傳送此訊息,則會切換文字的效果。 也就是說,傳送訊息一次會產生效果、傳送訊息兩次會取消效果等等。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限桌面應用程式]
標頭
Richedit.h

另請參閱

參考

CHARFORMAT

CHARFORMAT2