EditStreamCallback

EditStreamCallback funkcia je definovanom aplikáciou callback funkcie použiť s EM_STREAMIN a EM_STREAMOUT správy. Sa používa na prenos prúdu údajov do alebo z ovládacieho prvku RTF. EDITSTREAMCALLBACK typ určuje smerník túto funkciu spätného volania. EditStreamCallback je zástupný symbol pre názov definovanom aplikáciou funkcie.

(DWORD spätného volania EditStreamCallback DWORD  dwCookie; / / uplatňovania definovaná hodnotaLPBYTEpbBuff; / / ukazovateľ do medzipamäteDlhé cb; / počet bytov čítať alebo zapisovaťDlhé* pcb / / smerník na počet bajtov prevedené);
 

Parametre

dwCookie

Určuje hodnotu dwCookie členského EDITSTREAM štruktúru. Aplikácia určuje táto hodnota, keď posiela správu EM_STREAMIN alebo EM_STREAMOUT.

pbBuff

Ukazovateľ do medzipamäte zapisovať do alebo čítať z. Pre operáciu prúd v (čítaj) callback funkciou vyplní Tento pufer s údajmi na prenos do ovládacieho prvku RTF. Pre operáciu prúd – odchádzajúce prenosy (zápis) medzipamäť obsahuje údaje z ovládacieho prvku, ktorý callback funkciou píše na niektoré skladovanie.

cb

Určuje počet bajtov čítať alebo zapisovať.

pcb

Ukazovateľ na ukazovateľ, že callback funkciou nastaví počet bajtov číta alebo zapisuje.

Note:

Funkcia spätné volanie vráti nulu označovať úspech.

Funkcia spätné volanie vráti nenulovú hodnotu označiť chybu. Ak sa vyskytne chyba, čítať alebo písať činnosť končí a bohaté upraviť kontrolu odpadu akékoľvek údaje v pbBuff medzipamäte. Ak callback funkcie vracia hodnotu inú ako nula, RTF kontrolu používa dwError člen EDITSTREAM štruktúra odovzdať hodnotu späť na uplatňovanie.

Poznámky

Keď odošlete EM_STREAMIN alebo EM_STREAMOUT správy k ovládaciemu prvku RTF, pfnCallback člen EDITSTREAM štruktúra určuje ukazovateľ na funkciu EditStreamCallback . Kontrola RTF opakovane volá funkciu na prenos prúdu údajov do alebo z ovládacieho prvku.

Keď posielate správu EM_STREAMIN alebo EM_STREAMOUT, zadáte hodnotu pre člena dwCookie EDITSTREAM konštrukcie. Bohaté upraviť kontrolu používa dwCookie parameter odovzdať túto hodnotu funkcie EditStreamCallback . Napríklad, môžete použiť dwCookie prejsť popisovača do otvoreného súboru. Callback funkciou potom môžete použiť dwCookie rukoväť čítať alebo zapisovať do súboru.

Ovládací prvok zavolá funkciu spätného volania opakovane previesť časť údajov s každého hovoru. Kontroly aj naďalej volať funkciu spätného volania, kým nastane niektorá z nasledujúcich podmienok:

• Vracia pozitívne hodnoty v callback funkciou.
• Funkcia spätné volanie vráti nulu v * pcb parametra.
• Hodnoty vrátené * pcb parameter je nižší ako počet bajtov požadovaných v parametri cb.
• Vyskytne chyba, ktorá zabraňuje RTF kontrola prenosu údajov do alebo z sama. Príkladmi sú nedostatok pamäte situáciách, zlyhanie systému funkcie alebo read bufferi obsahuje neplatný znak.
• Pre operáciu prúd v RTF kódex obsahuje údajmi zadanie koniec bloku s RTF.
• Pre prúd v prevádzke na jednoriadkové upraviť ovládací prvok, k spätnému volaniu znie v CRLF.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzie 3.51 alebo novšej.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v richedit.h.
Importovať knižnica:Definované používateľom.

Pozri tiež

Rich upraviť kontroly prehľad, Rich upraviť Callback funkcie, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index