PSM_REMOVEPAGE Nachricht

Entfernt eine Seite aus einem Eigenschaftenblatt. Sie können diese Nachricht explizit oder mithilfe des makros PropSheet_RemovePage senden.

Parameter

wParam

Nullbasierter Index der zu entfernenden Seite.

lParam

Das HPROPSHEETPAGE-Handle der zu entfernenden Seite.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Eine Anwendung kann den Index oder das Handle oder beides angeben. Wenn beide angegeben sind, hat lParam Vorrang.

Das Senden PSM_REMOVEPAGE zerstört die Eigenschaftenblattseite, die entfernt wird.

Eine Reihe von Nachrichten und ein Funktionsaufruf treten auf, während das Eigenschaftenblatt die Liste der Seiten bearbeitet. Während dieser Aktion führt der Versuch, die Liste der Seiten zu ändern, unvorhersehbare Ergebnisse. Dementsprechend sollten Sie die PSM_REMOVEPAGE Nachricht nicht in Ihrer Implementierung von PropSheetPageProc oder beim Behandeln 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 in Betrieb ist, posten Sie eine private Windows-Nachricht. Ihre Anwendung erhält 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 nichtzero-Wert zurück, um die gewünschte neue Seite anzugeben. Beachten Sie jedoch, dass beim Entfernen einer Seite, 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 wird.

Anforderungen

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