PSM_SETWIZBUTTONS message

Active ou désactive les boutons Précédent, Suivant et Terminer dans un Assistant. Vous pouvez également utiliser la macro PropSheet_SetWizButtons pour publier le message.

Paramètres

wParam

Définissez ce paramètre sur PSWIZBF_ELEVATIONREQUIRED pour afficher l’icône avec élévation de privilèges sur les boutons spécifiés dans lParam. L’icône avec élévation de privilèges (ou icône de protection UAC) indique que l’invite d’élévation sera utilisée pour inviter l’utilisateur à approuver ou à fournir des informations d’identification. Pour plus d’informations, consultez Conception d’applications UAC pour Windows Vista.

Notes

L’affichage de l’icône de protection UAC est uniquement pris en charge dans AeroWizards (PSH_AEROWIZARD).

lParam

Valeur qui spécifie les boutons de la feuille de propriétés qui sont activés. Vous pouvez combiner un ou plusieurs des indicateurs suivants.

Valeur	Signification
PSWIZB_BACK	Active le bouton Précédent . Si cet indicateur n’est pas défini, le bouton Précédent s’affiche comme désactivé.
PSWIZB_DISABLEDFINISH	Affiche un bouton Terminer désactivé.
PSWIZB_FINISH	Affiche un bouton Terminer activé.
PSWIZB_NEXT	Active le bouton Suivant. Si cet indicateur n’est pas défini, le bouton Suivant s’affiche comme désactivé.

Valeur retournée

Pas de valeur de retour.

Notes

Si votre gestionnaire de notifications utilise PostMessage pour envoyer un message PSM_SETWIZBUTTONS , n’effectuez aucune action qui n’affectera le focus de la fenêtre qu’après le retour du gestionnaire. Par exemple, si vous appelez MessageBox immédiatement après avoir utilisé PostMessage pour envoyer PSM_SETWIZBUTTONS, la zone de message reçoit le focus. Étant donné que les messages publiés ne sont pas remis tant qu’ils n’atteignent pas le chef de la file d’attente des messages, le message PSM_SETWIZBUTTONS n’est remis qu’après que l’Assistant a perdu le focus sur la zone de message. Par conséquent, la feuille de propriétés ne sera pas en mesure de définir correctement le focus pour les boutons.

Si vous envoyez le message PSM_SETWIZBUTTONS pendant la gestion de la notification PSN_SETACTIVE , utilisez la fonction PostMessage plutôt que la fonction SendMessage . Sinon, le système ne met pas à jour les boutons correctement. Si vous utilisez la macro PropSheet_SetWizButtons pour envoyer ce message, il sera publié. À tout autre moment, vous pouvez utiliser SendMessage pour envoyer des PSM_SETWIZBUTTONS.

Les Assistants affichent trois ou quatre boutons sous chaque page. Ce message est utilisé pour spécifier les boutons activés. Les Assistants affichent normalement Retour, Annuler et un bouton Suivant ou Terminer . Vous activez généralement uniquement le bouton Suivant pour la page d’accueil, Suivant et Précédent pour les pages intérieures, et Retour et Fin pour la page d’achèvement. Le bouton Annuler est toujours activé. Normalement, la définition PSWIZB_FINISH ou PSWIZB_DISABLEDFINISH remplace le bouton Suivant par un bouton Terminer . Pour afficher simultanément les boutons Suivant et Terminer , définissez l’indicateur PSH_WIZARDHASFINISH dans le membre dwFlags de la structure PROPSHEETHEADER de l’Assistant lorsque vous créez l’Assistant. Chaque page affiche ensuite les quatre boutons.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Prsht.h