PropSheet_ShowWizButtons macro (prsht.h)

Article
10/23/2024

Show or hide buttons in a wizard. You can use this macro or send the PSM_SHOWWIZBUTTONS message explicitly.

Syntax

VOID PropSheet_ShowWizButtons(
   HWND  hDlg,
   DWORD dwFlag,
   DWORD dwButton
);

Parameters

hDlg

Type: HWND

Handle to the wizard.

dwFlag

Type: DWORD

One or more of the following values that specify which property sheet buttons are to be shown. If a button value is included in both this parameter and dwButton then it is shown.

Value	Meaning
PSWIZB_BACK	0x0001. The Back button.
PSWIZB_NEXT	0x0002. The Next button.
PSWIZB_FINISH	0x0004. The Finish button.
PSWIZB_CANCEL	0x0010. The Cancel button.
PSWIZB_SHOW	Set only this flag (defined as zero) to hide all buttons specified in dwButton.
PSWIZB_RESTORE	Not implemented.

dwButton

Type: DWORD

One or more of the same values used in dwFlag. Here, they specify which property sheet buttons are to be shown or hidden. If a button value appears in this parameter but not in dwFlag, it indicates that the button should be hidden.

Return value

Type: VOID

This macro does not return a value.

Remarks

The following example code hides the Back button and shows the Next button.

PropSheet_ShowWizButtons(hwnd,
                         PSWIZB_NEXT,
                         PSWIZB_BACK | PSWIZB_NEXT);

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	prsht.h

Share via