PropSheet_AddPage Makro (prsht.h)

Fügt am Ende eines vorhandenen Eigenschaftenblatts eine neue Seite hinzu. Sie können dieses Makro verwenden oder die PSM_ADDPAGE Nachricht explizit senden.

Syntax

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Parameter

hDlg

Typ: HWND-

Behandeln sie das Eigenschaftenblatt.

hpage

Typ: HPROPSHEETPAGE-

Handle to the page to add. Die Seite muss durch einen vorherigen Aufruf der CreatePropertySheetPage-Funktion erstellt worden sein.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Die neue Seite sollte nicht größer als die größte Seite sein, die sich derzeit im Eigenschaftenblatt befindet, da die Größe des Eigenschaftenblatts nicht an die neue Seite angepasst wird.

Eine Reihe von Nachrichten und ein Funktionsaufruf treten auf, während das Eigenschaftenblatt die Liste der Seiten manipuliert. Während diese Aktion ausgeführt wird, hat der Versuch, die Liste der Seiten zu ändern, unvorhersehbare Ergebnisse. Dementsprechend sollten Sie das PropSheet_AddPage-Makro nicht in Ihrer Implementierung von PropSheetPageProc- oder während der Behandlung der folgenden Benachrichtigungen und Microsoft 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- ausgeführt wird, veröffentlichen Sie 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.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	prsht.h