EditStreamCallback

La funzione EditStreamCallback è una funzione di callback definito dall'applicazione utilizzata con i messaggi di EM_STREAMIN ed EM_STREAMOUT . Essa viene utilizzata per trasferire un flusso di dati in o da un controllo rich edit. Il tipo EDITSTREAMCALLBACK definisce un puntatore a questa funzione di richiamata. EditStreamCallback è un segnaposto per il nome della funzione definita dall'applicazione.

(DWORD CALLBACK EditStreamCallback DWORD  dwCookie, / / definiti dall'applicazione valoreLPBYTEpbBuff, / / puntatore a un bufferLunga cb, / / numero di byte da leggere o scrivereLunga* pcb / / puntatore al numero di byte trasferiti);
 

Parametri

dwCookie
Specifica il valore del membro della struttura EDITSTREAM dwCookie . L'applicazione specifica questo valore quando invia il messaggio EM_STREAMIN o EM_STREAMOUT.
pbBuff
Puntatore a un buffer per leggere o scrivere a. Per un'operazione di flusso-in (leggi), la funzione di callback riempie questo buffer con i dati da trasferire nel controllo rich edit. Per un'operazione di flusso-out (scrittura), il buffer contiene dati dai controlli che la funzione di callback scrive alcuni archivio.
cb
Specifica il numero di byte da leggere o scrivere.
pcb
Puntatore a una variabile che la funzione di callback imposta il numero di byte effettivamente letti o scritti.

Valori restituiti

La funzione di callback restituisce zero per indicare il successo.

La funzione di callback restituisce un valore diverso da zero per indicare un errore. Se si verifica un errore, la lettura o scrittura operazione finisce e i ricchi modificare controllo rigetti tutti i dati nel buffer di pbBuff . Se la funzione di callback restituisce un valore diverso da zero, controllo rich edit utilizza il dwError membro della struttura EDITSTREAM per passare il valore all'applicazione.

Osservazioni

Quando si invia il messaggio EM_STREAMOUT o EM_STREAMIN a un controllo rich edit, il membro pfnCallback della struttura EDITSTREAM specifica un puntatore a una funzione EditStreamCallback . Controllo rich edit chiama ripetutamente la funzione per trasferire un flusso di dati in o fuori del controllo.

Quando si invia il messaggio EM_STREAMIN o EM_STREAMOUT, è necessario specificare un valore per il dwCookie membro della struttura EDITSTREAM . Controllo rich edit utilizza il parametro dwCookie per passare questo valore alla funzione EditStreamCallback . Ad esempio, si potrebbe utilizzare dwCookie per passare un handle per un file aperto. La funzione di callback può quindi utilizzare l'handle dwCookie per leggere o scrivere file.

Il controllo chiama la funzione di richiamata più volte, trasferire una parte dei dati a ogni chiamata. Il controllo continua a chiamare la funzione di callback, finché non si verifica una delle condizioni seguenti:

Descrizione

nbsp; Windows &NT: richiede 3,51 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in richedit.h.
Importare librerie:Definito dall'utente.

Vedi anche

Cenni preliminari sui controlli Rich Edit, funzioni di Callback Rich Edit, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index