PSM_INSERTPAGE Nachricht

Fügt eine neue Seite in ein vorhandenes Eigenschaftenblatt ein. Die Seite kann entweder an einem angegebenen Index oder nach einer angegebenen Seite eingefügt werden. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_InsertPage senden.

Parameter

wParam

Der Ort, an dem die Seite eingefügt werden soll. Legen Sie diesen Parameter auf NULL fest, um die neue Seite zur ersten Seite zu machen. Um anzugeben, wo die neue Seite eingefügt werden soll, können Sie entweder einen Index oder das HPROPSHEETPAGE-Handle einer vorhandenen Seite übergeben.

Wert	Bedeutung
Index	Wenn der wParam-Parameter kleiner als MAXUSHORT (die größte ganze Zahl ohne Vorzeichen) ist, gibt wParam den nullbasierten Index für die neue Seite an. Um die eingefügte Seite beispielsweise zur dritten Seite im Eigenschaftenblatt zu machen, legen Sie wParam auf 2 fest. Um es zur ersten Seite zu machen, legen Sie wParam auf 0 fest. Wenn wParam einen Wert aufweist, der größer als die Anzahl der Seiten und kleiner als MAXUSHORT ist, wird die Seite angefügt.
hpageInsertAfter	Wenn Sie den wParam-Parameter auf das HPROPSHEETPAGE-Handle einer vorhandenen Seite festlegen, wird die neue Seite danach eingefügt.

lParam

Handle für die einzufügende Seite. Die Seite muss zuerst durch einen Aufruf der CreatePropertySheetPage-Funktion erstellt werden.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Seite erfolgreich eingefügt wurde, oder andernfalls null.

Bemerkungen

Die Seiten nach der Einfügemarke werden nach rechts verschoben, um die neue Seite aufzunehmen.

Die Größe des Eigenschaftenblatts wird nicht an die neue Seite angepasst. Machen Sie die neue Seite nicht größer als die größte Seite des Eigenschaftenblatts.

Eine Reihe von Meldungen und ein Funktionsaufruf treten auf, während das Eigenschaftenblatt die Liste der Seiten bearbeitet. Während diese Aktion ausgeführt wird, führt der Versuch, die Liste der Seiten zu ändern, zu unvorhersehbaren Ergebnissen. Dementsprechend sollten Sie die PSM_INSERTPAGE Meldung nicht in Ihrer Implementierung von PropSheetPageProc oder bei der Behandlung der folgenden Benachrichtigungen und Windows-Meldungen 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 Meldungen behandeln oder während PropSheetPageProc in Betrieb ist, posten Sie selbst 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 ebenfalls von änderungen des Eigenschaftenblatts betroffen.

• PSN_WIZBACK
• PSN_WIZNEXT

Sie können Seiten als Reaktion auf diese Benachrichtigungen hinzufügen oder entfernen, sofern Sie (über DWL_MSGRESULT) einen Wert ungleich 0 (null) zurückgeben, um die gewünschte neue Seite anzugeben. Beachten Sie jedoch, dass beim Einfügen 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

Diese Meldung 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]
Header	Prsht.h