Función de devolución de llamada PCMSCALLBACKW (icm.h)
*PCMSCALLBACKW* (o ApplyCallbackFunction) es una función de devolución de llamada que se implementa que actualiza los datos de configuración de WCS mientras se ejecuta el cuadro de diálogo mostrado por la función SetupColorMatchingW . El nombre ApplyCallbackFunction es un marcador de posición. La aplicación proporciona el nombre real de esta función de devolución de llamada mediante ICM.
Sintaxis
PCMSCALLBACKW Pcmscallbackw;
BOOL Pcmscallbackw(
_tagCOLORMATCHSETUPW *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Parámetros
unnamedParam1
Puntero a una estructura COLORMATCHSETUPW que contiene datos de configuración de WCS.
unnamedParam2
Contiene un valor proporcionado por la aplicación.
Valor devuelto
Si esta función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en esta función, el valor devuelto es FALSE. La función de devolución de llamada puede establecer la información de error extendida llamando a SetLastError.
Comentarios
La función ApplyCallbackFunction se usa para cambiar la configuración de WCS de un dispositivo mientras se muestra el cuadro de diálogo Administración de colores. La función SetupColorMatchingW muestra el cuadro de diálogo Administración de colores.
Si se proporciona la función de devolución de llamada, se muestra un botón Aplicar en la parte inferior derecha del cuadro de diálogo. Al seleccionar el botón Aplicar , la función de devolución de llamada actualiza inmediatamente la configuración del dispositivo que se está configurando. El cuadro de diálogo Administración de colores permanece en la pantalla.
Una aplicación proporciona una función de devolución de llamada a WCS almacenando la dirección de la función de devolución de llamada en la estructura COLORMATCHSETUPW que se pasa a la función SetupColorMatchingW . La dirección se almacena en el miembro lPfnApplyCallback de la estructura COLORMATCHSETUP . El miembro dwFlags debe establecerse en CMS_USEAPPLYCALLBACK o se omitirá la función de devolución de llamada.
Se puede pasar un valor proporcionado por la aplicación a la función de devolución de llamada. Antes de invocar la función SetupColorMatchingW , la aplicación puede almacenar un valor en el miembro lParamApplyCallback de la estructura COLORMATCHSETUPW . Cuando se invoca la función de devolución de llamada, el valor del miembro de estructura lParamApplyCallback se pasará a la función de devolución de llamada en su parámetro lParam .
La función de devolución de llamada es completamente opcional. Si no se proporciona, el botón Aplicar no aparece en el cuadro de diálogo Administración de colores. Microsoft recomienda encarecidamente que la aplicación proporciona una función de devolución de llamada.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |