Fonction de rappel PCMSCALLBACKA (icm.h)

Article
08/24/2023

*PCMSCALLBACKA* (ou ApplyCallbackFunction) est une fonction de rappel que vous implémentez qui met à jour les données de configuration WCS pendant l’exécution de la boîte de dialogue affichée par la fonction SetupColorMatchingW . Le nom ApplyCallbackFunction est un espace réservé. Le nom réel de cette fonction de rappel est fourni par votre application à l’aide d’ICM.

Syntaxe

PCMSCALLBACKA Pcmscallbacka;

BOOL Pcmscallbacka(
  _tagCOLORMATCHSETUPA *unnamedParam1,
  LPARAM unnamedParam2
)
{...}

Paramètres

unnamedParam1

Pointeur vers une structure COLORMATCHSETUPW qui contient des données de configuration WCS.

unnamedParam2

Contient une valeur fournie par l’application.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. La fonction de rappel peut définir les informations d’erreur étendues en appelant SetLastError.

Remarques

La fonction ApplyCallbackFunction permet de modifier la configuration WCS d’un appareil pendant que la boîte de dialogue Gestion des couleurs s’affiche. La boîte de dialogue Gestion des couleurs est affichée par la fonction SetupColorMatchingW .

Si la fonction de rappel est fournie, un bouton Appliquer s’affiche dans le coin inférieur droit de la boîte de dialogue. Lorsque vous sélectionnez le bouton Appliquer , la fonction de rappel met immédiatement à jour la configuration de l’appareil en cours de configuration. La boîte de dialogue Gestion des couleurs reste à l’écran.

Une application fournit une fonction de rappel à WCS en stockant l’adresse de la fonction de rappel dans la structure COLORMATCHSETUPW qui est passée à la fonction SetupColorMatchingW . L’adresse est stockée dans le membre lPfnApplyCallback de la structure COLORMATCHSETUP . Le membre dwFlags doit être défini sur CMS_USEAPPLYCALLBACK, sinon la fonction de rappel est ignorée.

Une valeur fournie par l’application peut être passée à la fonction de rappel. Avant d’appeler la fonction SetupColorMatchingW , l’application peut stocker une valeur dans le membre lParamApplyCallback de la structure COLORMATCHSETUPW . Lorsque la fonction de rappel est appelée, la valeur dans le membre de structure lParamApplyCallback est passée à la fonction de rappel dans son paramètre lParam .

La fonction de rappel est entièrement facultative. S’il n’est pas fourni, le bouton Appliquer n’apparaît pas dans la boîte de dialogue Gestion des couleurs. Microsoft recommande vivement que votre application fournisse une fonction de rappel.

Configuration requise

Condition requise	Valeur
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

Partager via