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