Partager via


_CPSUICALLBACK fonction de rappel (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 comme gestionnaire de messages CPSUI.

Syntaxe

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Paramètres

pCPSUICBParam

Pointeur fourni par CPSUI vers une structure CPSUICBPARAM .

Valeur retournée

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

Code de retour Description
CPSUICB_ACTION_ITEMS_APPLIED Le membre Reason de la structure CPSUICBPARAM 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 membre Reason de la structure CPSUICBPARAM 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 OPTIF_CHANGED dans une structure OPTITEM pour indiquer que les indicateurs ou les membres pData de la structure OPTTYPE ou OPTPARAM associée ont été modifiés.

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 (telle que la modification du focus de contrôle de la page, la modification des valeurs d’option ou le clic sur OK) est détectée.

Une fonction de rappel de type _CPSUICALLBACK 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.

En outre, les fonctions de rappel peuvent être affectées à des boutons pousseurs étendus à l’aide de structures EXTPUSH .

Quand l’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 pour 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éaffiché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 de type _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.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête compstui.h (inclure Compstui.h)