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 [仅限桌面应用]
标头
Winuser.h (包括 Windows.h)

另请参阅

EM_GETLIMITTEXT