macro PropSheet_SetWizButtons (prsht.h)

Article
03/04/2024

Active ou désactive les boutons Précédent, Suivant et Terminer dans un Assistant en publiant un message PSM_SETWIZBUTTONS . Vous pouvez utiliser cette macro ou envoyer le message PSM_SETWIZBUTTONS explicitement.

Syntaxe

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

Paramètres

hDlg

Type : HWND

Gérez la feuille de propriétés.

dwFlags

Type : DWORD

Valeur qui spécifie les boutons de l’Assistant activés. Vous pouvez combiner un ou plusieurs des indicateurs suivants.

Valeur	Signification
PSWIZB_BACK	Activez 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	Afficher un bouton Terminer désactivé.
PSWIZB_FINISH	Affichez un bouton Terminer activé.
PSWIZB_NEXT	Activez le bouton Suivant. Si cet indicateur n’est pas défini, le bouton Suivant s’affiche comme désactivé.

Valeur de retour

None

Remarques

Cette macro utilise PostMessage pour envoyer le message PSM_SETWIZBUTTONS . Si votre gestionnaire de notifications appelle PropSheet_SetWizButtons, ne faites rien pour affecter le focus de la fenêtre jusqu’à ce que le gestionnaire soit retourné. Par exemple, si vous appelez MessageBox immédiatement après l’appel de PropSheet_SetWizButtons, la zone de message reçoit le focus. Étant donné que les messages envoyés avec PostMessage ne sont pas remis tant qu’ils n’atteignent pas le début de la file d’attente des messages, le message PSM_SETWIZBUTTONS n’est remis qu’après que l’Assistant ait 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.

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 le PSH_WIZARDHASFINISH FLAG dans le membre dwFlags de la structure PROPSHEETHEADER de l’Assistant lorsque vous créez l’Assistant. Chaque page affiche ensuite les quatre boutons.

Configuration requise

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]
Plateforme cible	Windows
En-tête	prsht.h

Partager via