PropSheet_RemovePage Makro (prsht.h)

  • Artikel

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

Syntax

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

Parameter

hDlg

Typ: HWND

Handle mit dem Eigenschaftenblatt.

index

Typ: int

Nullbasierter Index der zu entfernenden Seite.

hpage

Typ: HPROPSHEETPAGE

Handle mit der zu entfernenden Seite.

Rückgabewert

Keine

Bemerkungen

Eine Anwendung kann die zu entfernende Seite angeben, indem entweder index oder hpage ein Wert zugewiesen wird. Wenn Sowohl index als auch hpage Werte zugewiesen werden, hat hpage Vorrang.

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 das Makro PropSheet_RemovePage nicht in Ihrer Implementierung von PropSheetPageProc oder beim Behandeln der folgenden Benachrichtigungen und Windows-Nachrichten verwenden.

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.

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.
Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.
 

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