TaskDialogPage.Navigate(TaskDialogPage) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

ArgumentNullException

page is null.

InvalidOperationException

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