Funções de Callback Utilizadas pela MFC

Três funções de callback aparecem na Microsoft Foundation Class Library. Estas funções de callback são passadas para CDC::EnumObjects, CDC::GrayString e CDC::SetAbortProc. Note que todas as funções de callback devem capturar exceções MFC antes de regressar ao Windows, uma vez que as exceções não podem ser lançadas através dos limites do callback. Para obter mais informações sobre exceções, consulte o artigo Exceções.

Função de Callback para CDC::EnumObjects
Função de Callback para CDC::GrayString
Função de Retorno de Chamada para CDC::SetAbortProc

Requerimentos

Cabeçalho: afxwin.h

Função de Callback para CDC::EnumObjects

O nome ObjectFunc é um marcador de posição para o nome da função fornecida pela aplicação.

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ção sobre os atributos lógicos do objeto.

lpData
Aponta para os dados fornecidos pela aplicação passados para a EnumObjects função.

Valor de retorno

A função de callback devolve um int. O valor deste retorno é definido pelo utilizador. Se a função de callback devolver 0, EnumObjects interrompe a enumeração mais cedo.

Observações

O nome real deve ser exportado.

Função de Callback para CDC::GrayString

OutputFunc é um marcador de posição para o nome da função de callback fornecido pela aplicação.

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 altura especificados por nWidth e nHeight para GrayString.

lpData
Aponta para a cadeia de caracteres a ser desenhada.

nCount
Especifica o número de caracteres a produzir.

Valor de retorno

O valor de retorno da função de callback deve ser TRUE para indicar sucesso; caso contrário, é FALSO.

Observações

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

Função de Retorno de Chamada para CDC::SetAbortProc

O nome AbortFunc é um marcador para o nome da função fornecida pela aplicação.

Sintaxe

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

Parâmetros

hPr
Identifica o contexto do dispositivo.

código
Especifica se ocorreu um erro. É 0 se não tiver ocorrido nenhum erro. É SP_OUTOFDISK se o Gestor de Impressão estiver atualmente sem espaço em disco e mais espaço ficará disponível se a aplicação esperar. Se o código for SP_OUTOFDISK, a aplicação não tem de abortar o trabalho de impressão. Se não o fizer, deve ceder o caminho ao Gestor de Impressão chamando a PeekMessage função ou GetMessage Windows.

Valor de retorno

O valor de retorno da função abort-handler é diferente de zero se o trabalho de impressão for continuar, e 0 se for cancelado.

Observações

O nome real deve ser exportado conforme descrito na secção de Observações do CDC::SetAbortProc.

Consulte também

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