PropSheet_SetWizButtons Makro (prsht.h)

  • Artikel

Aktiviert oder deaktiviert die Schaltflächen "Zurück", "Weiter" und "Beenden" in einem Assistenten, indem eine PSM_SETWIZBUTTONS Nachricht veröffentlicht wird. Sie können dieses Makro verwenden oder die PSM_SETWIZBUTTONS Nachricht explizit senden.

Syntax

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

Parameter

hDlg

Typ: HWND

Handle mit dem Eigenschaftenblatt.

dwFlags

Typ: DWORD

Ein Wert, der angibt, welche Assistentenschaltflächen aktiviert sind. Sie können mindestens eins der folgenden Flags kombinieren.

Wert Bedeutung
PSWIZB_BACK
 Aktivieren Sie die Schaltfläche Zurück. Wenn dieses Flag nicht festgelegt ist, wird die Schaltfläche Zurück als deaktiviert angezeigt.
PSWIZB_DISABLEDFINISH
 Zeigt eine deaktivierte Schaltfläche Fertig stellen an.
PSWIZB_FINISH
 Zeigt eine aktivierte Schaltfläche Fertig stellen an.
PSWIZB_NEXT
 Aktivieren Sie die Schaltfläche Weiter. Wenn dieses Flag nicht festgelegt ist, wird die Schaltfläche Weiter als deaktiviert angezeigt.

Rückgabewert

Keine

Bemerkungen

Dieses Makro verwendet PostMessage , um die PSM_SETWIZBUTTONS Nachricht zu senden. Wenn Ihr Benachrichtigungshandler PropSheet_SetWizButtons aufruft, tun Sie nichts, was sich auf den Fensterfokus auswirkt, bis der Handler zurückgegeben wird. Wenn Sie beispielsweise MessageBox unmittelbar nach dem Aufruf PropSheet_SetWizButtons aufrufen, erhält das Meldungsfeld den Fokus. Da mit PostMessage gesendete Nachrichten erst zugestellt werden, wenn sie den Kopf der Nachrichtenwarteschlange erreichen, wird die PSM_SETWIZBUTTONS Nachricht erst zugestellt, nachdem der Assistent den Fokus auf das Meldungsfeld verloren hat. Infolgedessen kann das Eigenschaftenblatt den Fokus für die Schaltflächen nicht ordnungsgemäß festlegen.

Assistenten zeigen entweder drei oder vier Schaltflächen unter jeder Seite an. Diese Meldung wird verwendet, um anzugeben, welche Schaltflächen aktiviert sind. Assistenten zeigen normalerweise die Schaltfläche "Zurück", "Abbrechen" und "Weiter" oder "Fertig stellen" an. Sie aktivieren in der Regel nur die Schaltfläche Weiter für die Willkommensseite, Weiter und Zurück für innenseitige Seiten sowie Zurück und Fertig stellen für die Abschlussseite. Die Schaltfläche Abbrechen ist immer aktiviert. Normalerweise ersetzt das Festlegen PSWIZB_FINISH oder PSWIZB_DISABLEDFINISH die Schaltfläche Weiter durch eine Schaltfläche Fertig stellen. Um die Schaltflächen "Weiter" und "Fertig stellen" gleichzeitig anzuzeigen, legen Sie beim Erstellen des Assistenten die PSH_WIZARDHASFINISH FLAG im dwFlags-Element der PROPSHEETHEADER-Struktur des Assistenten fest. Auf jeder Seite werden dann alle vier Schaltflächen angezeigt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile prsht.h