CRichEditCtrl::StreamOut

Artículo
02/19/2013

Coloca el contenido de este objeto de CRichEditCtrl en el flujo de salida especificada.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Parámetros

nFormat
Marcas que especifican los formatos de datos de salida.Vea la sección Comentarios para obtener más información.
es
Estructura deEDITSTREAM que especifica el flujo de salida.Vea la sección Comentarios para obtener más información.

Valor devuelto

Número de caracteres escritos en el flujo de salida.

Comentarios

El valor de nFormat debe ser uno de los siguientes:

Texto deSF_TEXT Indica únicamente.
Texto y formato deSF_RTF Indica.
Texto y formato deSF_RTFNOOBJS Indica, reemplazando elementos de OLE con espacios.
Texto y formato deSF_TEXTIZED Indica, con representaciones textual de elementos de OLE.

Estos valores se pueden combinar con SFF_SELECTION.Si se especifica SFF_SELECTION , StreamOut coloca la selección de tipo actual en el flujo de salida.Si no se especifica, StreamOut coloca el contenido de tipo completo de este objeto de CRichEditCtrl .

En el parámetro esde EDITSTREAM , especifica una función de devolución de llamada que rellena un búfer con el texto.Esta función de devolución de llamada se llama repetidamente, hasta que se agote el flujo de salida.

Para obtener más información, vea el mensaje de EM_STREAMOUT y la estructura de EDITSTREAM en Windows SDK.

Ejemplo

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