EditStreamCallback

O EditStreamCallback função é um função callback application-defined usado com o EM_STREAMIN e EM_STREAMOUT mensagens. Ele é usado para transferir um fluxo de dados dentro ou fora de um Controlarar rich Editar. O EDITSTREAMCALLBACK tipo define um ponteiro para este função callback. EditStreamCallback é um espaço reservado para o nome função application-defined.

(DWORD CALLBACK EditStreamCallback DWORD  dwCookie, / / aplicativo-definidos valorLPBYTEpbBuff, / / ponteiro para uma reservaLongo cb, / / número de bytes para ler ou gravarLongo* pcb / / ponteiro para o número de bytes transferidos);
 

Parâmetros

dwCookie

Especifica o valor da dwCookie membro das EDITSTREAM estrutura. O aplicativo especifica este valor quando ele envia a mensagem EM_STREAMIN ou EM_STREAMOUT.

pbBuff

Ponteiro para uma reserva para ler ou gravar. Para uma operação de fluxo-in (leitura), a função de retorno de chamada preenche esse buffer de dados para transferir para o Controlarar rich Editar. Para uma operação de fluxo-out (gravação), o buffer contém dados de controle que a função de retorno de chamada grava algum tipo de armazenamento.

cb

Especifica o número de bytes para ler ou gravar.

pcb

Ponteiro para uma variável que define a função de retorno de chamada para o número de bytes realmente lidos ou gravados.

Retornar valores

O função callback retorna zero para indicar com êxito.

O função callback retorna um valor diferente de zero para indicar um erro. Se ocorrer um erro, a ler ou Gravar operação termina e os ricos editar controle descarta quaisquer dados no buffer de pbBuff . Se a função de retorno de chamada retorna um valor diferente de zero, o Controlarar rich Editar usa o dwError membro das EDITSTREAM estrutura para passar o valor de volta para o aplicativo.

Observações

Quando você envia o EM_STREAMIN ou EM_STREAMOUT mensagens para um Controlarar rich Editar, o pfnCallback membro das EDITSTREAM estrutura especifica um ponteiro para um EditStreamCallback função. O Controlarar rich Editar repetidamente chama a função a transferência de um fluxo de dados dentro ou fora do controle.

Quando você envia a mensagem EM_STREAMIN ou EM_STREAMOUT, você especificar um valor para a dwCookie membro das EDITSTREAM estrutura. O Controlarar rich Editar usa o dwCookie parâmetro para transmitir este valor para a EditStreamCallback função. Por exemplo, você pode usar dwCookie para passar um identificador para um aberto arquivo. A função de retorno de chamada, em seguida, pode usar o identificador dwCookie para ler ou gravar no arquivo.

O Controlarar chama o função callback repetidamente, transferindo uma parte dos dados com cada chamada. O controle continua a chamar a função de retorno de chamada até que ocorra uma das seguintes condições:

• O função callback retorna um valor diferente de zero.
• O função callback retorna zero na * parâmetro pcb.
• O valor retornado na * pcb parâmetro é menor que o número de bytes solicitado no parâmetro cb.
• Ocorre um erro que impede que o Controlarar rich Editar de transferência de dados em ou fora de si. Exemplos são out-of-memória situações, falha de uma função de sistema, ou o buffer de leitura contém um caractere inválido.
• Para uma fluxo-em operação, o código RTF contém dados especificando o final de um bloco RTF.
• Para uma fluxo de operação em um controle editar single-line, o retorno de chamada lê em um CRLF.

QuickInfo

nbsp; Windows &NT: requer versão 3.51 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no richedit.h.
Biblioteca de importação:Definido pelo usuário.

Ver também

Visão geral sobre controles de Rich Editar, funções de retorno de chamada Rich Edit, EDITSTREAM, EM_STREAMIN, EM_STREAMOUT

Index