CRichEditCtrl::StreamIn

Article
06/10/2015

Remplace le texte de cet objet d' CRichEditCtrl par le texte du flux d'entrée spécifié.

long StreamIn( 
   int nFormat, 
   EDITSTREAM& es  
);

Paramètres

nFormat
Indicateurs spécifiant les formats de données d'entrée. Pour plus d'informations, consultez la section Notes.
es
Structure d'EDITSTREAM spécifiant le flux d'entrée. Pour plus d'informations, consultez la section Notes.

Valeur de retour

Nombre de caractères lus du flux d'entrée.

Notes

La valeur de nFormat doit être l'une des suivantes :

SF_TEXT indique le texte en lecture seule.
SF_RTF indique le texte et la mise en forme de lecture.

L'un ou l'autre de ces valeurs peut être combiné avec SFF_SELECTION. Si SFF_SELECTION est spécifié, StreamIn remplace la sélection actuelle par le contenu du flux d'entrée. S'il n'est pas spécifié, StreamIn remplace tout le contenu de cet objet d' CRichEditCtrl .

Dans le paramètre esd' EDITSTREAM , vous spécifiez une fonction de rappel qui remplit la mémoire tampon de texte. Cette fonction de rappel est appelée à plusieurs reprises, jusqu'à ce que le flux d'entrée soit épuisé.

Pour plus d'informations, consultez le message d' EM_STREAMIN et la structure d' EDITSTREAM dans Kit de développement logiciel Windows.

Exemple

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