EM_SETTEXTMODE訊息
設定豐富編輯控制項的文字模式或復原層級。 如果控制項包含任何文字,訊息就會失敗。
參數
-
wParam
-
來自 TEXTMODE列舉類型的一或多個值。 這些值會指定控制項文字模式和復原層級參數的新設定。
指定下列其中一個值來設定文字模式參數。 如果您未指定文字模式值,文字模式會維持在其目前的設定。
值 意義 TM_PLAINTEXT 表示純文字模式,其中控制項與標準編輯控制項類似。 如需純文字模式的詳細資訊,請參閱下列一節。 TM_RICHTEXT 表示 RTF 模式,其中控制項具有標準的豐富編輯功能。 RTF 模式是預設設定。 指定下列其中一個值來設定復原層級參數。 如果您未指定復原層級值,復原層級會維持在其目前的設定。
值 意義 TM_SINGLELEVELUNDO 控制項可讓使用者只復原可復原的最後一個動作。 TM_MULTILEVELUNDO 控制項支援多個復原作業。 這是預設值。 使用 EM_SETUNDOLIMIT 訊息來設定復原動作的最大數目。 指定下列其中一個值來設定字碼頁參數。 如果您未指定字碼頁值,字碼頁會保留在目前的設定中。
值 意義 TM_SINGLECODEPAGE 控制項只允許英文鍵盤和對應至預設字元集的鍵盤。 例如,您可以有希臘文和英文。 請注意,這可防止 Unicode 文字進入控制項。 例如,如果 Rich Edit 控制項必須限制為 ANSI 文字,請使用此值。 TM_MULTICODEPAGE 控制項允許多個字碼頁和 Unicode 文字進入控制項。 這是預設值。 -
lParam
-
不使用此參數;它必須是零。
傳回值
如果訊息成功,則傳回值為零。
如果訊息失敗,則傳回值是非零值。
備註
在 RTF 模式中,豐富的編輯控制項具有標準的豐富編輯功能。 不過,在純文字模式中,控制項類似于標準編輯控制項:
- 純文字控制項中的文字只能有一種格式 (,例如 Bold、10pt Arial) 。
- 使用者無法將 RTF 格式 (RTF) 或内嵌物件等 RTF 格式貼到純文字控制項中。
- RTF 模式控制項一律會有預設檔案結尾標記或歸位字元,以格式化段落。 另一方面,純文字控制項不需要預設檔案結尾標記,因此省略它。
控制項在收到 EM_SETTEXTMODE 訊息時,不得包含任何文字。 若要確保沒有文字,請使用空字串傳送 WM_SETTEXT 訊息 (「」) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
標頭 |
|