STRUCTURE COLORMATCHSETUPW (icm.h)
La structure COLORMATCHSETUP contient des informations que la fonction SetupColorMatchingW utilise pour initialiser la boîte de dialogue ColorManagement . Une fois la boîte de dialogue fermée par l’utilisateur, SetupColorMatching retourne des informations sur la sélection de l’utilisateur dans cette structure.
Syntaxe
typedef struct _tagCOLORMATCHSETUPW {
DWORD dwSize;
DWORD dwVersion;
DWORD dwFlags;
HWND hwndOwner;
PCWSTR pSourceName;
PCWSTR pDisplayName;
PCWSTR pPrinterName;
DWORD dwRenderIntent;
DWORD dwProofingIntent;
PWSTR pMonitorProfile;
DWORD ccMonitorProfile;
PWSTR pPrinterProfile;
DWORD ccPrinterProfile;
PWSTR pTargetProfile;
DWORD ccTargetProfile;
DLGPROC lpfnHook;
LPARAM lParam;
PCMSCALLBACKW lpfnApplyCallback;
LPARAM lParamApplyCallback;
} COLORMATCHSETUPW, *PCOLORMATCHSETUPW, *LPCOLORMATCHSETUPW;
Membres
dwSize
Taille de la structure. Doit être défini sur sizeof ( COLORMATCHSETUP ).
dwVersion
Version de la structure COLORMATCHSETUP . Cette valeur doit être définie sur COLOR_MATCH_VERSION.
dwFlags
Ensemble d’indicateurs de bits utilisés pour initialiser la boîte de dialogue. Si la valeur est 0 lors de l’entrée, tous les contrôles supposent leur état par défaut.
Lorsque la boîte de dialogue retourne, ces indicateurs sont définis pour indiquer l’entrée de l’utilisateur.
Ce membre peut être défini à l’aide d’une combinaison des indicateurs suivants.
| Indicateur | Signification |
|---|---|
| CMS_DISABLEICM | S’il est défini lors de l’entrée, cet indicateur indique que la zone de case activée « Activer la gestion des couleurs » est désactivée, désactivant tous les autres contrôles. Si la valeur est définie à la sortie, cela signifie que l’utilisateur ne souhaite pas que la gestion des couleurs soit effectuée. |
| CMS_ENABLEPROOFING | S’il est défini lors de l’entrée, cet indicateur indique que les contrôles de vérification doivent être activés et que la case Vérification case activée est cochée. Si la valeur est définie à la sortie, cela signifie que l’utilisateur souhaite effectuer la gestion des couleurs pour un appareil cible différent de l’imprimante sélectionnée. |
| CMS_SETRENDERINTENT | S’il est défini sur l’entrée, cet indicateur indique que le membre dwRenderIntent contient la valeur à utiliser pour initialiser le contrôle Intention de rendu. Sinon, la valeur par défaut du contrôle est Rendu d’image. Cet indicateur est défini lors de la sortie si WCS est activé. |
| CMS_SETPROOFINTENT | Ignoré, sauf si CMS_ENABLEPROOFING est également défini. S’il est défini lors de l’entrée et que CMS_ENABLEPROOFING est également défini, cet indicateur indique que le membre dwProofingIntent doit être utilisé pour initialiser le contrôle Intention de rendu cible. Sinon, la valeur par défaut du contrôle est Rendu d’image. Cet indicateur est défini à la sortie si la vérification linguistique est activée. |
| CMS_SETMONITORPROFILE | S’il est défini lors de l’entrée, cet indicateur indique que le profil de gestion des couleurs nommé dans le membre pMonitorProfile doit être la sélection initiale dans le contrôle de profil du moniteur. Si le profil spécifié n’est pas associé au moniteur, cet indicateur est ignoré et le profil par défaut du moniteur est utilisé. |
| CMS_SETPRINTERPROFILE | S’il est défini lors de l’entrée, cet indicateur indique que le profil de gestion des couleurs nommé dans le membre pPrinterProfile doit être la sélection initiale dans le contrôle de profil d’imprimante. Si le profil spécifié n’est pas associé à l’imprimante, cet indicateur est ignoré et le profil par défaut de l’imprimante est utilisé. |
| CMS_SETTARGETPROFILE | S’il est défini lors de l’entrée, cet indicateur indique que le profil de couleur nommé dans le membre pTargetProfile doit être la sélection initiale dans le contrôle de profil cible. Si le profil spécifié n’est pas installé, cet indicateur est ignoré et le profil par défaut de l’imprimante est utilisé. Si l’imprimante n’a pas de profil par défaut, le premier profil par ordre alphabétique s’affiche. |
| CMS_USEHOOK | Cet indicateur spécifie que le membre lpfnHook contient l’adresse d’une procédure de hook et que le membre lParam contient une valeur à passer à la procédure de hook lorsque le message WM_INITDIALOG est envoyé. |
| CMS_MONITOROVERFLOW | Cet indicateur est défini à la sortie si la gestion des couleurs doit être activée et si la taille de mémoire tampon indiquée dans ccMonitorProfile est insuffisante pour le nom de profil sélectionné. GetLastError retourne ERROR_INSUFFICIENT_BUFFER dans ce cas. |
| CMS_PRINTERROVERFLOW | Cet indicateur est défini à la sortie si la gestion des couleurs doit être activée et si la taille de mémoire tampon indiquée dans ccPrinterProfile est insuffisante pour le nom de profil sélectionné. GetLastError retourne ERROR_INSUFFICIENT_BUFFER dans ce cas. |
| CMS_TARGETOVERFLOW | Cet indicateur est défini à la sortie si la vérification linguistique doit être activée et si la taille de mémoire tampon indiquée dans ccTargetProfile est insuffisante pour le nom de profil sélectionné. GetLastError retourne ERROR_INSUFFICIENT_BUFFER dans ce cas. |
| CMS_USEAPPLYCALLBACK | Si défini lors de l’entrée, cet indicateur indique que la fonction SetupColorMatching doit appeler la fonction PCMSCALLBACKW. L’adresse de la fonction de rappel est contenue dans lpfnApplyCallback. |
| CMS_USEDESCRIPTION | S’il est défini lors de l’entrée, cet indicateur indique à la fonction SetupColorMatching de récupérer la description de profil contenue dans les étiquettes de description du profil (voir Spécification de format de profil ICC v3.4). Il les insère dans les zones d’édition Profil du moniteur, Profil d’imprimante et Profil d’appareil émulé de la boîte de dialogue Gestion des couleurs commune. |
hwndOwner
Handle de fenêtre pour le propriétaire de la boîte de dialogue, ou NULL si la boîte de dialogue n’a pas de propriétaire.
pSourceName
Pointeur vers une chaîne spécifiée par l’application qui décrit le profil source de l’élément pour lequel la gestion des couleurs doit être effectuée. Si cette valeur est NULL, le contrôle Source d’image affiche le nom du profil de couleur par défaut De Windows.
pDisplayName
Pointe vers une chaîne nommant le moniteur à utiliser pour la gestion des couleurs. S’il ne s’agit pas du nom d’un moniteur valide, le premier moniteur énuméré est utilisé.
pPrinterName
Pointe vers une chaîne nommant l’imprimante sur laquelle l’image doit être affichée. S’il ne s’agit pas d’un nom d’imprimante valide, l’imprimante par défaut est utilisée et nommée dans la boîte de dialogue.
dwRenderIntent
Type de gestion des couleurs souhaité. Les valeurs autorisées sont :
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Pour plus d’informations, consultez Intentions de rendu.
dwProofingIntent
Type de gestion des couleurs souhaité pour l’image avec preuve. Les valeurs autorisées sont :
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Pour plus d’informations, consultez Intentions de rendu.
pMonitorProfile
Pointeur vers une mémoire tampon dans laquelle placer le nom du profil d’analyse sélectionné par l’utilisateur. Si l’indicateur CMS_SETMONITORPROFILE est utilisé, cet indicateur peut également être utilisé pour sélectionner un profil autre que le profil par défaut du moniteur lorsque la boîte de dialogue est affichée pour la première fois.
ccMonitorProfile
Taille de la mémoire tampon pointée vers le membre pMonitorProfile , en caractères. Si la mémoire tampon n’est pas assez grande pour contenir le nom sélectionné, le nom est tronqué à cette taille et ERROR_INSUFFICIENT_BUFFER est retourné. Une mémoire tampon de MAX_PATH taille fonctionne toujours.
pPrinterProfile
Pointe vers une mémoire tampon dans laquelle placer le nom du profil d’imprimante sélectionné par l’utilisateur. Si l’indicateur CMS_SETPRINTERPROFILE est utilisé, cet indicateur peut également être utilisé pour sélectionner un profil autre que celui par défaut de l’imprimante lorsque la boîte de dialogue est affichée pour la première fois.
ccPrinterProfile
Taille de la mémoire tampon pointée vers le membre pPrinterProfile , en caractères. Si la mémoire tampon n’est pas assez grande pour contenir le nom sélectionné, le nom est tronqué à cette taille et ERROR_INSUFFICIENT_BUFFER est retourné. Une mémoire tampon de MAX_PATH taille fonctionne toujours.
pTargetProfile
Pointe vers une mémoire tampon dans laquelle placer le nom du profil cible sélectionné par l’utilisateur pour la vérification linguistique. Si l’indicateur CMS_SETTARGETPROFILE est utilisé, cet indicateur peut également être utilisé pour sélectionner un profil autre que l’imprimante par défaut lors de la première affichage de la boîte de dialogue.
ccTargetProfile
Taille de la mémoire tampon pointée vers le membre pTargetProfile , en caractères. Si la mémoire tampon n’est pas assez grande pour contenir le nom sélectionné, le nom est tronqué à cette taille et ERROR_INSUFFICIENT_BUFFER est retourné. Une mémoire tampon de MAX_PATH taille fonctionne toujours.
lpfnHook
Si l’indicateur CMS_USEHOOK est défini, ce membre est l’adresse d’une procédure de boîte de dialogue (voir DialogProc ) qui peut filtrer ou gérer les messages pour la boîte de dialogue. La procédure de hook ne reçoit aucun message émis avant WM_INITDIALOG. Il est appelé sur le message WM_INITDIALOG une fois que la procédure de boîte de dialogue fournie par le système a traité le message. Sur tous les autres messages, la procédure de crochet reçoit le message avant la procédure fournie par le système. Si la procédure de hook retourne TRUE à ces messages, la procédure fournie par le système n’est pas appelée.
La procédure de hook peut appeler la fonction EndDialog .
lParam
Si l’indicateur CMS_USEHOOK est défini, ce membre est passé à la procédure de hook fournie par l’application en tant que paramètre lParam lorsque le message WM_INITDIALOG est traité.
lpfnApplyCallback
Contient un pointeur vers une fonction de rappel appelée lorsque le bouton Appliquer de la boîte de dialogue Gestion des couleurs est sélectionné. Si aucune fonction de rappel n’est fournie, ce membre doit être défini sur NULL. Consultez PCMSCALLBACKW.
lParamApplyCallback
Contient une valeur qui sera transmise à la fonction ApplyCallbackFunction via son paramètre lParam . La signification et le contenu de la valeur sont spécifiés par l’application.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | icm.h |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour