共用方式為


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 [僅限傳統型應用程式]
標頭
Richedit.h

另請參閱

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT