CRichEditCtrl::StreamIn

Artykuł
02/27/2013

Zastępuje tekst w tym CRichEditCtrl obiekt z tekstem od określonego strumienia wejściowego.

long StreamIn(
   int nFormat,
   EDITSTREAM& es 
);

Parametry

nFormat
Flagi określające formaty danych wejściowych.Aby uzyskać więcej informacji w sekcji Uwagi.
es
EDITSTREAM Struktura określająca strumienia wejściowego.Aby uzyskać więcej informacji w sekcji Uwagi.

Wartość zwracana

Liczba znaków odczytu ze strumienia wejściowego.

Uwagi

Wartość nFormat musi być jedną z następujących czynności:

SF_TEXTWskazuje tylko czytania tekstu.
SF_RTFWskazuje czytania tekstu i formatowania.

Albo wartości te można łączyć z SFF_SELECTION.Jeśli SFF_SELECTION jest określony, StreamIn zastępuje zawartość strumienia wejściowego bieżącego zaznaczenia.Jeśli nie jest określony, StreamIn zastępuje całą zawartość CRichEditCtrl obiektu.

W EDITSTREAM parametr es, określ funkcji wywołania zwrotnego, która wypełnia bufor tekstu.Ta funkcja wywołania zwrotnego jest wywoływany cyklicznie, aż do wyczerpania strumienia wejściowego.

Aby uzyskać więcej informacji, zobacz EM_STREAMIN wiadomości i EDITSTREAM struktury w Windows SDK.

Przykład

// 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);