EM_SETCHARFORMAT訊息

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

參數

wParam

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

值	意義
SCF_ALL	將格式設定套用至控制項中的所有文字。 SCF_SELECTION或SCF_WORD無效。
SCF_ASSOCIATEFONT	RichEdit 4.1： 將字型關聯至指定的腳本，因此變更該腳本的預設字型。 若要指定字型，請使用下列 CHARFORMAT2成員： yHeight、 bCharSet、 bPitchAndFamily、 szFaceName和 lcid。
SCF_ASSOCIATEFONT2	RichEdit 4.1： 將代理 (平面 2) 字型關聯至指定的腳本，因此變更該腳本的預設字型。 若要指定字型，請使用下列 CHARFORMAT2成員： yHeight、 bCharSet、 bPitchAndFamily、 szFaceName和 lcid。
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) 指出正在使用哪一個結構版本。

當字元無效時，可能會覆寫 szFaceName 和 bCharSet 成員，例如：中文字元的 Arial。

傳回值

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

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

備註

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

規格需求

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

另請參閱

參考

CHARFORMAT

CHARFORMAT2