TDM _ NAVIGATE _ PAGE-Meldung

Erstellt ein Aufgabendialogfeld mit neuen Inhalten neu und simuliert die Funktionalität eines mehrseitigen Assistenten.

Parameter

wParam [ In]

Wird nicht verwendet. Muss Null sein.

lParam [ In]

Ein Zeiger auf eine TASKDIALOGCONFIG-Struktur, die das zu erstellende Aufgabendialogfeld beschreibt. Die aufrufende Anwendung muss diese Struktur zuordnen und ihre Member festlegen. Die Werte der Elemente variieren je nach Art der Seite, zu der der Benutzer navigiert.

Rückgabewert

Der Rückgabewert wird ignoriert.

Bemerkungen

Verwenden Sie die TaskDialogIndirect-Funktion, um ein Assistenten-Aufgabendialogfeld zu starten. Wenn der Benutzer mithilfe des Assistenten navigiert, senden Sie diese Meldung an das Aufgabendialogfeld, um die nächste Seite anzuzeigen. Ein neues Aufgabendialogfeld (sieht wie eine neue Seite aus) wird mit den Elementen erstellt, die in der -Struktur angegeben sind, auf die von lParam gezeigt wird. Bei der Erstellung wird der gesamte Inhalt des Dialograhmens zerstört und rekonstruiert. Daher sind alle Zustandsinformationen, die von Steuerelementen (z. B. eine Statusanzeige, eine Expandoschaltfläche oder ein Überprüfungskontrollkästchen) im Dialogfeld enthalten sind, verloren gegangen.

Das Layout des Aufgabendialogfelds schlägt möglicherweise fehl, und dies wird möglicherweise nicht im Rückgabewert widergespiegelt. Der Rückgabewert S _ OK gibt nur an, dass das Aufgabendialogfeld die Nachricht empfangen und versucht hat, sie zu verarbeiten. Wenn das Layout des Aufgabendialogfelds fehlschlägt (das Aufgabendialogfeld kann nicht angezeigt werden), wird das Dialogfeld geschlossen, und bei der registrierten Rückruffunktion wird ein HRESULT-Code zurückgegeben. Weitere Informationen zur Syntax der Rückruffunktion finden Sie unter TaskDialogCallbackProc.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Commctrl.h