PropSheet_RemovePage Makro (prsht.h)

Entfernt eine Seite aus einem Eigenschaftenblatt. Sie können dieses Makro verwenden oder die PSM_REMOVEPAGE Nachricht explizit senden.

Syntax

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

Parameter

hDlg

Typ: HWND-

Behandeln sie das Eigenschaftenblatt.

index

Typ: int

Nullbasierter Index der zu entfernenden Seite.

hpage

Typ: HPROPSHEETPAGE-

Handle to the page to be removed.

Rückgabewert

Typ: VOID

Kein Rückgabewert.

Bemerkungen

Eine Anwendung kann die seite angeben, die entfernt werden soll, indem sie entweder Index oder hpageeinen Wert zuweisen. Wenn werte sowohl Index als auch hpagezugewiesen werden, hat hpage- Vorrang.

Eine Reihe von Nachrichten und ein Funktionsaufruf treten auf, während das Eigenschaftenblatt die Liste der Seiten manipuliert. Während diese Aktion ausgeführt wird, hat der Versuch, die Liste der Seiten zu ändern, unvorhersehbare Ergebnisse. Dementsprechend sollten Sie das PropSheet_RemovePage Makro nicht in Ihrer Implementierung von PropSheetPageProc- oder während der Behandlung der folgenden Benachrichtigungen und Windows-Nachrichten verwenden.

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

Wenn Sie eine Eigenschaftenblattseite ändern müssen, während Sie eine dieser Nachrichten behandeln oder während PropSheetPageProc- ausgeführt wird, veröffentlichen Sie eine private Windows-Nachricht. Ihre Anwendung empfängt diese Nachricht erst, nachdem der Eigenschaftenblatt-Manager seine Aufgaben abgeschlossen hat. Anschließend können Sie die Liste der Seiten ändern.

Die folgenden Benachrichtigungen sind auch von der Änderung des Eigenschaftenblatts betroffen.

• PSN_WIZBACK
• PSN_WIZNEXT

Sie können Seiten als Reaktion auf diese Benachrichtigungen hinzufügen oder entfernen, vorausgesetzt, Sie geben (über DWL_MSGRESULT) einen Wert ungleich Null zurück, um die gewünschte neue Seite anzugeben. Beachten Sie jedoch, dass, wenn Sie eine Seite entfernen, die sich vor der aktuellen Seite befindet (die einen kleineren Index als die aktuelle Seite aufweist), PSN_KILLACTIVE möglicherweise an die falsche Seite gesendet werden.

Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.

 

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	prsht.h