Compartilhar via

Funções de Retorno de Chamada Usadas pelo MFC

  • Artigo

Três funções de retorno de chamada aparecem na biblioteca Microsoft Foundation Class. Essas funções de retorno de chamada são passadas para CDC::EnumObjects, CDC::GrayString e CDC::SetAbortProc. Observe que todas as funções de retorno de chamada devem capturar exceções do MFC antes de retornar ao Windows, pois as exceções não podem ser geradas entre limites de retorno de chamada. Para mais informações sobre exceções, confira o artigo Exceções.

Função de retorno de chamada para CDC::EnumObjects
Função de retorno de chamada para CDC::GrayString
Função de retorno de chamada para CDC::SetAbortProc

Requisitos

Cabeçalho: afxwin.h

Função de retorno de chamada para CDC::EnumObjects

O nome ObjectFunc é um espaço reservado para o nome da função fornecida pelo aplicativo.

Sintaxe

int CALLBACK EXPORT ObjectFunc(
    LPSTR lpszLogObject,
    LPSTR* lpData);

Parâmetros

lpszLogObject
Aponta para uma estrutura de dados LOGPEN ou LOGBRUSH que contém informações sobre os atributos lógicos do objeto.

lpData
Aponta para os dados fornecidos pelo aplicativo passados para a função EnumObjects.

Valor de retorno

A função de retorno de chamada retorna um int. O valor desse retorno é definido pelo usuário. Se a função de retorno de chamada retornar 0, EnumObjects interrompe a enumeração antecipadamente.

Comentários

O nome real deve ser exportado.

Função de retorno de chamada para CDC::GrayString

OutputFunc é um espaço reservado para o nome da função de retorno de chamada fornecida pelo aplicativo.

Sintaxe

BOOL CALLBACK EXPORT OutputFunc(
    HDC hDC,
    LPARAM lpData,
    int nCount);

Parâmetros

hDC
Identifica um contexto de dispositivo de memória com um bitmap de pelo menos a largura e a altura especificadas por nWidth e nHeight para GrayString.

lpData
Aponta para a cadeia de caracteres a ser desenhada.

nCount
Especifica o número de caracteres para saída.

Valor de retorno

O valor retornado da função de retorno de chamada deve ser TRUE para indicar êxito. Caso contrário, é FALSE.

Comentários

A função de retorno de chamada (OutputFunc) deve desenhar uma imagem em relação às coordenadas (0,0) em vez de (x, y).

Função de retorno de chamada para CDC::SetAbortProc

O nome AbortFunc é um espaço reservado para o nome da função fornecida pelo aplicativo.

Sintaxe

BOOL CALLBACK EXPORT AbortFunc(
    HDC hPr,
    int code);

Parâmetros

hPr
Identifica o contexto do dispositivo.

code
Especifica se ocorreu um erro. Será 0 se nenhum erro tiver ocorrido. Será SP_OUTOFDISK se o Gerenciador de Impressão estiver atualmente sem espaço em disco e mais espaço em disco será disponibilizado se o aplicativo aguardar. Se o código for SP_OUTOFDISK, o aplicativo não precisará anular o trabalho de impressão. Se isso não acontecer, ele deverá suspender o Gerenciador de Impressão chamando a função PeekMessage ou GetMessage do Windows.

Valor de retorno

O valor retornado da função de manipulador de será diferente de zero se o trabalho de impressão for continuar e 0 se for cancelado.

Comentários

O nome real deve ser exportado conforme descrito na seção Comentários de CDC::SetAbortProc.

Confira também

Estruturas, estilos, retornos de chamada e mapas de mensagem
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString