共用方式為


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