_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 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 le CPSUI doit effectuer.

Code de retour Description
CPSUICB_ACTION_ITEMS_APPLIED Le membre Motif 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 Motif 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 du problème.
CPSUICB_ACTION_NONE Aucune action n’est requise par CPSUI.
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 préfixé 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 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é utilisateur (par exemple, la modification du focus de 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.

En outre, les fonctions de rappel peuvent être affectées aux 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 _CPSUICALLBACK rappels typés 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

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête compstui.h (include Compstui.h)