Freigeben über


CRichEditCtrl::StreamOut

Schreibt den Inhalt dieses Objekts mit dem angegebenen CRichEditCtrl Ausgabestream aus.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Parameter

  • nFormat
    Flags, die die Ausgabedatenformate angeben.Weitere Informationen finden Sie im Abschnitt Hinweise.

  • es
    EDITSTREAM-Struktur, die den Ausgabestream angibt.Weitere Informationen finden Sie im Abschnitt Hinweise.

Rückgabewert

Anzahl von Zeichen in den Ausgabestream geschrieben.

Hinweise

Der Wert von nFormat muss einer der folgenden Werte sein:

  • SF_TEXT gibt nur Schreibentext an.

  • SF_RTF gibt Schreibentext und die Formatierung des Datenfelds an.

  • SF_RTFNOOBJS gibt den Schreibentext und die Formatierung des Datenfelds an und ersetzt OLE-Elemente mit Leerzeichen.

  • SF_TEXTIZED gibt Schreibentext und die Formatierung des Datenfelds, mit Textdarstellungen von OLE-Elementen an.

Alle Werte können mit SFF_SELECTION kombiniert werden.Wenn SFF_SELECTION angegeben wird, StreamOut schreibt die aktuelle Auswahl in den Ausgabestream aus.Wenn nicht angegeben wird, schreibt StreamOut den gesamten Inhalt dieses CRichEditCtrl-Objekts aus.

Im EDITSTREAM-Parameter es, geben Sie eine Rückruffunktion an, die einen Puffer mit Text ausfüllt.Diese Rückruffunktion wird wiederholt aufgerufen, bis der Ausgabestream erschöpft ist.

Weitere Informationen finden Sie unter EM_STREAMOUT Meldung und EDITSTREAM-Struktur in Windows SDK.

Beispiel

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

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CRichEditCtrl-Klasse

Hierarchien-Diagramm

CRichEditCtrl::StreamIn