CRichEditCtrl::StreamOut

Artykuł
02/27/2013

Zapisuje zawartość to CRichEditCtrl obiekt określony strumień wyjściowy.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Parametry

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

Wartość zwracana

Liczba znaków zapisywane do strumienia wyjściowego.

Uwagi

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

SF_TEXTWskazuje tylko pisanie tekstu.
SF_RTFWskazuje pisania tekstu i formatowania.
SF_RTFNOOBJSWskazuje pisania tekstu i formatowania, zastępując OLE elementy ze spacjami.
SF_TEXTIZEDWskazuje pisania tekstu i formatowania z OLE elementy tekstowe reprezentacje.

Każdą z tych wartości może być łączone z SFF_SELECTION.Jeśli SFF_SELECTION jest określony, StreamOut zapisuje się do bieżącego zaznaczenia do strumienia wyjściowego.Jeśli nie jest określony, StreamOut zapisuje się całą zawartość CRichEditCtrl obiektu.

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

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

Przykład

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

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

   return 0;
}

// The example code.

// The file to store the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_OutFile.rtf"), 
   CFile::modeCreate|CFile::modeWrite);
EDITSTREAM es;

es.dwCookie = (DWORD) &cFile;
es.pfnCallback = MyStreamOutCallback; 
m_myRichEditCtrl.StreamOut(SF_RTF, es);