CRichEditCtrl::StreamIn

Artigo
02/25/2013

Substitui o texto em este objeto de CRichEditCtrl com o texto do fluxo de entrada especificado.

long StreamIn(
   int nFormat,
   EDITSTREAM& es 
);

Parâmetros

nFormat
Sinalizadores que especificam os formatos de dados de entrada.Consulte a seção comentários para mais informações.
es
Estrutura deEDITSTREAM que especifica o fluxo de entrada.Consulte a seção comentários para mais informações.

Valor de retorno

Número de caracteres lidos de fluxo de entrada.

Comentários

O valor de nFormat deve ser um dos seguintes:

SF_TEXT indica o texto de somente leitura.
SF_RTF indica o texto e formatação de leitura.

Qualquer um de esses valores pode ser combinado com SFF_SELECTION.Se SFF_SELECTION for especificado, StreamIn substitui a seleção atual com o conteúdo de fluxo de entrada.Se não for especificado, StreamIn substitui 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 entrada seja esgotado.

Para obter mais informações, consulte a mensagem de EM_STREAMIN e a estrutura de EDITSTREAM em Windows SDK.

Exemplo

// My callback procedure that reads the rich edit control contents
// from a file.
static DWORD CALLBACK 
MyStreamInCallback(DWORD dwCookie, LPBYTE pbBuff, LONG cb, LONG *pcb)
{
   CFile* pFile = (CFile*) dwCookie;

   *pcb = pFile->Read(pbBuff, cb);

   return 0;
}

// The example code.

// The file from which to load the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_InFile.rtf"), CFile::modeRead);
EDITSTREAM es;

es.dwCookie = (DWORD) &cFile;
es.pfnCallback = MyStreamInCallback; 
m_myRichEditCtrl.StreamIn(SF_RTF, es);