EM_SETTEXTMODE消息

设置 Rich Edit 控件的文本模式或撤消级别。 如果控件包含任何文本，则消息失败。

参数

wParam

TEXTMODE 枚举类型的一个或多个值。 值指定控件的文本模式和撤消级别参数的新设置。

指定以下值之一以设置文本模式参数。 如果未指定文本模式值，则文本模式将保持其当前设置。

“值”	含义
TM_PLAINTEXT	指示纯文本模式，其中控件类似于标准编辑控件。 有关纯文本模式的详细信息，请参阅以下备注部分。
TM_RICHTEXT	指示格式文本模式，其中控件具有标准格式编辑功能。 格式文本模式是默认设置。

指定以下值之一以设置撤消级别参数。 如果未指定撤消级别值，则撤消级别将保持其当前设置。

“值”	含义
TM_SINGLELEVELUNDO	控件允许用户仅撤消可以撤消的最后一个操作。
TM_MULTILEVELUNDO	控件支持多个撤消操作。 这是默认设置。 使用 EM_SETUNDOLIMIT 消息可设置最大撤消操作数。

指定以下值之一来设置代码页参数。 如果未指定代码页值，则代码页将保留其当前设置。

“值”	含义
TM_SINGLECODEPAGE	控件仅允许英语键盘和对应于默认字符集的键盘。 例如，可以使用希腊语和英语。 请注意，这会阻止 Unicode 文本进入控件。 例如，如果 Rich Edit 控件必须限制为 ANSI 文本，请使用此值。
TM_MULTICODEPAGE	控件允许多个代码页和 Unicode 文本进入控件。 这是默认设置。

lParam

不使用此参数;它必须为零。

返回值

如果消息成功，则返回值为零。

如果消息失败，则返回值为非零值。

备注

在富文本模式下，富编辑控件具有标准的丰富编辑功能。 但是，在纯文本模式下，控件类似于标准编辑控件：

• 纯文本控件中的文本只能有一种格式 (，例如 Bold、10pt Arial) 。
• 用户无法将格式文本格式（如 RTF 格式 (RTF) 或嵌入的对象粘贴到纯文本控件中。
• 格式文本模式控件始终具有默认的文档结束标记或回车符，以设置段落格式。 另一方面，纯文本控件不需要默认的文档末尾标记，因此省略它。

控件在收到 EM_SETTEXTMODE 消息时必须不包含任何文本。 若要确保没有文本，请使用空字符串 ( “”) 发送WM_SETTEXT消息。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Richedit.h

另请参阅

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT