EditStreamCallback

Функция EditStreamCallback является приложением функция обратного вызова используется с EM_STREAMIN и EM_STREAMOUT сообщений. Он используется для передачи потока данных в или из элемента управления rich edit. Тип EDITSTREAMCALLBACK определяет указатель на эту функцию обратного вызова. EditStreamCallback — это имя функции, определяемые приложением.

() DWORD обратного ВЫЗОВА EditStreamCallback DWORD  dwCookie, / / определенное приложением значениеLPBYTEpbBuff, / / указатель на буферДЛИННЫЕ cb, / / число байтов для чтения или записиДЛИННЫЕ* pcb / / указатель на количество байтов, переданных);
 

Параметры

dwCookie

Указывает значение dwCookie член EDITSTREAM структуры. В приложении указано это значение, когда он посылает сообщение EM_STREAMIN или EM_STREAMOUT.

pbBuff

Указатель на буфер для чтения или записи в. Для операции в поток (чтение) функция обратного вызова заполняет этот буфер данных для передачи в элемент управления rich edit. Для потока выход (запись) операции буфер содержит данные из элемента управления, функция обратного вызова записывает некоторые хранения.

cb

Указывает число байтов для чтения или записи.

пхд

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

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

Функция обратного вызова возвращает нулевое значение для обозначения успешного.

Функция обратного вызова возвращает ненулевое значение для обозначения ошибки. Если произошла ошибка, чтения или завершается операция записи и богатые редактировать контроля выброса любых данных в буфере pbBuff . Если функция обратного вызова возвращает ненулевое значение, элемент управления rich edit использует dwError член EDITSTREAM структуры для передачи значения в приложение.

Примечания

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

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

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

• Функция обратного вызова возвращает ненулевое значение.
• Функция обратного вызова возвращает ноль в * параметр ПХД.
• Значение, возвращаемое в * ПХД параметр меньше количество байтов в параметре cb.
• Произошла ошибка, препятствующая передачи данных или из самого элемента управления rich edit. Примерами являются-памяти ситуаций, отказ системной функции, или буфер чтения содержит недопустимый символ.
• Для операции в поток RTF код содержит данные, указав в конец блока RTF.
• Для потока в операции на элементе управления редактирования одной линии обратного вызова читает в CRLF.

QuickInfo

nbsp; Windows &NT: требует 3.51 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в richedit.h.
Импорта библиотеки:Определяемые пользователем.

Родственные слова

Обзор элементов управления Rich Edit, функции обратного вызова Rich Edit, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index