_CPSUICALLBACK función de devolución de llamada (compstui.h)

Las aplicaciones CPSUI usan el tipo de función _CPSUICALLBACK (incluidos los archivos DLL de interfaz de impresora) para definir una función de devolución de llamada diseñada para su uso como controlador de mensajes CPSUI.

Sintaxis

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parámetros

pCPSUICBParam

Puntero proporcionado por CPSUI a una estructura CPSUICBPARAM .

Valor devuelto

Una función de devolución de llamada con tipo _CPSUICALLBACK debe devolver uno de los valores enumerados en la tabla siguiente. Cada valor indica una acción que debe realizar CPSUI.

Código devuelto	Descripción
CPSUICB_ACTION_ITEMS_APPLIED	El miembro Reason de la estructura CPSUICBPARAM se estableció en CPSUICB_REASON_APPLYNOW y la función de devolución de llamada ha procesado correctamente los valores de opción actuales.
CPSUICB_ACTION_NO_APPLY_EXIT	El miembro Reason de la estructura CPSUICBPARAM se estableció en CPSUICB_REASON_APPLYNOW, pero la función de devolución de llamada ha detectado valores de opción no válidos o incompatibles. La función de devolución de llamada debe mostrar un cuadro de diálogo que indique al usuario del problema.
CPSUICB_ACTION_NONE	No se requiere ninguna acción por CPSUI.
CPSUICB_ACTION_OPTIF_CHANGED	La función de devolución de llamada ha establecido la marca OPTIF_CHANGED en una estructura OPTITEM para indicar que la opción seleccionada ha cambiado o que ha cambiado otra marca con prefijo OPTIF.
CPSUICB_ACTION_REINIT_ITEMS	La función de devolución de llamada ha establecido la marca de OPTIF_CHANGED en una estructura OPTITEM para indicar que los miembros Flags o pData de la estructura OPTTYPE o OPTPARAM asociada han cambiado.

Comentarios

Las funciones de devolución de llamada especificadas mediante el tipo de función _CPSUICALLBACK se proporcionan mediante aplicaciones que usan CPSUI para administrar páginas de hoja de propiedades. Si una de estas funciones de devolución de llamada está asociada a una página de hoja de propiedades, CPSUI la llama cuando se detecta la actividad del usuario (como cambiar el foco de control de la página, modificar los valores de opción o hacer clic en Aceptar).

Una función de devolución de llamada con tipo _CPSUICALLBACK se asigna a una página de hoja de propiedades mediante la inclusión de su dirección en una estructura COMPROPSHEETUI , que se pasa a la función ComPropSheet de CPSUI cuando se CPSFUNC_ADD_PCOMPROPSHEETUI el código de función.

Además, las funciones de devolución de llamada se pueden asignar a botones de inserción extendidos mediante el uso de estructuras EXTPUSH .

Cuando se llama a una de estas funciones de devolución de llamada, recibe un puntero a una estructura CPSUICBPARAM . Esta estructura describe la configuración de opción actual de la página e indica el evento de usuario que provocó que se llamara a la función. La función de devolución de llamada es responsable de validar y procesar la configuración. Debe mostrar un cuadro de diálogo si una configuración (o una combinación de valores) no es válida. El valor devuelto de la función indica a CPSUI si la página debe volver a reproducirse o reinicializarse.

Las funciones de devolución de llamada especificadas con este tipo de función no se pueden usar si el miembro DlgProc de la estructura DLGPAGE especifica un procedimiento de cuadro de diálogo proporcionado por la aplicación. Esto se debe a que se llama a _CPSUICALLBACK devoluciones de llamada con tipo desde los procedimientos del cuadro de diálogo de CPSUI, que no se usan si la aplicación proporciona sus propios procedimientos.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	compstui.h (incluya Compstui.h)