EditStreamCallback

Funkcja EditStreamCallback jest funkcją wywołanie zwrotne definiowane przez aplikację z wiadomości EM_STREAMIN i EM_STREAMOUT . Jest on używany do przesyłania strumienia danych do lub z formant edycji wzbogaconej. Typ EDITSTREAMCALLBACK określa wskaźnik do funkcji wywołania zwrotnego. EditStreamCallback jest symbolem zastępczym nazwy funkcji zdefiniowanych przez aplikację.

(DWORD wywołania zwrotnego EditStreamCallback DWORD  dwCookie, / / zdefiniowanych przez aplikację wartościLPBYTEpbBuff, / / wskaźnik do buforuDługie cb, / / liczba bajtów do odczytu lub zapisuDługie* pcb / / przenieść wskaźnik liczby bajtów);
 

Parametry

dwCookie

Określa wartość członka dwCookie struktury EDITSTREAM . Wniosek określa tę wartość, gdy wysyła komunikat EM_STREAMIN lub EM_STREAMOUT.

pbBuff

Wskaźnik do buforu w celu odczytu lub zapisu. Dla operacji strumienia w (odczyt) funkcja wywołania zwrotnego wypełnia bufor danych Aby przenieść formant edycji wzbogaconej. Dla operacji strumienia ruch wychodzący (zapisu) bufor zawiera dane z formantu, do którego funkcja wywołania zwrotnego zapisuje niektóre pamięci masowej.

cb

Określa liczbę bajtów do odczytu lub zapisu.

pcb

Wskaźnik do zmiennej, która funkcja wywołania zwrotnego Ustawia liczbę bajtów faktycznie odczytu lub zapisu.

Zwraca wartości

Funkcja wywołania zwrotnego zwraca zero do wskazania sukcesu.

Funkcja wywołania zwrotnego zwraca wartość różną od zera, aby wskazać błąd. Jeśli wystąpi błąd, Odczyt lub zapis operacji kończy się i bogatymi edytować odrzutów kontroli wszystkie dane w buforze pbBuff . Jeśli funkcja wywołania zwrotnego zwraca wartość różną od zera, formant edycji wzbogaconej używa członek dwError struktury EDITSTREAM do przekazania wartości powrotem do aplikacji.

Uwagi

Po wysłaniu EM_STREAMIN lub EM_STREAMOUT wiadomości na formant edycji wzbogaconej, członek pfnCallback struktury EDITSTREAM określa wskaźnik do funkcji EditStreamCallback . Formant edycji wzbogaconej wielokrotnie wywołuje funkcję do przesyłania strumienia danych do lub z kontroli.

Podczas wysyłania wiadomości EM_STREAMIN lub EM_STREAMOUT, można określić wartość dla członka dwCookie struktury EDITSTREAM . Formant edycji wzbogaconej użyto parametru dwCookie , aby przekazać tę wartość do funkcji EditStreamCallback . Na przykład można użyć dwCookie przekazywać dojścia do otwartego pliku. Funkcja wywołania zwrotnego można następnie używać uchwyt dwCookie do odczytu lub zapisu do pliku.

Formant wywołuje funkcję wywołania zwrotnego wielokrotnie, przeniesienie części danych z każdego wywołania. Kontroli kontynuuje wywoływanie funkcji wywołania zwrotnego, dopóki nie pojawia się jeden z następujących warunków:

• Funkcja wywołania zwrotnego zwraca wartość różną od zera.
• Funkcja wywołania zwrotnego zwraca wartość zero w * parametr pcb.
• Wartość zwracany w * parametr pcb jest mniejsza niż liczba bajtów w parametrze cb.
• Występuje błąd uniemożliwiający przesyłania danych do lub z sam formant edycji wzbogaconej. Przykłady są sytuacje, braku pamięci, uszkodzenie funkcji systemu lub buforu odczytu zawiera nieprawidłowy znak.
• Dla operacji strumień przychodzący kod RTF zawiera dane określające koniec bloku RTF.
• Za operację strumienia w w formancie edycji jednowierszowy wywołanie zwrotne odczytuje w znaku CRLF.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.51 lub nowszych.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w richedit.h.
Importowanie biblioteki:Zdefiniowane przez użytkownika.

Zobacz też

Rich Edit formanty omówienie, funkcje wywołania zwrotnego Rich Edit, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index