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

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

Parameter

hDlg

Typ: HWND-

Behandeln sie das Eigenschaftenblatt.

index

Typ: HWND-

Wo die Seite eingefügt werden soll. Legen Sie Index- 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 ein HPROPSHEETPAGE-Handle einer vorhandenen Seite übergeben.

Wert Bedeutung
index
 Wenn Index kleiner als MAXUSHORT (die größte nicht signierte kurze ganze Zahl) ist, gibt er den nullbasierten Index für die neue Seite an. Wenn Sie beispielsweise die eingefügte Seite auf dem Eigenschaftenblatt als dritte Seite festlegen möchten, legen Sie Index auf 2 fest. Um sie zur ersten Seite zu machen, legen Sie Index auf 0 fest. Wenn 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 Index- auf das HPROPSHEETPAGE-Handle einer vorhandenen Seite festlegen, wird die neue Seite danach eingefügt.

hpage

Typ: HWND-

Handle to the page to be inserted. Die Seite muss zuerst durch einen Aufruf der CreatePropertySheetPage-Funktion erstellt werden.

Rückgabewert

Typ: BOOL-

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.

Das Eigenschaftenblatt wird nicht so angepasst, dass es an die neue Seite angepasst wird. Legen Sie die neue Seite nicht größer als die größte Seite des Eigenschaftenblatts fest.

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_InsertPage-Makro nicht in Ihrer Implementierung von PropSheetPageProc- oder während der Behandlung 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- 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.

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 Wert ungleich Null 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 werden.
Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.
 

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