CommonDialog.ShowDialog Method

Definition

Displays a common dialog.

Overloads

ShowDialog()

Displays a common dialog.

ShowDialog(Window)

Displays a common dialog.

Remarks

ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Since RunDialog requires an owner window, ShowDialog attempts to assign one in the following order of precedence:

  • The current application's active window.

  • The current application's parking window.

  • An internally generated hidden window.

ShowDialog()

Displays a common dialog.

C#
[System.Security.SecurityCritical]
public virtual bool? ShowDialog ();
C#
public virtual bool? ShowDialog ();

Returns

If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attributes

Remarks

ShowDialog performs initialization tasks for all common dialogs before calling RunDialog.

In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

ShowDialog(Window)

Displays a common dialog.

C#
[System.Security.SecurityCritical]
public bool? ShowDialog (System.Windows.Window owner);
C#
public bool? ShowDialog (System.Windows.Window owner);

Parameters

owner
Window

Handle to the window that owns the dialog.

Returns

If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

Attributes

Remarks

ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Additionally, the dialog that is eventually shown is assigned an owner window, which is specified by the owner parameter.

In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.

See also

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9