TDM_NAVIGATE_PAGE Nachricht

Erstellt ein Aufgabendialogfeld mit neuen Inhalten neu, wobei die Funktionalität eines Assistenten mit mehreren Seiten simuliert wird.

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 Member variieren je nach Art der Seite, zu der der Benutzer navigiert.

Rückgabewert

Der Rückgabewert wird ignoriert.

Bemerkungen

Verwenden Sie zum Starten eines Assistentenaufgabendialogfelds die TaskDialogIndirect-Funktion . Während der Benutzer mit dem 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 lParam verweist. Bei der Erstellung wird der gesamte Inhalt des Dialograhmens zerstört und rekonstruiert. Infolgedessen gehen alle Zustandsinformationen, die von Steuerelementen (z. B. eine Statusanzeige, eine Erweiterungsschaltfläche oder ein Überprüfungskontrollkästchen) im Dialogfeld gespeichert werden, verloren.

Das Layout des Aufgabendialogfelds schlägt möglicherweise fehl, und dies spiegelt sich möglicherweise nicht im Rückgabewert wider. 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 der Dialog geschlossen, und bei der registrierten Rückruffunktion wird ein HRESULT-Code zurückgegeben. Weitere Informationen zur Syntax der Rückruffunktion finden Sie unter TaskDialogCallbackProc.

Anforderungen

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