EM_STREAMIN Nachricht

Ersetzt den Inhalt eines Rich-Edit-Steuerelements durch einen Datenstrom, der von einer von der Anwendung definierten EditStreamCallback-Rückruffunktion bereitgestellt wird.

Parameter

wParam

Gibt das Datenformat und die Ersetzungsoptionen an. Dieser Wert muss einer der folgenden Werte sein.

Wert	Bedeutung
SF_RTF	RTF
SF_TEXT	Text

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

Wert	Bedeutung
SFF_PLAINRTF	Wenn angegeben, werden nur Schlüsselwörter gestreamt, die für alle Sprachen gemeinsam sind. Sprachspezifische RTF-Schlüsselwörter im Stream werden ignoriert. Wenn nicht angegeben, werden alle Schlüsselwörter gestreamt. Sie können dieses Flag mit dem SF_RTF-Flag kombinieren.
SFF_SELECTION	Falls angegeben, ersetzt der Datenstrom den Inhalt der aktuellen Auswahl. Wenn nicht angegeben, ersetzt der Datenstrom den gesamten Inhalt des Steuerelements. Sie können dieses Flag mit den SF_TEXT - oder SF_RTF-Flags 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: Liest 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 gelesenen Zeichen zurück.

Bemerkungen

Wenn Sie eine EM_STREAMIN Nachricht senden, ruft das Rich-Edit-Steuerelement wiederholt die EditStreamCallback-Funktion auf, die vom pfnCallback-Member der EDITSTREAM-Struktur angegeben wird. Jedes Mal, wenn die Rückruffunktion aufgerufen wird, füllt sie einen Puffer mit Daten, die in das Steuerelement eingelesen werden können. Dies wird fortgesetzt, bis die Rückruffunktion angibt, dass der Stream-In-Vorgang abgeschlossen wurde oder ein Fehler auftritt.

Anforderungen

Weitere Informationen

Referenz

EDITSTREAM

EditStreamCallback

EM_STREAMOUT