CRichEditCtrl::StreamOut

Articolo
02/19/2013

Scrive il contenuto di questo oggetto CRichEditCtrl il flusso di output specificato.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Parametri

nFormat
Flag che specificano i formati di dati di output.Per ulteriori informazioni vedere la sezione Osservazioni.
es
Struttura diEDITSTREAM che specifica il flusso di output.Per ulteriori informazioni vedere la sezione Osservazioni.

Valore restituito

Numero di caratteri scritto nel flusso di output.

Note

Il valore di nFormat deve essere uno degli elementi seguenti:

SF_TEXT indica il testo di scrittura solo.
SF_RTF indica il testo e la formattazione di scrittura.
SF_RTFNOOBJS indica il testo e la formattazione di scrittura, sostituire gli elementi OLE con spazi.
SF_TEXTIZED indica il testo e la formattazione di scrittura, con rappresentazioni testuali di elementi OLE.

Uno di questi valori possono essere combinate con SFF_SELECTION.Se SFF_SELECTION è specificato, StreamOut scrivere la selezione corrente nel flusso di output.Se non viene specificato, StreamOut scrive l'intero contenuto di questo oggetto CRichEditCtrl.

Nel parametro esdi EDITSTREAM, specificare una funzione di callback che inserisce un buffer di testo.Questa funzione di callback viene chiamata ripetutamente, fino a esaurirsi il flusso di output.

Per ulteriori informazioni, vedere il messaggio EM_STREAMOUT e la struttura EDITSTREAM in Windows SDK.

Esempio

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