EM_STREAMOUT Nachricht

Bewirkt, dass ein Rich-Edit-Steuerelement seinen Inhalt an eine von der Anwendung definierte EditStreamCallback-Rückruffunktion übergibt. Die Rückruffunktion kann dann den Datenstrom in eine Datei oder einen anderen ausgewählten Speicherort schreiben.

Parameter

wParam

Gibt das Datenformat und die Ersetzungsoptionen an.

Dieser Wert muss einer der folgenden Werte sein.

Wert	Bedeutung
SF_RTF	RTF.
SF_RTFNOOBJS	RTF mit Leerzeichen anstelle von COM-Objekten.
SF_TEXT	Text mit Leerzeichen anstelle von COM-Objekten.
SF_TEXTIZED	Text mit einer Textdarstellung von COM-Objekten.

Die option SF_RTFNOOBJS ist nützlich, wenn eine Anwendung COM-Objekte selbst speichert, da die RTF-Darstellung von COM-Objekten nicht sehr kompakt ist. Das Steuerelementwort \objattph gefolgt von einem Leerzeichen kennzeichnet die Objektposition.

Darüber hinaus können Sie die folgenden Flags angeben.

Wert	Bedeutung
SFF_PLAINRTF	Wenn angegeben, streamt das Rich-Edit-Steuerelement nur die Schlüsselwörter, die allen Sprachen gemeinsam sind, und ignoriert sprachspezifische Schlüsselwörter. Wenn nicht angegeben, streamt das Rich-Edit-Steuerelement alle Schlüsselwörter. Sie können dieses Flag mit dem SF_RTF- oder SF_RTFNOOBJS-Flag kombinieren.
SFF_SELECTION	Falls angegeben, streamt das Rich-Edit-Steuerelement nur den Inhalt der aktuellen Auswahl aus. Wenn nicht angegeben, streamt das Steuerelement den gesamten Inhalt aus. Sie können dieses Flag mit beliebigen Datenformatwerten kombinieren.
SF_UNICODE	Microsoft Rich Edit 2.0 und höher: Gibt Unicode-Text an. Sie können dieses Flag mit dem SF_TEXT-Flag kombinieren.
SF_USECODEPAGE	Rich Edit 3.0 und höher: Generiert UTF-8 RTF und Text mithilfe anderer Codepages. Die Codepage wird im hohen Wort von wParam festgelegt. Legen Sie beispielsweise für UTF-8 RTF wParam auf (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF.

lParam

Zeiger auf eine EDITSTREAM-Struktur . Bei der Eingabe muss das pfnCallback-Element dieser Struktur auf eine anwendungsdefinierte EditStreamCallback-Funktion verweisen. Bei der Ausgabe kann der dwError-Member einen nonzero-Fehlercode enthalten, wenn ein Fehler aufgetreten ist.

Rückgabewert

Diese Nachricht gibt die Anzahl der Zeichen zurück, die in den Datenstrom geschrieben wurden.

Bemerkungen

Wenn Sie eine EM_STREAMOUT Nachricht senden, ruft das Rich-Edit-Steuerelement wiederholt die EditStreamCallback-Funktion auf, die vom pfnCallback-Member der EDITSTREAM-Struktur angegeben wird. Jedes Mal, wenn es die Rückruffunktion aufruft, übergibt das Steuerelement einen Puffer, der einen Teil des Inhalts des Steuerelements enthält. Dieser Prozess wird fortgesetzt, bis das Steuerelement seinen gesamten Inhalt an die Rückruffunktion übergeben hat oder bis ein Fehler auftritt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Richedit.h

Weitere Informationen

Referenz

EDITSTREAM

EditStreamCallback

EM_STREAMIN