EditStreamCallback

Die EditStreamCallback -Funktion ist eine anwendungsdefinierte Rückruffunktion verwendet mit den EM_STREAMIN und EM_STREAMOUT Nachrichten. Es wird verwendet, um einen Strom von Daten in oder aus einem rich-Edit-Steuerelement übertragen. Der EDITSTREAMCALLBACK -Typ definiert einen Zeiger auf diese Callback-Funktion. EditStreamCallback ist ein Platzhalter für den Namen der Anwendung definierte Funktion.

DWORD CALLBACK EditStreamCallback) DWORD  DwCookie, / / anwendungsspezifischer WertLPBYTEpbBuff, / / Zeiger auf einen PufferLange cb, / / Anzahl der Bytes zum Lesen oder schreibenLange* pcb / / Zeiger auf die Anzahl der Bytes übertragen);
 

Parameter

dwCookie

Gibt den Wert des betreffenden DwCookie der EDITSTREAM -Struktur. Die Anwendung gibt dieser Wert an, wenn es die EM_STREAMIN oder EM_STREAMOUT -Nachricht sendet.

pbBuff

Zeiger auf einen Puffer zu lesen oder zu schreiben. Für einen Stream-in (lesen) füllt die Callback-Funktion diesen Puffer mit Daten, die in das rich-Edit-Steuerelement übertragen. Für einen Stream-Out (Schreiben) enthält der Puffer Daten aus dem Steuerelement, das die Callback-Funktion in einen Speicher schreibt.

cb

Gibt die Anzahl der Bytes zum Lesen oder schreiben.

leiterplatten

Zeiger auf eine Variable, die die Callback-Funktion die Anzahl der tatsächlich gelesenen oder geschriebenen Bytes festlegt.

Rückgabewerte

Die Callback-Funktion gibt 0 (null), um einen Erfolg anzuzeigen.

Die Callback-Funktion gibt einen Wert ungleich NULL, um einen Fehler anzuzeigen. Wenn ein Fehler auftritt, bearbeiten lesen oder schreiben Vorgang endet und die reichen Steuerelement Rückwürfe alle Daten im Puffer PbBuff . Wenn die Callback-Funktion einen Wert ungleich NULL zurückgibt, verwendet das rich-Edit-Steuerelement den DwError -Member der EDITSTREAM -Struktur den Wert zurück an die Anwendung übergeben.

Bemerkungen

Wenn Sie das EM_STREAMIN oder die EM_STREAMOUT -Nachricht an ein rich-Edit-Steuerelement senden, gibt der PfnCallback -Member der EDITSTREAM -Struktur einen Zeiger auf eine EditStreamCallback -Funktion. Das rich-Edit-Steuerelement ruft wiederholt die Funktion, einen Strom von Daten in oder aus dem Steuerelement übertragen.

Wenn Sie die EM_STREAMIN oder EM_STREAMOUT-Nachricht zu senden, geben Sie einen Wert für den DwCookie -Member der EDITSTREAM -Struktur. Das rich-Edit-Steuerelement verwendet den Parameter DwCookie diesen Wert an die EditStreamCallback -Funktion übergeben. Beispielsweise können Sie DwCookie verwenden, um einen Handle auf eine geöffnete Datei zu übergeben. Die Callback-Funktion können das DwCookie -Handle zu lesen oder Schreiben der Datei.

Das Steuerelement ruft die Callback-Funktion wiederholt übertragen einen Teil der Daten mit jedem Aufruf. Das Steuerelement weiterhin die Callback-Funktion aufrufen, bis eine der folgenden Bedingungen auftritt:

• Die Callback-Funktion gibt einen Wert ungleich NULL zurück.
• Die Callback-Funktion gibt 0 (null) in der * pcb-Parameter.
• Der Rückgabewert die * pcb-Parameter ist kleiner als die Anzahl der Bytes in der Cb-Parameter angefordert.
• Tritt ein Fehler auf, die verhindert, dass das rich-Edit-Steuerelement übertragen von Daten in oder aus selbst. Beispiele sind Out-of-Memory Situationen, eine Systemfunktion, die mangelnde oder der Lesepuffer enthält ein ungültiges Zeichen.
• Für einen Stream-Vorgang enthält den RTF-Code Daten angeben das Ende eines Blocks RTF.
• Für eine Stream-Operation auf eine einzeilige edit-Steuerelement, der Rückruf liest in einem CRLF.

QuickInfo

&Nbsp; Windows NT: Version 3.51 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:Deklariert in richedit.h.
Importieren Bibliothek:Benutzerdefinierte.

Siehe auch

Übersicht über das Rich-Edit-Steuerelemente, Rich-Edit-Callback-Funktionen, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index