Partager via

STRUCTURE COLORMATCHSETUPW (icm.h)

  • Article

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