EM_LIMITTEXT сообщение

Задает ограничение текста для элемента управления редактированием. Ограничение текста — это максимальный объем текста в TCHAR, который пользователь может ввести в элементе управления "Редактирование". Это сообщение можно отправить как в элемент управления редактированием, так и в элемент управления с расширенными возможностями.

Для элементов управления редактированием и Microsoft Rich Edit 1.0 используются байты. Для Microsoft Rich Edit 2.0 и более поздних версий используются символы.

Параметры

wParam

Максимальное число TCHAR, которые может ввести пользователь. Для текста ANSI это число байтов; для текста в Юникоде — это количество символов. Это число не включает завершающий символ NULL.

Элементы управления расширенными возможностями редактирования: Если этот параметр равен нулю, длина текста будет равна 64 000 символов.

Если этот параметр равен нулю, длина текста устанавливается в 0x7FFFFFFE символов для однострочных элементов управления редактированием или -1 для многострочных элементов управления редактированием.

lParam

Этот параметр не используется.

Возвращаемое значение

Это сообщение не возвращает значение.

Комментарии

Сообщение EM_LIMITTEXT ограничивает только текст, который пользователь может ввести. Он не влияет на текст, уже существующий в элементе управления редактированием при отправке сообщения, а также не влияет на длину текста, скопированного в элемент управления редактирования WM_SETTEXT сообщением. Если приложение использует сообщение WM_SETTEXT для размещения в элементе управления редактированием большего количества текста, чем указано в EM_LIMITTEXT сообщении, пользователь может изменить все содержимое элемента управления редактированием.

До вызова EM_LIMITTEXT по умолчанию ограничение на количество текста, которое пользователь может ввести в элементе управления редактированием, составляет 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_EXLIMITTEXT

Edit_LimitText

Другие ресурсы

WM_SETTEXT