Funzione di callback PCMSCALLBACKA (icm.h)
*PCMSCALLBACKA* (o ApplyCallbackFunction) è una funzione di callback implementata che aggiorna i dati di configurazione WCS durante l'esecuzione della finestra di dialogo visualizzata dalla funzione SetupColorMatchingW . Il nome ApplyCallbackFunction è un segnaposto. Il nome effettivo di questa funzione di callback viene fornito dall'applicazione tramite ICM.
Sintassi
PCMSCALLBACKA Pcmscallbacka;
BOOL Pcmscallbacka(
_tagCOLORMATCHSETUPA *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Parametri
unnamedParam1
Puntatore a una struttura COLORMATCHSETUPW che contiene 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 utilizzata 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 specificata la funzione di callback, viene visualizzato un pulsante Applica in basso a destra della finestra di dialogo. Quando si seleziona il pulsante Applica , la funzione di callback aggiorna immediatamente la configurazione per il dispositivo da configurare. 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 di 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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | icm.h |