MessageBox::Show Method (String^, String^, MessageBoxButtons, MessageBoxIcon)
Displays a message box with specified text, caption, buttons, and icon.
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.
| 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 ); }
for safe subwindows to call this method. Associated enumeration: UIPermissionWindow::SafeSubWindows
Available since 1.1