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(
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.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 |