MessageBox::Show Method (String^, String^, MessageBoxButtons)
Displays a message box with specified text, caption, and buttons.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: static DialogResult Show( String^ text, String^ caption, MessageBoxButtons buttons )
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.
| Exception | Condition |
|---|---|
| InvalidEnumArgumentException | The buttons parameter specified is not a member of MessageBoxButtons. |
| 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 how to display a MessageBox with the options supported by this overload of Show. After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.
private: void validateUserEntry() { // Checks the value of the text. if ( serverName->Text->Length == 0 ) { // Initializes the variables to pass to the MessageBox::Show method. String^ message = "You did not enter a server name. Cancel this operation?"; String^ caption = "No Server Name Specified"; MessageBoxButtons buttons = MessageBoxButtons::YesNo; System::Windows::Forms::DialogResult result; // Displays the MessageBox. result = MessageBox::Show( this, message, caption, buttons ); if ( result == ::DialogResult::Yes ) { // Closes the parent form. this->Close(); } } }
for safe subwindows to call this method. Associated enumeration: UIPermissionWindow::SafeSubWindows
Available since 1.1