EM_STREAMIN Nachricht

  • Artikel

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

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_STREAMOUT