CRichEditCtrl::StreamOut

Article
03/04/2013

Écrit le contenu de cet objet d' CRichEditCtrl dans le flux de sortie spécifié.

long StreamOut(
   int nFormat,
   EDITSTREAM& es 
);

Paramètres

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

Valeur de retour

Nombre de caractères entrés dans le flux de sortie.

Notes

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

SF_TEXT indique le texte d'écriture seule.
SF_RTF indique le texte et le format d'écriture.
SF_RTFNOOBJS indique le texte et le format d'écriture, en remplaçant de OLE éléments par des espaces.
SF_TEXTIZED indique le texte et le format d'écriture, avec les représentations textuelles de OLE éléments.

L'un de ces valeurs peuvent être combinées avec SFF_SELECTION.Si SFF_SELECTION est spécifié, StreamOut écrit la sélection actuelle dans le flux de sortie.s'il n'est pas spécifié, StreamOut écrit le contenu entier 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 de sortie être épuisé.

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

Exemple

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

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

   return 0;
}

// The example code.

// The file to store the contents of the rich edit control.
CFile cFile(TEXT("My_RichEdit_OutFile.rtf"), 
   CFile::modeCreate|CFile::modeWrite);
EDITSTREAM es;

es.dwCookie = (DWORD) &cFile;
es.pfnCallback = MyStreamOutCallback; 
m_myRichEditCtrl.StreamOut(SF_RTF, es);