CRichEditCtrl::StreamIn

Artigo
06/10/2015

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