EditStreamCallback

De EditStreamCallback functie is een toepassing gedefinieerde callback functie gebruikt met de EM_STREAMIN en EM_STREAMOUT berichten. Het wordt gebruikt om een stroom van gegevens overbrengen naar of uit een besturingselement rich edit. Het EDITSTREAMCALLBACK type definieert een pointer naar deze callback functie. EditStreamCallback is een tijdelijke aanduiding voor de naam van de toepassing gedefinieerde functie.

(DWORD-CALLBACK EditStreamCallback DWORD  dwCookie, / / toepassing gedefinieerde waardeLPBYTEpbBuff, / / pointer naar een bufferLange cb, / / aantal bytes te lezen of schrijvenLange* pcb / / pointer naar het aantal bytes dat is overgedragen);
 

Parameters

dwCookie
Hiermee geeft u de waarde van het lid dwCookie van de EDITSTREAM structuur. De toepassing geeft deze waarde als het stuurt het bericht EM_STREAMIN of EM_STREAMOUT.
pbBuff
Aanwijzer naar een buffer te lezen van of schrijven naar. Voor een operatie stream-in (lezen) vult de callback functie deze buffer met gegevens overbrengen naar het besturingselement rich edit. Voor de werking van een stream-out (schrijven) bevat de buffer gegevens uit het besturingselement dat de callback functie naar sommige opslag schrijft.
cb
Hiermee geeft u het aantal bytes te lezen of schrijven.
pcb
Pointer naar een variabele waarmee de callback functie wordt ingesteld op het aantal bytes eigenlijk gelezen of geschreven.

Retourwaarden

De callback functie retourneert nul om aan te geven van succes.

De callback functie geeft als resultaat een niet-nulzijnde waarde een fout optreedt. Als een fout optreedt, bewerken het lezen of schrijven operatie eindigt en de rijke controle teruggooi alle gegevens in de buffer pbBuff . Als de callback functie geeft als een andere waarde dan nul resultaat, het besturingselement rich edit gebruikt het lid dwError van de EDITSTREAM structuur te geven de waarde terug naar de toepassing.

Opmerkingen

Wanneer u de EM_STREAMIN of EM_STREAMOUT -bericht naar een besturingselement rich edit verzendt, geeft het lid pfnCallback van de EDITSTREAM -structuur een pointer naar een functie EditStreamCallback . Het besturingselement rich edit roept herhaaldelijk de functie aan een stroom van gegevens overbrengen naar of uit het besturingselement.

Wanneer u de EM_STREAMIN of EM_STREAMOUT-bericht verzendt, geeft u een waarde voor het lid dwCookie van de EDITSTREAM structuur. Het besturingselement rich edit dwCookie de parameter doorgeven deze waarde aan uw EditStreamCallback functie wordt gebruikt. U kunt bijvoorbeeld dwCookie voor het doorgeven van een handvat aan een geopend bestand. De callback functie kunt vervolgens de dwCookie greep te lezen van of schrijven naar het bestand gebruiken.

Het besturingselement roept de callback functie herhaaldelijk, overdracht van een gedeelte van de gegevens per oproep. Het besturingselement blijft de callback functie oproepen tot een van de volgende situaties zich voordoet:

Syntaxisinfo

nbsp; Windows &NT: versie 3.51 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in richedit.h.
Bibliotheek importeren:Gebruiker gedefinieerde.

Zie ook

Rich Edit besturingselementen overzicht, Rich Edit Callback functies, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index