CRichEditCtrl::StreamIn

Статья
06/10/2015

Заменяет текст в этом объекте CRichEditCtrl с текстом из указанного входного потока.

long StreamIn( 
   int nFormat, 
   EDITSTREAM& es  
);

Параметры

nFormat
Флаги, указывающие хранение данных ввода. Дополнительные сведения см. в разделе "Примечания".
es
Структура EDITSTREAM, определяющий входной поток. Дополнительные сведения см. в разделе "Примечания".

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

Количество символов, считанных из входного потока.

Заметки

Значение nFormat должно быть одним из следующих:

SF_TEXT отображает текст чтения.
SF_RTF отображает текст и форматирование чтения.

Одно из этих значений могут быть объединены с SFF_SELECTION. Если SFF_SELECTION указан, то StreamIn заменяет текущее выделение с содержимым входного потока. Если не указано, то StreamIn заменяет все содержимое данного объекта CRichEditCtrl.

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

Дополнительные сведения см. в разделе сообщение EM_STREAMIN и структуру EDITSTREAM в Windows SDK.

Пример

// My callback procedure that reads the rich edit control contents 
// from a file. 
static DWORD CALLBACK 
MyStreamInCallback(DWORD dwCookie, LPBYTE pbBuff, LONG cb, LONG *pcb)
{
   CFile* pFile = (CFile*) dwCookie;

   *pcb = pFile->Read(pbBuff, cb);

   return 0;
}

// The example code. 

// The file from which to load the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_InFile.rtf"), CFile::modeRead);
EDITSTREAM es;

es.dwCookie = (DWORD) &cFile;
es.pfnCallback = MyStreamInCallback; 
m_myRichEditCtrl.StreamIn(SF_RTF, es);