macro PropSheet_SetWizButtons (prsht.h)

Article
10/24/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 explicitement le message PSM_SETWIZBUTTONS.

Syntaxe

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

Paramètres

hDlg

Type : HWND

Handle vers 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	Afficher 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

Type : VOID

Aucune valeur de retour.

Remarques

Cette macro utilise PostMessage pour envoyer le message PSM_SETWIZBUTTONS. Si votre gestionnaire de notifications appelle PropSheet_SetWizButtons, n’affectez pas le focus de fenêtre tant que le gestionnaire n’a pas retourné. Par exemple, si vous appelez MessageBox immédiatement après l’appel de PropSheet_SetWizButtons, la boîte 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 de messages, le message PSM_SETWIZBUTTONS ne sera remis qu’une fois que l’Assistant n’a pas perdu le focus sur la boîte de message. Par conséquent, la feuille de propriétés ne pourra pas 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 Précédent, 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, définir 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 de PSH_WIZARDHASFINISH dans la structure dwFlags membre de la structure PROPSHEETHEADER de l’Assistant lors de la création de l’Assistant. Chaque page affiche ensuite les quatre boutons.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	prsht.h

Partager via