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


сообщение 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