ShowDialog Method (IWin32Window)
Collapse the table of content
Expand the table of content

CommonDialog.ShowDialog Method (IWin32Window)


Runs a common dialog box with the specified owner.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public DialogResult ShowDialog(
	IWin32Window owner


Type: System.Windows.Forms.IWin32Window

Any object that implements IWin32Window that represents the top-level window that will own the modal dialog box.

Return Value

Type: System.Windows.Forms.DialogResult

DialogResult.OK if the user clicks OK in the dialog box; otherwise, DialogResult.Cancel.

This version of the ShowDialog method allows you to specify a specific form or control that will own the dialog box that is shown. If you use the version of this method that has no parameters, the dialog box being shown would be owned automatically by the currently active window of your application.


to print from a PrintDialog. Associated enumeration: PrintingPermissionLevel.SafePrinting


for safe subwindows to call this method. Associated enumeration: UIPermissionWindow.SafeSubWindows

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft