PropSheet_InsertPage Makro (prsht.h)

  • Artikel

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.

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

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.
Hinweis Dieses Makro 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]
Zielplattform Windows
Kopfzeile prsht.h