Funciones de devolución de llamada usadas por MFC

Aparecen tres funciones de devolución de llamada en la biblioteca MFC (Microsoft Foundation Class). Estas funciones de devolución de llamada se pasan a CDC::EnumObjects, CDC::GrayString y CDC::SetAbortProc. Tenga en cuenta que todas las funciones de devolución de llamada deben capturar las excepciones de MFC antes de volver a Windows, ya que no se pueden producir excepciones a través de los límites de devolución de llamada. Para obtener más información sobre las excepciones, consulte el artículo Excepciones.

Función de devolución de llamada para CDC::EnumObjects
Función de devolución de llamada para CDC::GrayString
Función de devolución de llamada para CDC::SetAbortProc

Requisitos

Encabezado: afxwin.h

Función de devolución de llamada para CDC::EnumObjects

El nombre ObjectFunc es un marcador de posición para el nombre de función proporcionado por la aplicación.

Sintaxis

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

Parámetros

lpszLogObject
Apunta a una estructura de datos LOGPEN o LOGBRUSH que contiene información sobre los atributos lógicos del objeto.

lpData
Apunta a los datos proporcionados por la aplicación pasados a la función EnumObjects.

Valor devuelto

La función de devolución de llamada devuelve un int. El valor de esta devolución está definido por el usuario. Si la función de devolución de llamada devuelve 0, EnumObjects detiene la enumeración antes.

Comentarios

Se debe exportar el nombre real.

Función de devolución de llamada para CDC::GrayString

OutputFunc es un marcador de posición para el nombre de la función de devolución de llamada proporcionado por la aplicación.

Sintaxis

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

Parámetros

hDC
Identifica un contexto de dispositivo de memoria con un mapa de bits de al menos el ancho y el alto especificados por nWidth y nHeight en GrayString.

lpData
Apunta a la cadena de caracteres que se va a dibujar.

nCount
Especifica el número de caracteres de la salida.

Valor devuelto

El valor devuelto de la función de devolución de llamada debe ser TRUE para indicar que se ha realizado correctamente; de lo contrario, es FALSE.

Comentarios

La función de devolución de llamada (OutputFunc) debe dibujar una imagen relativa a las coordenadas (0,0) en lugar de (x, y).

Función de devolución de llamada para CDC::SetAbortProc

El nombre AbortFunc es un marcador de posición para el nombre de función proporcionado por la aplicación.

Sintaxis

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

Parámetros

hPr
Identifica el contexto del dispositivo.

code
Especifica si se ha producido un error. Es 0 si no se ha producido ningún error. Es SP_OUTOFDISK si el Administrador de impresión no tiene actualmente espacio en disco y, si la aplicación espera, estará disponible más espacio en disco. Si el código es SP_OUTOFDISK, la aplicación no tiene que anular el trabajo de impresión. Si no es así, debe dejar actuar al Administrador de impresión llamando a la función PeekMessage o GetMessage de Windows.

Valor devuelto

El valor devuelto de la función del controlador de anulación es distinto de cero si el trabajo de impresión va a continuar y 0 si se cancela.

Comentarios

El nombre real debe exportarse tal y como se describe en la sección Comentarios de CDC::SetAbortProc.

Consulte también

Estructuras, estilos, devoluciones de llamada y mapas de mensajes
CDC::EnumObjects
CDC::SetAbortProc
CDC::GrayString