RichEdit_SetTextMode

描述

设置富编辑控件的文本模式或撤消级别.如果控件包含任何文本,则消息失败.您可以使用此功能或发送EM_SETTEXTMODE 消息明确.

FreeBasic Syntax

FUNCTION RichEdit_SetTextMode ( _

BYVAL hRichEdit AS HWND, _

BYVAL pvalues AS LONG _

) AS LONG

参数

hRichEdit

[in]编辑器控件句柄

pvalues

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

指定设置文本模式参数的下列值之一.如果不指定文本模式值,则文本模式仍处于当前设置.

Value	Meaning
TM_PLAINTEXT	指示纯文本模式,其中控件类似于标准编辑控件.有关纯文本模式的更多信息,请参见以下备注部分.
TM_RICHTEXT	指示富文本模式,其中控件具有标准丰富的编辑功能.富文本模式是默认设置.

指定下列值之一,用于设置撤消级别参数.如果未指定撤消级别值,则撤消级别仍处于当前设置.

Value	Meaning
TM_SINGLELEVELUNDO	控件允许用户撤消最后一个可以撤消的操作.
TM_MULTILEVELUNDO	控件支持多个撤消操作.这是默认设置.使用EM_SETUNDOLIMIT消息设置最大数量的撤消操作.

指定用于设置代码页参数的下列值之一.如果未指定代码页值,则代码页仍处于当前设置.

Value	Meaning
TM_SINGLECODEPAGE	控件只允许英文键盘和一个对应的默认字符集键盘.例如,你可以有希腊语和英语.注意,这会阻止Unicode文本进入控件.例如,如果一个微软Rich Edit控件必须限制在ANSI文本使用此值.
TM_MULTICODEPAGE	控件允许多个代码页和Unicode文本进入控件.这是默认设置.

Return Value

如果消息成功,返回值为零.

如果消息失败,则返回值为非零值.

备注

在富文本模式下,富编辑控件具有标准丰富的编辑功能.然而,在纯文本模式下,控件类似于标准编辑控件：

·	在一个纯文本控件的文本只能有一种格式（如粗体、10pt宋体）.

·	用户不能粘贴富文本格式,如富文本格式(RTF)或嵌入的对象转换为纯文本控件.

·	富文本模式控件总是具有文档标记或回车的默认结尾,以格式化段落.另一方面,纯文本控件不需要默认的文档标记结束,因此省略了它.

控件在接收到EM_SETTEXTMODE消息.确保没有文字,发送一个WM_SETTEXT用一个空字符串("").消息　?兴?猦耀???????猦杩???攷?戱昹て???挰?攳???

最低操作系统

Windows 95和Windows NT的丰富的编辑2.0, 98, 4.0.

引用文件

AfcRichEdit.inc