PropSheet_InsertPage Makro (prsht.h)
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 dieses Makro verwenden oder die PSM_INSERTPAGE Nachricht explizit senden.
Syntax
void PropSheet_InsertPage(
hDlg,
index,
hpage
);
Parameter
hDlg
Typ: HWND
Handle mit dem Eigenschaftenblatt.
index
Typ: HWND
Wo die Seite eingefügt werden soll. Legen Sie wParam 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.
hpage
Typ: HWND
Handle für die seite, die eingefügt werden soll. Die Seite muss zuerst durch einen Aufruf der CreatePropertySheetPage-Funktion erstellt werden.
Rückgabewert
Keine
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 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_InsertPage 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 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.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 |