PropSheet_AddPage-Makro (prsht.h)

  • Artikel

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

void PropSheet_AddPage(
   hDlg,
   hpage
);

Parameter

hDlg

Typ: HWND

Handle für das Eigenschaftenblatt.

hpage

Typ: HPROPSHEETPAGE

Handle für die hinzuzufügende Seite. Die Seite muss durch einen vorherigen Aufruf der CreatePropertySheetPage-Funktion erstellt worden sein.

Rückgabewert

Keine

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 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 das Makro PropSheet_AddPage nicht in Ihrer Implementierung von PropSheetPageProc oder beim Behandeln der folgenden Benachrichtigungen und Microsoft Windows-Meldungen verwenden:

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.

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