TaskDialogPage.Navigate(TaskDialogPage) Method

Definition

Shows the new content in the current task dialog. page.

public:
 void Navigate(System::Windows::Forms::TaskDialogPage ^ page);
public void Navigate (System.Windows.Forms.TaskDialogPage page);
member this.Navigate : System.Windows.Forms.TaskDialogPage -> unit
Public Sub Navigate (page As TaskDialogPage)

Parameters

page
TaskDialogPage

The page instance that contains the contents which this task dialog will display.

Exceptions

page is null.

The page instance is not currently bound to a dialog, BoundDialog is null. - or - This page instance contains an invalid configuration. - or - This method is called from within the CheckedChanged event of one of the radio buttons of the current task dialog. - or - The task dialog has already been closed.

Remarks

During the navigation the dialog will recreate the dialog from the specified page and its controls, and unbind and destroy the currently shown page.

You can't manipulate the page or its controls immediately after navigating the dialog (except for calling Close() or navigating the dialog again). You will need to wait for the Created event to occur before you can manipulate the page or its controls.

Applies to