Расширенные изменения

  • Статья

В этом разделе содержатся сведения о элементах программирования, используемых с расширенными элементами управления редактированием. Элемент управления расширенными изменениями позволяет пользователю вводить, изменять, печатать и сохранять текст. Текст можно назначить символьным и абзацным форматированием и включать внедренные объекты объектной модели компонентов (COM).

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

Общие сведения

Раздел Содержимое
Сведения о элементах управления расширенными изменениями В этом разделе представлены элементы управления расширенными изменениями.
Использование элементов управления расширенными изменениями В этом разделе содержатся разделы, демонстрирующие создание и использование элементов управления расширенными изменениями.

Функции

Раздел Содержимое
AutoCorrectProc Функция AutoCorrectProc — это определяемая приложением функция обратного вызова, используемая с сообщением EM_SETAUTOCORRECTPROC.
EditStreamCallback Функция EditStreamCallback — это определяемая приложением функция обратного вызова, используемая с EM_STREAMIN и EM_STREAMOUT сообщениями. Он используется для передачи потока данных в элемент управления расширенными изменениями или из него.
EditWordBreakProcEx Функция EditWordBreakProcEx — это определяемая приложением функция обратного вызова, используемая с сообщением EM_SETWORDBREAKPROCEX. Он определяет индекс символов разрыва слова или класс символов и флаги разбиения слов символов в указанном тексте.
ДефисироватьProc Функция HyphenateProc — это определяемая приложением функция обратного вызова, используемая с сообщением EM_SETHYPHENATEINFO. Он определяет, как выполняется дефисирование в элементе управления Microsoft Rich Edit.

Интерфейсы

Раздел Содержимое
IRichEditOle Интерфейс IRichEditOle предоставляет функции COM полнофункционированного элемента управления редактирования. Интерфейс можно получить, отправив сообщение EM_GETOLEINTERFACE .
IRichEditOleCallback Интерфейс IRichEditOleCallback используется элементом управления редактирования форматированного текста для получения сведений, связанных с OLE, из своего клиента. Клиент управления с расширенными возможностями правки отвечает за реализацию этого интерфейса и назначение его элементу управления с помощью сообщения EM_SETOLECALLBACK .

Сообщения

Раздел Содержимое
EM_AUTOURLDETECT Включает или отключает автоматическое обнаружение URL-адресов с помощью элемента управления расширенными изменениями.
EM_CANPASTE Определяет, может ли элемент управления расширенными изменениями вставить указанный формат буфера обмена.
EM_CANREDO Определяет, существуют ли действия в очереди повтора элемента управления.
EM_DISPLAYBAND Отображает часть содержимого элемента управления расширенными изменениями, как ранее отформатировано для устройства с помощью сообщения EM_FORMATRANGE.
EM_EXGETSEL Извлекает начальные и конечные позиции выделенного фрагмента в элементе управления расширенными изменениями.
EM_EXLIMITTEXT Задает верхний предел количества текста, который пользователь может ввести или вставить в элемент управления расширенными изменениями.
EM_EXLINEFROMCHAR Определяет, какая строка содержит указанный символ в элементе управления расширенными изменениями.
EM_EXSETSEL Выбирает диапазон символов или COM-объектов в элементе управления Rich Edit.
EM_FINDTEXT Находит текст в элементе управления расширенными изменениями.
EM_FINDTEXTEX Находит текст в элементе управления расширенными изменениями.
EM_FINDTEXTEXW Находит текст Юникода в элементе управления расширенными изменениями.
EM_FINDTEXTW Находит текст Юникода в элементе управления расширенными изменениями.
EM_FINDWORDBREAK Находит следующий разрыв слова до или после указанной позиции символа или извлекает сведения о символе в этой позиции.
EM_FORMATRANGE Форматирует диапазон текста в элементе управления расширенными изменениями для определенного устройства.
EM_GETAUTOURLDETECT Указывает, включена ли функция автоматического обнаружения URL-адресов в элементе управления расширенными изменениями.
EM_GEТБ IDIOPTIONS Указывает текущее состояние двунаправленных параметров в элементе управления расширенными изменениями.
EM_GETCHARFORMAT Определяет форматирование символов в элементе управления расширенными изменениями.
EM_GETCTFMODEBIAS Возвращает значения предвзятости в режиме text Services Framework (TSF) для элемента управления Rich Edit.
EM_GETCTFOPENSTATUS Определяет, открыта ли или закрыта клавиатура TSF.
EM_GETEDITSTYLE Извлекает текущие флаги стиля редактирования.
EM_GETEVENTMASK Извлекает маску событий для элемента управления расширенными изменениями. Маска события указывает, какие коды уведомлений элемент управления отправляет в родительское окно.
EM_GETHYPHENATEINFO Получает сведения о дефисации элемента управления Rich Edit.
EM_GETIMECOLOR Извлекает цвет композиции редактора методов ввода (IME). Это сообщение доступно только в азиатских версиях операционной системы.
EM_GETIMECOMPMODE Возвращает текущий режим IME для элемента управления расширенными изменениями.
EM_GETIMECOMPTEXT Возвращает текст композиции IME.
EM_GETIMEMODEBIAS Получает предвзятость режима IME для элемента управления Rich Edit.
EM_GETIMEOPTIONS Извлекает текущие параметры IME. Это сообщение доступно только в азиатских версиях операционной системы.
EM_GETIMEPROPERTY Возвращает свойство и возможности IME, связанного с текущим языковым стандартом ввода.
EM_GETLANGOPTIONS Получает параметры параметра элемента управления с расширенными возможностями редактирования для поддержки IME и азиатского языка.
EM_GETOLEINTERFACE Извлекает объект IRichEditOle , который клиент может использовать для доступа к функциям COM элемента управления с расширенными возможностями редактирования.
EM_GETOPTIONS Извлекает расширенные параметры управления редактированием.
EM_GETPAGEROTATE Устарело. Возвращает текстовый макет для элемента управления Rich Edit.
EM_GETPARAFORMAT Извлекает форматирование абзаца текущего выделенного фрагмента в элементе управления расширенными изменениями.
EM_GETPUNCTUATION Возвращает текущие знаки препинания для элемента управления расширенными изменениями. Это сообщение доступно только в азиатских версиях операционной системы.
EM_GETREDONAME Извлекает тип следующего действия, если таковой есть, в очереди повторного редактирования элемента управления с расширенными возможностями.
EM_GETSCROLLPOS Получает текущую позицию прокрутки элемента управления редактирования.
EM_GETSELTEXT Извлекает выделенный в данный момент текст в элементе управления расширенными изменениями.
EM_GETTEXTEX Возвращает весь текст из элемента управления расширенными изменениями в любой нужной базе кода.
EM_GETTEXTLENGTHEX Вычисляет длину текста различными способами. Обычно он вызывается перед созданием буфера для получения текста из элемента управления.
EM_GETTEXTMODE Возвращает текущий текстовый режим и отменяет уровень элемента управления расширенными изменениями.
EM_GETTEXTRANGE Извлекает указанный диапазон символов из элемента управления расширенными изменениями.
EM_GETTYPOGRAPHYOPTIONS Извлекает текущее состояние параметров типографии элемента управления расширенными изменениями.
EM_GETUNDONAME Microsoft Rich Edit 2.0 и более поздних версий: извлекает тип следующего действия отмены, если таковой есть.
Microsoft Rich Edit 1.0: это сообщение не поддерживается.
EM_GETWORDBREAKPROCEX Извлекает адрес зарегистрированной в настоящее время расширенной процедуры разбиения слов.
EM_GETWORDWRAPMODE Возвращает текущие параметры упаковки слов и разбиения слов для элемента управления расширенными изменениями. Это сообщение доступно только в азиатских версиях операционной системы.
EM_GETZOOM Получает текущее соотношение масштаба, которое всегда составляет от 1/64 до 64.
EM_HIDESELECTION Скрытие или отображение выделения в элементе управления расширенными изменениями.
EM_ISIME Определяет, является ли текущий языковой стандарт входных данных языковым стандартом Восточной Азии.
EM_PASTESPECIAL Вставляет определенный формат буфера обмена в элемент управления расширенными изменениями.
EM_RECONVERSION Вызывает диалоговое окно рековерверсии IME.
EM_REDO Переопределяет следующее действие в очереди повторного входа элемента управления.
EM_REQUESTRESIZE Принудительно отправляет элемент управления расширенными изменениями для отправки кода уведомления EN_REQUESTRESIZE в родительское окно.
EM_SELECTIONTYPE Определяет тип выбора для элемента управления расширенными изменениями.
EM_SEТБ IDIOPTIONS Задает текущее состояние двунаправленных параметров в элементе управления расширенными изменениями.
EM_SEТБ KGNDCOLOR Задает цвет фона для элемента управления расширенными изменениями.
EM_SETCHARFORMAT Задает форматирование символов в элементе управления расширенными изменениями.
EM_SETCTFMODEBIAS Задайте предвзятость режима TSF для элемента управления Rich Edit.
EM_SETCTFOPENSTATUS Открывает или закрывает клавиатуру TSF.
EM_SETEDITSTYLE Задает текущие флаги стиля редактирования.
EM_SETEVENTMASK Задает маску событий для элемента управления расширенными изменениями. Маска события указывает, какие коды уведомлений элемент управления отправляет в родительское окно.
EM_SETFONTSIZE Задает размер шрифта для выделенного текста.
EM_SETHYPHENATEINFO Задает способ, который элемент управления Rich Edit выполняет дефисацию.
EM_SETIMECOLOR Задает цвет композиции IME. Это сообщение доступно только в азиатских версиях операционной системы.
EM_SETIMEMODEBIAS Задает предвзятость режима IME для элемента управления Rich Edit.
EM_SETIMEOPTIONS Задает параметры IME. Это сообщение доступно только в азиатских версиях операционной системы.
EM_SETLANGOPTIONS Задает параметры поддержки IME и азиатского языка в элементе управления расширенными изменениями.
EM_SETOLECALLBACK Предоставляет расширенный элемент управления редактированием объект IRichEditOleCallback , который используется элементом управления для получения ресурсов и сведений, связанных с OLE, от клиента.
EM_SETOPTIONS Задает параметры для элемента управления расширенными изменениями.
EM_SETPAGEROTATE Устарело. Задает текстовый макет элемента управления Rich Edit.
EM_SETPALETTE Изменяет палитру, которая использует расширенные изменения для его окна отображения.
EM_SETPARAFORMAT Задает форматирование абзаца для текущего выбора в элементе управления расширенными изменениями.
EM_SETPUNCTUATION Задает знаки препинания для элемента управления расширенными изменениями. Это сообщение доступно только в азиатских версиях операционной системы.
EM_SETSCROLLPOS Указывает элементу управления полного редактирования прокручиваться до определенной точки.
EM_SETTARGETDEVICE Задает целевое устройство и ширину линии, используемую для форматирования "то, что вы видите" (WYSIWYG) в элементе управления расширенными изменениями.
EM_SETTEXTEX Объединяет функциональные возможности WM_SETTEXT и EM_REPLACESEL и добавляет возможность задать текст с помощью кодовой страницы и использовать форматированный текст или обычный текст.
EM_SETTEXTMODE Задает текстовый режим или отменить уровень элемента управления расширенными изменениями. Сообщение завершается ошибкой, если элемент управления содержит любой текст.
EM_SETTYPOGRAPHYOPTIONS Задает текущее состояние параметров типографии элемента управления расширенными изменениями.
EM_SETUNDOLIMIT Задает максимальное количество действий, которые могут храниться в очереди отмены.
EM_SETWORDBREAKPROCEX Задает расширенную процедуру разбиения слов.
EM_SETWORDWRAPMODE Задает параметры упаковки и разбиения слов для элемента управления расширенными изменениями. Это сообщение доступно только в азиатских версиях операционной системы.
EM_SETZOOM Задает коэффициент масштабирования в любом месте от 1/64 до 64.
EM_SHOWSCROLLBAR Отображает или скрывает одну из полос прокрутки в окне текстового узла.
EM_STOPGROUPTYPING Запрещает элементу управления собирать дополнительные действия ввода в текущее действие отмены. В элементе управления сохраняется следующее действие ввода (если таковые есть) в новое действие в очереди отмены.
EM_STREAMIN Заменяет содержимое элемента управления расширенными изменениями потоком данных, предоставляемым приложением, определяемой функцией обратного вызова EditStreamCallback .
EM_STREAMOUT Приводит к тому, что элемент управления расширенными изменениями передает содержимое в приложение, определяемую функцией обратного вызова EditStreamCallback . Затем функция обратного вызова может записывать поток данных в файл или любое другое расположение, которое он выбирает.

Notifications

Раздел Содержимое
EN_ALIGNLTR Уведомляет родительское окно элемента управления с расширенными изменениями о том, что направление абзаца изменилось слева направо. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_COMMAND.
EN_ALIGNRTL Уведомляет родительское окно элемента управления с расширенными изменениями о том, что направление абзаца изменилось справа налево. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_COMMAND.
EN_CORRECTTEXT Уведомляет родительское окно элемента управления с расширенными изменениями о том, что произошел жест SYV_CORRECT, что дает родительскому окну возможность отменить исправление текста. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_DRAGDROPDONE Уведомляет родительское окно элемента управления с расширенными изменениями о завершении операции перетаскивания. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_DROPFILES Уведомляет родительское окно элемента управления с расширенными изменениями о попытке пользователя удалить файлы в элемент управления. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY при получении сообщения WM_DROPFILES.
EN_IMECHANGE Уведомляет родительский элемент управления с расширенными изменениями о том, что состояние преобразования IME изменилось. Это сообщение доступно только для версий операционной системы на азиатском языке. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_COMMAND.
EN_LINK Уведомляет родительское окно элемента управления с расширенными изменениями, когда пользователь щелкает мышь или когда указатель мыши находится на тексте с CFE_LINK эффектом. Родительское окно элемента управления получает этот код уведомления через сообщение WM_NOTIFY.
EN_LOWFIRTF Уведомляет родительское окно элемента управления rich edit элемента управления Rich Edit о том, что был получен неподдерживаемый формат форматированного текста (RTF) ключевое слово. Элемент управления Rich Edit отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_MSGFILTER Уведомляет родительское окно элемента управления с расширенным изменением события клавиатуры или мыши в элементе управления. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_OBJECTPOSITIONS Уведомляет родительское окно элемента управления с расширенными изменениями при чтении элемента управления в объектах. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_OLEOPFAILED Уведомляет родительское окно элемента управления с расширенными изменениями о сбое действия пользователя в объекте COM. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_PROTECTED Уведомляет родительское окно элемента управления с расширенными изменениями о том, что пользователь принимает действие, которое изменит защищенный диапазон текста. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_REQUESTRESIZE Уведомляет родительское окно элемента управления о том, что содержимое элемента управления меньше или больше размера окна элемента управления. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_SAVECпакет интерфейса пользователя BOARD Уведомляет родительское окно элемента управления с расширенными изменениями о закрытии элемента управления, а буфер обмена содержит сведения. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_SELCHANGE Уведомляет родительское окно элемента управления с расширенными изменениями о том, что текущий выбор изменен. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.
EN_STOPNOUNDO Уведомляет родительское окно элемента управления с расширенными изменениями о том, что произошло действие, для которого элемент управления не может выделить достаточно памяти для поддержания состояния отмены. Элемент управления расширенными изменениями отправляет этот код уведомления в виде сообщения WM_NOTIFY.

Структуры

Раздел Содержимое
BIDIOPTIONS Содержит двунаправленные сведения о расширенном элементе управления редактированием. Эта структура используется сообщениями EM_GEТБ IDIOPTIONS и EM_SEТБ IDIOPTIONS для получения и задания двунаправленной информации для элемента управления.
CHARFORMAT Содержит сведения о форматировании символов в элементе управления расширенными изменениями.
CHARFORMAT2 Содержит сведения о форматировании символов в элементе управления расширенными изменениями. CHARFORMAT2 — это расширение Microsoft Rich Edit 2.0 структуры CHARFORMAT. Microsoft Rich Edit 2.0 позволяет использовать любую структуру с EM_GETCHARFORMAT и EM_SETCHARFORMAT сообщениями.
CHARRANGE Задает диапазон символов в элементе управления расширенными изменениями.
COMPCOLOR Содержит параметры цвета для строки композиции.
EDITSTREAM Содержит сведения, которые приложение передает в элемент управления расширенными изменениями в сообщении EM_STREAMIN или EM_STREAMOUT. Элемент управления расширенными изменениями использует сведения для передачи потока данных в элемент управления или из него.
ENCORRECTTEXT Содержит сведения о исправлении выделенного текста.
ENDROPFILES Содержит сведения, связанные с кодом уведомления EN_DROPFILES. Элемент управления расширенными изменениями отправляет этот код уведомления при получении сообщения WM_DROPFILES .
ENLINK Содержит сведения о коде уведомлений EN_LINK из элемента управления расширенными изменениями.
ENLOWFIRTF Содержит сведения о неподдерживаемой ключевое слово RTF в элементе управления Rich Edit.
ENOLEOPFAILED Содержит сведения о неудачной операции.
ENPROTECTED Содержит сведения, связанные с кодом уведомления EN_PROTECTED . Элемент управления расширенными изменениями отправляет это уведомление, когда пользователь пытается изменить защищенный текст.
ENSAVEC пакет интерфейса пользователя BOARD Содержит сведения об объектах и тексте в буфере обмена.
FINDTEXT Содержит сведения об операции поиска в расширенном элементе управления редактированием. Эта структура используется с сообщением EM_FINDTEXT .
FINDTEXTEX Содержит сведения о тексте для поиска в элементе управления расширенными возможностями редактирования. Эта структура используется с сообщением EM_FINDTEXTEX .
FORMATRANGE Содержит сведения, которые элемент управления расширенными изменениями использует для форматирования выходных данных для конкретного устройства. Эта структура используется с сообщением EM_FORMATRANGE .
GETTEXTEX Содержит сведения об операции для получения текста из элемента управления расширенными изменениями. Эта структура передается в wParam в сообщении EM_GETTEXTEX.
GETTEXTLENGTHEX Содержит сведения о том, как следует вычислять длину текста элемента управления расширенными изменениями. Эта структура передается в wParam в сообщении EM_GETTEXTLENGTHEX.
ДЕФИСАТЬINFO Содержит сведения о дефисации в элементе управления Rich Edit.
HYPHRESULT Содержит сведения о результатах дефисации в элементе управления Rich Edit.
IMECOMPTEXT Содержит сведения о тексте композиции в элементе управления Rich Edit.
MSGFILTER Содержит сведения о событии клавиатуры или мыши. Элемент управления расширенными изменениями отправляет эту структуру в родительское окно в рамках кода уведомления EN_MSGFILTER , что позволяет родительскому элементу изменить сообщение или запретить его обработку.
OBJECTPOSITIONS Содержит сведения о положении объекта.
PARAFORMAT Содержит сведения о атрибутах форматирования абзаца в элементе управления расширенными изменениями. Эта структура используется с EM_GETPARAFORMAT и EM_SETPARAFORMAT сообщениями.
PARAFORMAT2 Содержит сведения о атрибутах форматирования абзаца в элементе управления расширенными изменениями.
ЗНАКИ ПРЕПИНАНИЯ Содержит сведения о препинаниях, используемых в элементе управления расширенными изменениями.
REOBJECT Содержит сведения об объекте.
REPASTESPECIAL Содержит сведения, определяющие, должен ли отображаться аспект вставленного объекта на основе содержимого объекта или значка, представляющего объект.
REQRESIZE Содержит запрошенный размер элемента управления расширенными изменениями. Элемент управления расширенными изменениями отправляет эту структуру в родительское окно в рамках кода уведомления EN_REQUESTRESIZE .
SELCHANGE Содержит сведения, связанные с кодом уведомлений EN_SELCHANGE. Элемент управления расширенными изменениями отправляет это уведомление в родительское окно при изменении текущего выбора.
SETTEXTEX Указывает, какая кодовая страница (если есть) используется в параметре текста, заменяет ли текст все текст в элементе управления или просто выделение, а также сохраняется ли состояние отмены.
TEXTRANGE Получает диапазон текста из элемента управления расширенными изменениями. Эта структура заполняется сообщением EM_GETTEXTRANGE . Буфер, на который указывает элемент lpstrText , должен быть достаточно большим, чтобы получить все символы и завершающий символ NULL.

Константы

Раздел Содержимое
Флаги маски событий с расширенными изменениями Маска события указывает, какие коды уведомлений кодирует элемент управления расширенными изменениями, отправляется в родительское окно.
Стили элементов управления "Расширенные изменения" Описывает стили окон, уникальные для элементов управления расширенными возможностями редактирования.