Поделиться через


EM_SETTEXTMODE сообщение

Задает текстовый режим или уровень отмены элемента управления расширенным редактированием. Сообщение завершается ошибкой, если элемент управления содержит какой-либо текст.

Параметры

wParam

Одно или несколько значений из типа перечисления TEXTMODE . Значения задают новые параметры для текстового режима элемента управления и параметры уровня отмены.

Укажите одно из следующих значений, чтобы задать параметр текстового режима. Если не указать значение текстового режима, текстовый режим остается в текущем параметре.

Значение Значение
TM_PLAINTEXT Указывает режим обычного текста, в котором элемент управления аналогичен стандартному элементу управления редактирования. Дополнительные сведения о режиме обычного текста см. в следующем разделе Примечаний.
TM_RICHTEXT Указывает режим форматированного текста, в котором элемент управления имеет стандартные функции расширенного редактирования. Режим форматированного текста является параметром по умолчанию.

Укажите одно из следующих значений, чтобы задать параметр уровня отмены. Если не указать значение уровня отмены, уровень отмены останется в текущем параметре.

Значение Значение
TM_SINGLELEVELUNDO Элемент управления позволяет пользователю отменить только последнее действие, которое можно отменить.
TM_MULTILEVELUNDO Элемент управления поддерживает несколько операций отмены. Это параметр по умолчанию. Используйте сообщение EM_SETUNDOLIMIT , чтобы задать максимальное количество действий отмены.

Укажите одно из следующих значений, чтобы задать параметр кодовой страницы. Если не указать значение кодовой страницы, кодовая страница останется в текущем параметре.

Значение Значение
TM_SINGLECODEPAGE Элемент управления допускает только английскую клавиатуру и клавиатуру, соответствующую набору символов по умолчанию. Например, можно использовать греческий и английский языки. Обратите внимание, что это не позволяет вводить текст в Юникоде в элемент управления . Например, используйте это значение, если элемент управления Rich Edit должен быть ограничен текстом ANSI.
TM_MULTICODEPAGE Элемент управления позволяет использовать несколько кодовой страницы и текст Юникода в элементе управления . Это параметр по умолчанию.

lParam

Этот параметр не используется; значение должно быть равно нулю.

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

Если сообщение выполнено успешно, возвращаемое значение равно нулю.

Если сообщение завершается ошибкой, возвращается ненулевое значение.

Комментарии

В режиме форматированного текста элемент управления расширенным редактированием имеет стандартные функции расширенного редактирования. Однако в режиме обычного текста элемент управления аналогичен стандартному элементу управления редактирования:

  • Текст в элементе управления обычным текстом может иметь только один формат (например, Полужирный, 10pt Arial).
  • Пользователь не может вставить форматы форматированного текста, например RTF или внедренные объекты, в элемент управления обычным текстом.
  • Элементы управления в режиме форматированного текста всегда имеют маркер конца документа или возврат каретки по умолчанию для форматирования абзацев. Элементы управления обычным текстом, с другой стороны, не нуждаются в маркере конца документа по умолчанию, поэтому он опущен.

Элемент управления не должен содержать текста при получении сообщения EM_SETTEXTMODE . Чтобы убедиться, что текст отсутствует, отправьте WM_SETTEXT сообщение с пустой строкой ("").

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Заголовок
Richedit.h

См. также раздел

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT