CRichEditCtrl::StreamOut

Artigo
08/25/2010

Grava o Sumário deste CRichEditCtrl objeto no fluxo de saída especificado.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Parâmetros

nFormat
Sinalizadores que especificam os formatos de dados de saída.Consulte a seção de comentários para obter mais informações.
es
EDITSTREAM estrutura especificando o fluxo de saída.Consulte a seção de comentários para obter mais informações.

Valor de retorno

Número de caracteres gravada no fluxo de saída.

Comentários

O valor de nFormat deve ser um destes procedimentos:

SF_TEXT Indica somente texto escrito.
SF_RTF Indica a texto de escrita e formatação.
SF_RTFNOOBJS Indica escrever texto e formatação, a substituição de itens OLE com espaços.
SF_TEXTIZED Indica a texto de escrita e formatação, com representações textuais de itens OLE.

Qualquer um desses valores pode ser combinado com SFF_SELECTION. If SFF_SELECTION for especificado, StreamOut grava a seleção corrente no fluxo de saída. Se não for especificado, StreamOut grava todo o Sumário de isso CRichEditCtrl objeto.

No EDITSTREAM parâmetro es, especifique uma função de retorno de chamada que ocupa um buffer com texto. Essa função de retorno de chamada é chamada repetidamente, até que o fluxo de saída seja esgotado.

Para obter mais informações, consulte EM_STREAMOUT mensagem de e EDITSTREAM estrutura o Windows SDK.

Exemplo

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