Partager via

PSM_SHOWWIZBUTTONS message

  • Article

Affiche ou masque les boutons dans un Assistant. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_ShowWizButtons .

Paramètres

wParam

Une ou plusieurs des valeurs suivantes qui spécifient les boutons de la feuille de propriétés à afficher. Si une valeur de bouton est incluse dans ce paramètre et lParam, elle est affichée.

Valeur Signification
PSWIZB_BACK
 Bouton Précédent .
PSWIZB_CANCEL
 Bouton Annuler .
PSWIZB_DISABLEDFINISH
 Bouton Terminer .
PSWIZB_FINISH
 Bouton Terminer .
PSWIZB_NEXT
 Bouton Suivant .
PSWIZB_SHOW
 Définissez uniquement cet indicateur (défini sur zéro) pour masquer tous les boutons spécifiés dans lParam.
PSWIZB_RESTORE
 Non implémenté.

lParam

Une ou plusieurs des mêmes valeurs que celles utilisées dans wParam, en spécifiant les boutons affectés par cet appel. Si une valeur de bouton apparaît dans ce paramètre, mais pas dans wParam, le bouton est masqué.

Valeur retournée

Pas de valeur de retour.

Notes

Les Assistants affichent trois ou quatre boutons sous chaque page. Ce message est utilisé pour spécifier les boutons visibles. Les Assistants affichent normalement Précédent, Annuler et un bouton Suivant ou Terminer . Le bouton Annuler est toujours visible.

En règle générale, définissez PSWIZB_FINISH ou PSWIZB_DISABLEDFINISH pour remplacer 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 lorsque vous créez l’Assistant. Chaque page affiche ensuite les quatre boutons : Précédent, Suivant, Annuler et Terminer.

Si vous utilisez la macro PropSheet_ShowWizButtons pour envoyer ce message, il sera publié. À tout autre moment, vous pouvez utiliser SendMessage pour envoyer PSM_SHOWWIZBUTTONS.

Si votre gestionnaire de notifications utilise PostMessage pour envoyer un message PSM_SHOWWIZBUTTONS , ne faites rien qui affectera le focus de la fenêtre tant que le gestionnaire n’est pas retourné. Par exemple, si vous appelez MessageBox immédiatement après avoir utilisé PostMessage pour envoyer PSM_SHOWWIZBUTTONS, la boîte de message reçoit le focus. Étant donné que les messages publiés ne sont pas remis tant qu’ils n’atteignent pas le début de la file d’attente des messages, le message PSM_SHOWWIZBUTTONS ne sera remis qu’une fois que l’Assistant aura 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.

Configuration requise

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