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 . При каждом вызове функции обратного вызова элемент управления передает буфер, содержащий часть содержимого элемента управления. Этот процесс продолжается до тех пор, пока элемент управления не перешлет все свое содержимое в функцию обратного вызова или пока не возникнет ошибка.

Требования

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

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

EDITSTREAM

EditStreamCallback

EM_STREAMIN