TaskDialog.ShowDialog Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Overloads

ShowDialog(TaskDialogPage, TaskDialogStartupLocation)	Shows the task dialog.
ShowDialog(IntPtr, TaskDialogPage, TaskDialogStartupLocation)	Shows the task dialog with the specified owner.
ShowDialog(IWin32Window, TaskDialogPage, TaskDialogStartupLocation)	Shows the task dialog with the specified owner.

ShowDialog(TaskDialogPage, TaskDialogStartupLocation)

Shows the task dialog.

public static System.Windows.Forms.TaskDialogButton ShowDialog (System.Windows.Forms.TaskDialogPage page, System.Windows.Forms.TaskDialogStartupLocation startupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner);

static member ShowDialog : System.Windows.Forms.TaskDialogPage * System.Windows.Forms.TaskDialogStartupLocation -> System.Windows.Forms.TaskDialogButton

Public Shared Function ShowDialog (page As TaskDialogPage, Optional startupLocation As TaskDialogStartupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner) As TaskDialogButton

Parameters

page

TaskDialogPage

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

startupLocation

TaskDialogStartupLocation

Gets or sets the position of the task dialog when it is shown.

Returns

TaskDialogButton

The TaskDialogButton which was clicked by the user to close the dialog.

Exceptions

ArgumentNullException

page is null.

InvalidOperationException

The specified page contains an invalid configuration.

Remarks

Showing the dialog will bind the page and its controls until this method returns or the dialog is navigated to a different page.

ShowDialog(IntPtr, TaskDialogPage, TaskDialogStartupLocation)

Shows the task dialog with the specified owner.

public static System.Windows.Forms.TaskDialogButton ShowDialog (IntPtr hwndOwner, System.Windows.Forms.TaskDialogPage page, System.Windows.Forms.TaskDialogStartupLocation startupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner);

static member ShowDialog : nativeint * System.Windows.Forms.TaskDialogPage * System.Windows.Forms.TaskDialogStartupLocation -> System.Windows.Forms.TaskDialogButton

Public Shared Function ShowDialog (hwndOwner As IntPtr, page As TaskDialogPage, Optional startupLocation As TaskDialogStartupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner) As TaskDialogButton

Parameters

hwndOwner

IntPtr

nativeint

The handle of the owner window, or Zero to show a modeless dialog.

page

TaskDialogPage

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

startupLocation

TaskDialogStartupLocation

Gets or sets the position of the task dialog when it is shown.

Returns

TaskDialogButton

The TaskDialogButton which was clicked by the user to close the dialog.

Exceptions

ArgumentNullException

page is null.

InvalidOperationException

The specified page contains an invalid configuration.

Remarks

Showing the dialog will bind the page and its controls until this method returns or the dialog is navigated to a different page.

ShowDialog(IWin32Window, TaskDialogPage, TaskDialogStartupLocation)

Shows the task dialog with the specified owner.

public static System.Windows.Forms.TaskDialogButton ShowDialog (System.Windows.Forms.IWin32Window owner, System.Windows.Forms.TaskDialogPage page, System.Windows.Forms.TaskDialogStartupLocation startupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner);

static member ShowDialog : System.Windows.Forms.IWin32Window * System.Windows.Forms.TaskDialogPage * System.Windows.Forms.TaskDialogStartupLocation -> System.Windows.Forms.TaskDialogButton

Public Shared Function ShowDialog (owner As IWin32Window, page As TaskDialogPage, Optional startupLocation As TaskDialogStartupLocation = System.Windows.Forms.TaskDialogStartupLocation.CenterOwner) As TaskDialogButton

Parameters

owner

IWin32Window

The owner window, or null to show a modeless dialog.

page

TaskDialogPage

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

startupLocation

TaskDialogStartupLocation

Gets or sets the position of the task dialog when it is shown.

Returns

TaskDialogButton

The TaskDialogButton which was clicked by the user to close the dialog.

Exceptions

ArgumentNullException

owner is null - or - page is null.

InvalidOperationException

The specified page contains an invalid configuration.

Remarks

Showing the dialog will bind the page and its controls until this method returns or the dialog is navigated to a different page.