EditStreamCallback

EditStreamCallback -funksjonen er en programdefinert tilbakekall-funksjonen brukes sammen med EM_STREAMIN og EM_STREAMOUT -meldinger. Det brukes til å overføre en datastrøm inn i eller ut av en rich edit-kontrollen. EDITSTREAMCALLBACK -typen definerer en peker til denne tilbakeringingsfunksjonen for. EditStreamCallback er en plassholder for navnet på programdefinert funksjonen.

DWORD TILBAKERINGING EditStreamCallback) DWORD  dwCookie, / / Programdefinert verdiLPBYTEpbBuff, / / peker til en bufferLang cb, / / antall byte for å lese eller skriveLang* pcb / / peker til antallet byte overført);
 

Parametere

dwCookie

Angir verdien for dwCookie -medlem av EDITSTREAM -strukturen. Programmet angir denne verdien når det sender meldingen EM_STREAMIN eller EM_STREAMOUT.

pbBuff

Pekeren til en buffer til å lese fra eller skrive til. For en dataflyt-i (lese)-operasjon fyller tilbakeringingsfunksjonen denne bufferen med data for å overføre til rich edit-kontrollen. For en dataflyt ut (skrive)-operasjon inneholder bufferen data fra kontrollen som tilbakeringingsfunksjonen skriver til noen lagring.

cb

Angir hvor mange byte for å lese eller skrive.

pcb

Pekeren til en variabel som tilbakeringingsfunksjonen angir antall byte som faktisk leses fra eller skrives.

Returverdier

Tilbakeringingsfunksjonen returnerer null til å angi suksess.

Tilbakeringingsfunksjonen returnerer en ikke-null verdi for å angi en feil. Hvis det oppstår en feil, redigere lese eller skrive operasjon slutter og rike kontroll forkaster eventuelle data i den pbBuff -bufferen. Hvis tilbakeringingsfunksjonen returnerer en ikke-null verdi, bruker rich edit-kontrollen dwError -medlem av EDITSTREAM -strukturen til å overføre verdien tilbake til programmet.

Merknader

Når du sender EM_STREAMIN eller EM_STREAMOUT -melding til en rich edit-kontrollen, angir pfnCallback -medlem av EDITSTREAM -strukturen en peker til en EditStreamCallback funksjon. Rich edit-kontrollen kaller gjentatte ganger funksjonen til å overføre en datastrøm inn i eller ut av kontrollen.

Når du sender meldingen EM_STREAMIN eller EM_STREAMOUT, kan du angi en verdi for medlemmet dwCookie av EDITSTREAM -strukturen. Rich edit-kontrollen bruker parameteren dwCookie for å passere denne verdien til EditStreamCallback -funksjonen. Du kan for eksempel bruke dwCookie til å sende et håndtak til en åpen fil. Tilbakeringingsfunksjonen kan deretter bruke håndtaket dwCookie å lese fra eller skrive til filen.

Kontrollen kaller tilbakeringingsfunksjonen gjentatte ganger, overføring av en del av dataene med hver samtale. Kontrollen fortsetter til å kalle tilbakeringingsfunksjonen til et av følgende forhold oppstår:

• Tilbakeringingsfunksjonen returnerer en ikke-null verdi.
• Tilbakeringingsfunksjonen returnerer null i den * pcb-parameteren.
• Verdien som returneres i den * pcb-parameteren er mindre enn antall byte som er angitt i parameteren cb.
• Det oppstår en feil som hindrer overføring av data til eller fra selve rich edit-kontrollen. Eksempler er av at det ikke er nok minne situasjoner, svikt i en systemfunksjon, eller lesebufferen inneholder et ugyldig tegn.
• For en dataflyt i operasjonen inneholder RTF-kode data å angi slutten av en RTF-blokk.
• For en dataflyt-operasjon på et enlinjet redigeringskontroll tilbakeringingen leser i en CRLF.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.51 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i richedit.h.
Importere biblioteket:Brukerdefinerte.

Se også

Rediger kontroller oversikt, RichEdit tilbakekall funksjoner, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index