EM_SETLIMITTEXT消息
设置编辑控件的文本限制。 文本限制是用户可以在编辑控件中键入的最大文本量(以 TCHAR为单位)。 可以将此消息发送到编辑控件或富编辑控件。
对于编辑控件和 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 参数的值,以较小者为准。
Rich Edit: 在 Microsoft Rich Edit 1.0 及更高版本中受支持。 对于大于 64,000 的文本长度值,请使用消息 EM_EXLIMITTEXT 。 有关 Rich Edit 版本与各种系统版本的兼容性的信息,请参阅 关于 Rich Edit 控件。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|