MessageBox::Show Method (String^, String^, MessageBoxButtons, MessageBoxIcon)

 

Displays a message box with specified text, caption, buttons, and icon.

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

public:
static DialogResult Show(
	String^ text,
	String^ caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon
)

Parameters

text
Type: System::String^

The text to display in the message box.

caption
Type: System::String^

The text to display in the title bar of the message box.

buttons
Type: System.Windows.Forms::MessageBoxButtons

One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
Type: System.Windows.Forms::MessageBoxIcon

One of the MessageBoxIcon values that specifies which icon to display in the message box.

Return Value

Type: System.Windows.Forms::DialogResult

One of the DialogResult values.

Exception Condition
InvalidEnumArgumentException

The buttons parameter specified is not a member of MessageBoxButtons.

-or-

The icon parameter specified is not a member of MessageBoxIcon.

InvalidOperationException

An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. This is specified by the SystemInformation::UserInteractive property.

You can have a maximum of three buttons on the message box.

The following code example demonstrates one of the Show methods when handling the ComboBox::DropDown event. To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );

      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

UIPermission

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

.NET Framework
Available since 1.1
Return to top
Show: