CRichEditCtrl::StreamIn

Artigo
08/25/2010

Substitui texto neste CRichEditCtrl objeto com 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 de comentários para obter mais informações.
es
EDITSTREAM estrutura especificando o fluxo de entrada.Consulte a seção de comentários para obter mais informações.

Valor de retorno

Número de caracteres lidos do fluxo de entrada.

Comentários

O valor de nFormat deve ser um destes procedimentos:

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

Qualquer um desses valores pode ser combinado com SFF_SELECTION. If SFF_SELECTION for especificado, StreamIn substitui a seleção corrente com o Sumário de fluxo de entrada. Se não for especificado, StreamIn substitui o Sumário inteiro deste CRichEditCtrl objeto.

No EDITSTREAM parâmetro es, especifique 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 EM_STREAMIN mensagem de e EDITSTREAM estrutura o 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);