CRichEditCtrl::StreamOut

Artigo
02/25/2013

Grava para fora que o conteúdo de esse CRichEditCtrl objeto para o 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 comentários para mais informações.
es
Estrutura deEDITSTREAM que especifica o fluxo de saída.Consulte a seção comentários para mais informações.

Valor de retorno

Número de caracteres gravado para o fluxo de saída.

Comentários

O valor de nFormat deve ser um dos seguintes:

SF_TEXT indica o texto somente de escrita.
SF_RTF indica o texto e formatação de escrita.
SF_RTFNOOBJS indica o texto e formatação de escrita, substituindo itens VELHOS com espaços.
SF_TEXTIZED indica o texto e formatação de escrita, com as representações textual de itens VELHOS.

Qualquer um de esses valores podem ser combinados com SFF_SELECTION.Se SFF_SELECTION for especificado, StreamOut grava a seleção atual no fluxo de saída.Se não for especificado, StreamOut grava todo o conteúdo de esse objeto de CRichEditCtrl .

Em o parâmetro esde EDITSTREAM , você especifica uma função de retorno de chamada que preenche um buffer com texto.Essa função de retorno de chamada é chamada repetidamente, até que o fluxo de saída é esgotado.

Para obter mais informações, consulte a mensagem de EM_STREAMOUT e a estrutura de EDITSTREAM em 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);