EM_STREAMOUT сообщение

  • Статья

Приводит к тому, что элемент управления полнофункционалированным редактированием передает свое содержимое в определенную приложением функцию обратного вызова EditStreamCallback . Затем функция обратного вызова может записать поток данных в файл или любое другое выбранное расположение.

Параметры

wParam

Задает формат данных и параметры замены.

Это значение должно быть одним из следующих значений.

Значение Значение
SF_RTF
 RTF.
SF_RTFNOOBJS
 ФОРМАТ RTF с пробелами вместо COM-объектов.
SF_TEXT
 Текст с пробелами вместо COM-объектов.
SF_TEXTIZED
 Текст с текстовым представлением COM-объектов.

Параметр SF_RTFNOOBJS удобен, если приложение хранит сами COM-объекты, так как RTF-представление COM-объектов не очень компактное. Управляющее слово \objattph, за которым следует пробел, обозначает положение объекта.

Кроме того, можно указать следующие флаги.

Значение Значение
SFF_PLAINRTF
 Если этот параметр указан, элемент управления полнофункционированным редактированием передает поток только ключевые слова, общие для всех языков, игнорируя ключевые слова, относящиеся к конкретному языку. Если не указано, элемент управления "Полнофункционированные изменения" выполняет потоковую передачу всех ключевых слов. Этот флаг можно объединить с флагом SF_RTF или SF_RTFNOOBJS .
SFF_SELECTION
 Если он указан, элемент управления полнофункционированным редактированием выполняет потоковую передачу только содержимого текущего выделенного фрагмента. Если этот параметр не указан, элемент управления выполняет потоковую передачу всего содержимого. Этот флаг можно объединить с любым из значений формата данных.
SF_UNICODE
 Microsoft Rich Edit 2.0 и более поздних версий: Указывает текст в Юникоде. Этот флаг можно объединить с флагом SF_TEXT .
SF_USECODEPAGE
 Rich Edit 3.0 и более поздних версий: Создает формат RTF и текст в формате UTF-8, используя другие кодовые страницы. Кодовая страница задается в высоком слове wParam. Например, для UTF-8 RTF задайте для wParam значение (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF.

lParam

Указатель на структуру EDITSTREAM . На входных данных член pfnCallback этой структуры должен указывать на определяемую приложением функцию EditStreamCallback . В выходных данных член dwError может содержать ненулевой код ошибки, если произошла ошибка.

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

Это сообщение возвращает количество символов, записанных в поток данных.

Комментарии

При отправке сообщения EM_STREAMOUT элемент управления полнофункционалированным редактированием выполняет повторяющиеся вызовы функции EditStreamCallback , указанной элементом pfnCallback структуры EDITSTREAM . При каждом вызове функции обратного вызова элемент управления передает буфер, содержащий часть содержимого элемента управления. Этот процесс продолжается до тех пор, пока элемент управления не перешлет все свое содержимое в функцию обратного вызова или пока не возникнет ошибка.

Требования

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

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

Справочные материалы

EDITSTREAM

EditStreamCallback

EM_STREAMIN