макрос PropSheet_SetWizButtons (prsht.h)

Статья
10/24/2024

Включает или отключает кнопки "Назад", "Далее" и "Готово" в мастере, публикуя сообщение PSM_SETWIZBUTTONS. Этот макрос можно использовать или явно отправить сообщение PSM_SETWIZBUTTONS.

Синтаксис

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

Параметры

hDlg

Тип: HWND

Дескриптор на лист свойств.

dwFlags

Тип: DWORD

Значение, указывающее, какие кнопки мастера включены. Вы можете объединить один или несколько следующих флагов.

Ценность	Значение
PSWIZB_BACK	Включите кнопку "Назад". Если этот флаг не задан, кнопка "Назад" отображается как отключенная.
PSWIZB_DISABLEDFINISH	Отображение отключенной кнопки "Готово".
PSWIZB_FINISH	Отображение включенной кнопки "Готово".
PSWIZB_NEXT	Включите кнопку "Далее". Если этот флаг не задан, кнопка "Далее" отображается как отключенная.

Возвращаемое значение

Тип: VOID

Возвращаемое значение не возвращается.

Замечания

Этот макрос использует PostMessage для отправки сообщения PSM_SETWIZBUTTONS. Если обработчик уведомлений вызывает PropSheet_SetWizButtons, ничего не повлияет на фокус окна до тех пор, пока обработчик не возвращается. Например, при вызове MessageBox сразу после вызова PropSheet_SetWizButtonsпоявится фокус сообщения. Так как сообщения, отправленные с PostMessage, не доставляются до тех пор, пока они не достигают головы очереди сообщений, PSM_SETWIZBUTTONS сообщение не будет доставлено до тех пор, пока мастер не потерял фокус на поле сообщения. В результате лист свойств не сможет правильно задать фокус для кнопок.

Мастера отображают три или четыре кнопки под каждой страницей. Это сообщение используется для указания включенных кнопок. Мастера обычно отображают кнопку "Назад", "Отмена" и "Далее" или "Готово". Обычно для страницы приветствия включена только кнопка "Далее" и "Назад" для внутренних страниц, а также "Назад" и "Готово" для страницы завершения. Кнопка "Отмена" всегда включена. Обычно параметр PSWIZB_FINISH или PSWIZB_DISABLEDFINISH заменяет кнопку "Далее" кнопкой "Готово". Чтобы одновременно отображать кнопки next и Finish, задайте флаг PSH_WIZARDHASFINISH в dwFlags член структуры PROPSHEETHEADER мастера при создании мастера. На каждой странице будут отображаться все четыре кнопки.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	prsht.h

Поделиться через