MessageBox::Show Method (IWin32Window^, String^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Displays a message box in front of the specified object and with the specified text.

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

public:
static DialogResult Show(
	IWin32Window^ owner,
	String^ text
)

Parameters

owner
Type: System.Windows.Forms::IWin32Window^

An implementation of IWin32Window that will own the modal dialog box.

text
Type: System::String^

The text to display in the message box.

Return Value

Type: System.Windows.Forms::DialogResult

One of the DialogResult values.

You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

By default, the message box displays an OK button. The message box does not contain a caption in the title.

UIPermission

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

.NET Framework
Available since 1.1
Return to top
Show: