EM_SETLIMITTEXT消息

设置编辑控件的文本限制。 文本限制是用户可在编辑控件中键入的最大文本量( 在 TCHARs 中)。 可以将此消息发送到编辑控件或丰富的编辑控件。

对于编辑控件和 Microsoft Rich Edit 1.0,将使用字节。 对于 Microsoft Rich Edit 2.0 及更高版本,将使用字符。

EM_SETLIMITTEXT消息与EM_LIMITTEXT消息相同。

参数

wParam

用户可以输入的最大 TCHAR 数。 对于 ANSI 文本,这是字节数;对于 Unicode 文本,这是字符数。 此数字不包括终止 null 字符。

丰富的编辑控件: 如果此参数为零,则文本长度设置为 64,000 个字符。

如果此参数为零,则文本长度设置为单行编辑控件的0x7FFFFFFE字符或多行编辑控件的 1。

lParam

未使用此参数。

返回值

此消息不返回值。

注解

EM_SETLIMITTEXT消息仅限制用户可以输入的文本。 发送邮件时,它不会影响编辑控件中已有的任何文本,也不会影响 由WM_SETTEXT 消息复制到编辑控件的文本的长度。 如果应用程序使用 WM_SETTEXT 消息将更多的文本放置在编辑控件中 ,而不是在EM_SETLIMITTEXT 消息中指定的,用户可以编辑编辑控件的整个内容。

在调用EM_SETLIMITTEXT之前,用户可以在编辑控件中输入的文本量的默认限制为 32,767 个字符。

对于单行编辑控件,文本限制为0x7FFFFFFE字节或 wParam 参数的值(以较小为准)。 对于多行编辑控件,此值为 1 个字节或 wParam 参数的值,以较小者为准。

丰富编辑: 在 Microsoft Rich Edit 1.0 及更高版本中受支持。 将消息 EM_EXLIMITTEXT 用于大于 64,000 的文本长度值。 有关富编辑版本与各种系统版本的兼容性的信息,请参阅 “关于富编辑控件”。

要求

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

另请参阅

EM_GETLIMITTEXT