CRichEditCtrl::StreamIn

Articolo
02/19/2013

Sostituire il testo nell'oggetto CRichEditCtrl con testo dal flusso di input specificato.

long StreamIn(
   int nFormat,
   EDITSTREAM& es 
);

Parametri

nFormat
Flag che specificano i formati di dati di input.Per ulteriori informazioni vedere la sezione Osservazioni.
es
Struttura diEDITSTREAM che specifica il flusso di input.Per ulteriori informazioni vedere la sezione Osservazioni.

Valore restituito

Numero di caratteri letti dal flusso di input.

Note

Il valore di nFormat deve essere uno degli elementi seguenti:

SF_TEXT indica il testo di sola lettura.
SF_RTF indica il testo e la formattazione di lettura.

Uno di questi valori possono essere combinati con SFF_SELECTION.Se SFF_SELECTION è specificato, StreamIn sostituisce la selezione corrente con il contenuto del flusso di input.Se non viene specificato, StreamIn sostituisce l'intero contenuto di questo oggetto CRichEditCtrl.

Nel parametro esdi EDITSTREAM, specificare una funzione di callback che riempie un buffer di testo.Questa funzione di callback viene chiamata ripetutamente, fino a esaurirsi il flusso di input.

Per ulteriori informazioni, vedere il messaggio EM_STREAMIN e la struttura EDITSTREAM in Windows SDK.

Esempio

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