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
)
public DialogResult ShowDialog (
	IWin32Window owner
)
public function ShowDialog (
	owner : IWin32Window
) : DialogResult
Not applicable.

Parameters

owner

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

Return Value

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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: