TDM_NAVIGATE_PAGE message

Recreates a task dialog with new contents, simulating the functionality of a multi-page wizard.

Parameters

wParam [in]

Not used. Must be zero.

lParam [in]

A pointer to a TASKDIALOGCONFIG structure that describes the task dialog to create. The calling application must allocate this structure and set its members. The values of the members vary depending on the kind of page the user navigates to.

Return value

The return value is ignored.

Remarks

To launch a wizard task dialog, use the TaskDialogIndirect function. As the user navigates using the wizard, send this message to the task dialog to display the next page. A new task dialog (looks like a new page) is created with the elements specified in the structure pointed to by lParam. At creation, the entire contents of the dialog frame are destroyed and reconstructed. As a result, any state information held by controls (for example, a progress bar, expando button, or verification checkbox) in the dialog is lost.

The layout of the task dialog may fail and this may not be reflected in the return value. A return value of S_OK reflects only that the task dialog received the message and attempted to process it. If the layout of the task dialog fails (the task dialog cannot be displayed), the dialog will close and an HRESULT code is returned at the registered callback function. For more information on the callback function syntax, see TaskDialogCallbackProc.

Requirements