Struttura COLORMATCHSETUPA (icm.h)
La struttura COLORMATCHSETUP contiene informazioni utilizzate dalla funzione SetupColorMatchingW per inizializzare la finestra di dialogo ColorManagement . Dopo che l'utente chiude la finestra di dialogo, SetupColorMatching restituisce informazioni sulla selezione dell'utente in questa struttura.
Sintassi
typedef struct _tagCOLORMATCHSETUPA {
DWORD dwSize;
DWORD dwVersion;
DWORD dwFlags;
HWND hwndOwner;
PCSTR pSourceName;
PCSTR pDisplayName;
PCSTR pPrinterName;
DWORD dwRenderIntent;
DWORD dwProofingIntent;
PSTR pMonitorProfile;
DWORD ccMonitorProfile;
PSTR pPrinterProfile;
DWORD ccPrinterProfile;
PSTR pTargetProfile;
DWORD ccTargetProfile;
DLGPROC lpfnHook;
LPARAM lParam;
PCMSCALLBACKA lpfnApplyCallback;
LPARAM lParamApplyCallback;
} COLORMATCHSETUPA, *PCOLORMATCHSETUPA, *LPCOLORMATCHSETUPA;
Members
dwSize
Dimensioni della struttura. Deve essere impostato su sizeof ( COLORMATCHSETUP ).
dwVersion
Versione della struttura COLORMATCHSETUP . Deve essere impostato su COLOR_MATCH_VERSION.
dwFlags
Set di flag di bit utilizzati per inizializzare la finestra di dialogo. Se impostato su 0 nella voce, tutti i controlli presuppongono i relativi stati predefiniti.
Quando la finestra di dialogo viene restituita, questi flag vengono impostati per indicare l'input dell'utente.
Questo membro può essere impostato usando una combinazione dei flag seguenti.
| Flag | Significato |
|---|---|
| CMS_DISABLEICM | Se impostato sulla voce, questo flag indica che la casella di controllo "Abilita gestione colori" è deselezionata, disabilitando tutti gli altri controlli. Se impostato all'uscita, significa che l'utente non desidera eseguire la gestione dei colori. |
| CMS_ENABLEPROOFING | Se impostato sulla voce, questo flag indica che i controlli di correzione devono essere abilitati e la casella di controllo Correzione è selezionata. Se impostato all'uscita, significa che l'utente desidera eseguire la gestione dei colori per un dispositivo di destinazione diverso rispetto alla stampante selezionata. |
| CMS_SETRENDERINTENT | Se impostato sulla voce, questo flag indica che il membro dwRenderIntent contiene il valore da utilizzare per inizializzare il controllo Finalità di rendering. In caso contrario, per impostazione predefinita il controllo rendering immagine. Questo flag viene impostato all'uscita se WCS è abilitato. |
| CMS_SETPROOFINTENT | Ignorato, a meno che non sia impostato anche CMS_ENABLEPROOFING. Se impostato sulla voce e CMS_ENABLEPROOFING viene impostato anche, questo flag indica che il membro dwProofingIntent deve essere utilizzato per inizializzare il controllo Finalità rendering di destinazione. In caso contrario, per impostazione predefinita il controllo rendering immagine. Questo flag viene impostato all'uscita se la correzione è abilitata. |
| CMS_SETMONITORPROFILE | Se impostato sulla voce, questo flag indica che il profilo di gestione dei colori denominato nel membro pMonitorProfile deve essere la selezione iniziale nel controllo profilo di monitoraggio. Se il profilo specificato non è associato al monitoraggio, questo flag viene ignorato e viene usato il profilo predefinito per il monitoraggio. |
| CMS_SETPRINTERPROFILE | Se impostato sulla voce, questo flag indica che il profilo di gestione dei colori denominato nel membro pPrinterProfile deve essere la selezione iniziale nel controllo profilo stampante. Se il profilo specificato non è associato alla stampante, questo flag viene ignorato e viene utilizzato il profilo predefinito per la stampante. |
| CMS_SETTARGETPROFILE | Se impostato sulla voce, questo flag indica che il profilo colore denominato nel membro pTargetProfile deve essere la selezione iniziale nel controllo profilo di destinazione. Se il profilo specificato non è installato, questo flag viene ignorato e viene utilizzato il profilo predefinito per la stampante. Se la stampante non ha un profilo predefinito, verrà visualizzato il primo profilo in ordine alfabetico. |
| CMS_USEHOOK | Questo flag specifica che il membro lpfnHook contiene l'indirizzo di una routine hook e il membro lParam contiene un valore da passare alla routine hook quando viene inviato il messaggio WM_INITDIALOG. |
| CMS_MONITOROVERFLOW | Questo flag viene impostato all'uscita se la gestione dei colori deve essere abilitata e le dimensioni del buffer specificate in ccMonitorProfile non sono sufficienti per il nome del profilo selezionato. GetLastError restituisce ERROR_INSUFFICIENT_BUFFER in tal caso. |
| CMS_PRINTERROVERFLOW | Questo flag viene impostato all'uscita se la gestione dei colori deve essere abilitata e le dimensioni del buffer specificate in ccPrinterProfile non sono sufficienti per il nome del profilo selezionato. GetLastError restituisce ERROR_INSUFFICIENT_BUFFER in tal caso. |
| CMS_TARGETOVERFLOW | Questo flag viene impostato all'uscita se la correzione deve essere abilitata e le dimensioni del buffer specificate in ccTargetProfile non sono sufficienti per il nome del profilo selezionato. GetLastError restituisce ERROR_INSUFFICIENT_BUFFER in tal caso. |
| CMS_USEAPPLYCALLBACK | Se impostato sulla voce, questo flag indica che la funzione SetupColorMatching deve chiamare la funzione PCMSCALLBACKW. L'indirizzo della funzione di callback è contenuto in lpfnApplyCallback. |
| CMS_USEDESCRIPTION | Se impostato sulla voce, questo flag indica alla funzione SetupColorMatching di recuperare la descrizione del profilo contenuta nei tag di descrizione del profilo (vedere la specifica del formato del profilo CPI v3.4). Verranno inseriti nelle caselle di modifica Profilo monitor, Profilo stampante, Profilo dispositivo emulato nella finestra di dialogo Comune gestione colori . |
hwndOwner
Handle della finestra al proprietario della finestra di dialogo oppure NULL se la finestra di dialogo non ha proprietario.
pSourceName
Puntatore a una stringa specificata dall'applicazione che descrive il profilo di origine dell'elemento per cui deve essere eseguita la gestione dei colori. Se è NULL, il controllo Origine immagine visualizza il nome del profilo colore predefinito di Windows.
pDisplayName
Punta a una stringa che denomina il monitor da usare per la gestione dei colori. Se questo non è il nome di un monitoraggio valido, viene usato il primo monitoraggio enumerato.
pPrinterName
Punta a una stringa che denomina la stampante in cui deve essere eseguito il rendering dell'immagine. Se non si tratta di un nome di stampante valido, la stampante predefinita viene utilizzata e denominata nella finestra di dialogo.
dwRenderIntent
Tipo di gestione dei colori desiderato. I valori validi sono:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Per altre informazioni, vedere Finalità di rendering.
dwProofingIntent
Tipo di gestione dei colori desiderato per l'immagine a prova. I valori validi sono:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Per altre informazioni, vedere Finalità di rendering.
pMonitorProfile
Puntatore a un buffer in cui inserire il nome del profilo di monitoraggio selezionato dall'utente. Se viene usato il flag CMS_SETMONITORPROFILE, questo flag può essere usato anche per selezionare un profilo diverso dal valore predefinito del monitoraggio quando viene visualizzata per la prima volta la finestra di dialogo.
ccMonitorProfile
Dimensioni del buffer a cui punta il membro pMonitorProfile , in caratteri. Se il buffer non è sufficientemente grande da contenere il nome selezionato, il nome viene troncato a questa dimensione e viene restituito ERROR_INSUFFICIENT_BUFFER. Un buffer di dimensioni MAX_PATH funziona sempre.
pPrinterProfile
Punta a un buffer in cui inserire il nome del profilo della stampante selezionato dall'utente. Se viene utilizzato il flag CMS_SETPRINTERPROFILE, questo flag può essere utilizzato anche per selezionare un profilo diverso da quello predefinito della stampante quando viene visualizzata per la prima volta la finestra di dialogo.
ccPrinterProfile
Dimensioni del buffer a cui punta il membro pPrinterProfile , in caratteri. Se il buffer non è sufficientemente grande da contenere il nome selezionato, il nome viene troncato a questa dimensione e viene restituito ERROR_INSUFFICIENT_BUFFER. Un buffer di dimensioni MAX_PATH funziona sempre.
pTargetProfile
Punta a un buffer in cui inserire il nome del profilo di destinazione selezionato dall'utente per la correzione. Se viene utilizzato il flag CMS_SETTARGETPROFILE, è anche possibile utilizzare questo flag per selezionare un profilo diverso da quello predefinito della stampante quando viene visualizzata per la prima volta la finestra di dialogo.
ccTargetProfile
Dimensioni del buffer a cui punta il membro pTargetProfile , in caratteri. Se il buffer non è sufficientemente grande da contenere il nome selezionato, il nome viene troncato a questa dimensione e viene restituito ERROR_INSUFFICIENT_BUFFER. Un buffer di dimensioni MAX_PATH funziona sempre.
lpfnHook
Se il flag CMS_USEHOOK è impostato, questo membro è l'indirizzo di una procedura di dialogo (vedere DialogProc ) in grado di filtrare o gestire i messaggi per la finestra di dialogo. La procedura hook non riceve alcun messaggio emesso prima di WM_INITDIALOG. Viene chiamato sul messaggio WM_INITDIALOG dopo che la procedura di dialogo fornita dal sistema ha elaborato il messaggio. In tutti gli altri messaggi, la routine hook riceve il messaggio prima della procedura fornita dal sistema. Se la routine hook restituisce TRUE a questi messaggi, la routine fornita dal sistema non viene chiamata.
La routine hook può chiamare la funzione EndDialog .
lParam
Se il flag CMS_USEHOOK è impostato, questo membro viene passato alla routine hook fornita dall'applicazione come parametro lParam quando viene elaborato il messaggio WM_INITDIALOG.
lpfnApplyCallback
Contiene un puntatore a una funzione di callback richiamata quando viene selezionato il pulsante Applica della finestra di dialogo Gestione colori. Se non viene fornita alcuna funzione di callback, questo membro deve essere impostato su NULL. Vedere PCMSCALLBACKW.
lParamApplyCallback
Contiene un valore che verrà passato alla funzione ApplyCallbackFunction tramite il relativo parametro lParam . Il significato e il contenuto del valore sono specificati dall'applicazione.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | icm.h |