Funzione di callback PCMSCALLBACKW (icm.h)
*PCMSCALLBACKW* (o ApplyCallbackFunction) è una funzione di callback che si implementa che aggiorna i dati di configurazione WCS mentre la finestra di dialogo visualizzata dalla funzione SetupColorMatchingW viene eseguita. Il nome ApplyCallbackFunction è un segnaposto. Il nome effettivo di questa funzione di callback viene fornito dall'applicazione usando ICM.
Sintassi
PCMSCALLBACKW Pcmscallbackw;
BOOL Pcmscallbackw(
_tagCOLORMATCHSETUPW *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Parametri
unnamedParam1
Puntatore a una struttura COLORMATCHSETUPW contenente i dati di configurazione WCS.
unnamedParam2
Contiene un valore fornito dall'applicazione.
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è TRUE.
Se questa funzione ha esito negativo, il valore restituito è FALSE. La funzione di callback può impostare le informazioni di errore estese chiamando SetLastError.
Commenti
La funzione ApplyCallbackFunction viene usata per modificare la configurazione WCS per un dispositivo mentre viene visualizzata la finestra di dialogo Gestione colori. La finestra di dialogo Gestione colori viene visualizzata dalla funzione SetupColorMatchingW .
Se viene fornita la funzione di callback, viene visualizzato un pulsante Applica nella parte inferiore destra della finestra di dialogo. Quando si seleziona il pulsante Applica , la funzione callback aggiorna immediatamente la configurazione per il dispositivo configurato. La finestra di dialogo Gestione colori rimane sullo schermo.
Un'applicazione fornisce una funzione di callback a WCS archiviando l'indirizzo della funzione di callback nella struttura COLORMATCHSETUPW passata alla funzione SetupColorMatchingW . L'indirizzo viene archiviato nel membro lPfnApplyCallback della struttura COLORMATCHSETUP . Il membro dwFlags deve essere impostato su CMS_USEAPPLYCALLBACK oppure la funzione di callback verrà ignorata.
Un valore fornito dall'applicazione può essere passato alla funzione di callback. Prima di richiamare la funzione SetupColorMatchingW , l'applicazione può archiviare un valore nel membro lParamApplyCallback della struttura COLORMATCHSETUPW . Quando viene richiamata la funzione di callback, il valore nel membro della struttura lParamApplyCallback verrà passato alla funzione callback nel parametro lParam .
La funzione di callback è completamente facoltativa. Se non viene specificato, il pulsante Applica non viene visualizzato nella finestra di dialogo Gestione colori. Microsoft consiglia vivamente che l'applicazione fornisca una funzione di callback.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | icm.h |