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 [僅限桌面應用程式] |
| 標頭 |
|