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:

• De callback functie geeft als resultaat een andere waarde dan nul.
• De callback functie retourneert nul in de * pcb parameter.
• De waarde die wordt geretourneerd de * pcb parameter is minder dan het gevraagde aantal bytes in de parameter cb.
• Er treedt een fout op die voorkomt dat het besturingselement rich edit gegevensoverdracht in of uit van zichzelf. Voorbeelden zijn uit-van-geheugen situaties, falen van een systeemfunctie, of de leesbuffer bevat een ongeldig teken.
• Voor een stream-in werking bevat de RTF-code gegevens opgeven voor het einde van een RTF-blok.
• Voor een stream-in bewerking op een besturingselement voor één regel bewerken, wordt de callback gelezen in een CRLF.

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