сообщение EM_STREAMOUT

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

Parameters

wParam

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

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

Ценность	Значение
SF_RTF	RTF.
SF_RTFNOOBJS	RTF с пробелами вместо COM-объектов.
SF_TEXT	Текст с пробелами вместо COM-объектов.
SF_TEXTIZED	Текст с текстовым представлением com-объектов.

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

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

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

lParam

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

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

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

Remarks

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

Требования

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

См. также

Ссылки

EDITSTREAM

EditStreamCallback

EM_STREAMIN