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:

• La funzione di callback restituisce un valore diverso da zero.
• La funzione di callback restituisce zero nel * parametro pcb.
• Il valore restituito nel * pcb parametro è inferiore al numero di byte richiesto nel parametro cb.
• Si verifica un errore che impedisce il controllo rich edit di trasferimento dei dati in o fuori di sé. Esempi sono situazioni di memoria insufficiente, il fallimento di una funzione di sistema, o il buffer di letto contiene un carattere non valido.
• Per un flusso nell'operazione, il codice RTF contiene dati specificando la fine di un blocco RTF.
• Per un flusso in operazione su un controllo di modifica a riga singola, il callback si legge in un CRLF.

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