сообщение EM_SETLIMITTEXT
Задает ограничение текста для элемента управления редактированием. Ограничение текста — это максимальный объем текста в TCHAR, который пользователь может ввести в элементе управления "Редактирование". Это сообщение можно отправить как в элемент управления редактированием, так и в элемент управления с расширенными возможностями.
Для элементов управления редактированием и Microsoft Rich Edit 1.0 используются байты. Для Microsoft Rich Edit 2.0 и более поздних версий используются символы.
Сообщение EM_SETLIMITTEXT идентично сообщению EM_LIMITTEXT .
Параметры
-
wParam
-
Максимальное число TCHAR, которые может ввести пользователь. Для текста ANSI это число байтов; для текста в Юникоде — это количество символов. Это число не включает завершающий символ 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 [только классические приложения] |
| Заголовок |
|