fonction de rappel _CPSUICALLBACK (compstui.h)

Le type de fonction _CPSUICALLBACK est utilisé par les applications CPSUI (y compris les DLL d’interface d’imprimante) pour définir une fonction de rappel destinée à être utilisée en tant que gestionnaire de messages CPSUI .

Syntaxe

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Paramètres

pCPSUICBParam

Pointeur fourni par CPSUI vers une structure CPSUICBPARAM.

Valeur de retour

Une fonction de rappel _CPSUICALLBACK typée doit retourner l’une des valeurs répertoriées dans le tableau suivant. Chaque valeur indique une action que CPSUI doit effectuer.

Retourner le code	Description
CPSUICB_ACTION_ITEMS_APPLIED	Le CPSUICBPARAM structure Reason membre a été défini sur CPSUICB_REASON_APPLYNOW, et la fonction de rappel a correctement traité les valeurs d’option actuelles.
CPSUICB_ACTION_NO_APPLY_EXIT	Le CPSUICBPARAM membre Reason a été défini sur CPSUICB_REASON_APPLYNOW, mais la fonction de rappel a détecté des valeurs d’option non valides ou incompatibles. La fonction de rappel doit afficher une boîte de dialogue indiquant à l’utilisateur le problème.
CPSUICB_ACTION_NONE	Aucune action de CPSUI n’est requise.
CPSUICB_ACTION_OPTIF_CHANGED	La fonction de rappel a défini l’indicateur OPTIF_CHANGED dans une structure OPTITEM pour indiquer que l’option sélectionnée a changé ou qu’un autre indicateur avec préfixe OPTIF a changé.
CPSUICB_ACTION_REINIT_ITEMS	La fonction de rappel a défini l’indicateur de OPTIF_CHANGED dans une structure OPTITEM pour indiquer que indicateurs ou membres pData membres de la structure OPTTYPE associée ou OPTPARAM ont changé.

Remarques

Les fonctions de rappel spécifiées à l’aide du type de fonction _CPSUICALLBACK sont fournies par les applications qui utilisent CPSUI pour gérer les pages de feuille de propriétés. Si l’une de ces fonctions de rappel est associée à une page de feuille de propriétés, CPSUI l’appelle lorsque l’activité de l’utilisateur (par exemple, la modification du focus du contrôle de la page, la modification des valeurs d’option ou le fait de cliquer sur OK) est détectée.

Une fonction de rappel _CPSUICALLBACK typée est affectée à une page de feuille de propriétés en incluant son adresse dans une structure COMPROPSHEETUI, qui est passée à la fonction ComPropSheet de CPSUI lorsque le code de la fonction est CPSFUNC_ADD_PCOMPROPSHEETUI.

De plus, les fonctions de rappel peuvent être affectées à des boutons push étendus via l’utilisation de structures extPUSH.

Lorsqu’une de ces fonctions de rappel est appelée, elle reçoit un pointeur vers une structure CPSUICBPARAM. Cette structure décrit les paramètres d’option actuels de la page et indique l’événement utilisateur qui a provoqué l’appel de la fonction. La fonction de rappel est chargée de valider et de traiter les paramètres. Elle doit afficher une boîte de dialogue si un paramètre (ou une combinaison de paramètres) n’est pas valide. La valeur de retour de la fonction indique à CPSUI si la page doit être réinitialisée ou réinitialisée.

Les fonctions de rappel spécifiées avec ce type de fonction ne peuvent pas être utilisées si le membre DlgProc de la structure DLGPAGE spécifie une procédure de boîte de dialogue fournie par l’application. Cela est dû au fait que les rappels typés _CPSUICALLBACK sont appelés à partir des procédures de boîte de dialogue de CPSUI, qui ne sont pas utilisées si l’application fournit ses propres procédures.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	compstui.h (include Compstui.h)