MessageBox Class
Displays a message window, also known as a dialog box, which presents a message to the user. It is a modal window, blocking other actions in the application until the user closes it. A MessageBox can contain text, buttons, and symbols that inform and instruct the user.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Name | Description | |
|---|---|---|
![]() | Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | MemberwiseClone() | |
![]() ![]() | Show(IWin32Window^, String^) | Displays a message box in front of the specified object and with the specified text. |
![]() ![]() | Show(IWin32Window^, String^, String^) | Displays a message box in front of the specified object and with the specified text and caption. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons) | Displays a message box in front of the specified object and with the specified text, caption, and buttons. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon) | Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) | Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) | Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, HelpNavigator) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, HelpNavigator, Object^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic. |
![]() ![]() | Show(IWin32Window^, String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, String^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword. |
![]() ![]() | Show(String^) | Displays a message box with specified text. |
![]() ![]() | Show(String^, String^) | Displays a message box with specified text and caption. |
![]() ![]() | Show(String^, String^, MessageBoxButtons) | Displays a message box with specified text, caption, and buttons. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon) | Displays a message box with specified text, caption, buttons, and icon. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) | Displays a message box with the specified text, caption, buttons, icon, and default button. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) | Displays a message box with the specified text, caption, buttons, icon, default button, and options. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, HelpNavigator) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, HelpNavigator, Object^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic. |
![]() ![]() | Show(String^, String^, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String^, String^) | Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword. |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
You cannot create a new instance of the MessageBox class. To display a message box, call the static method MessageBox::Show. The title, message, buttons, and icons displayed in the message box are determined by parameters that you pass to this method.
The following code example shows how to use a MessageBox to inform the user of a missing entry in a TextBox. This example requires that the method is called from an existing form with a TextBox named ServerName on it.
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(); } } }
The following code example shows how to ask the user a yes or no question and make a decision based on the response.
private: void Form1_FormClosing(Object^ sender, FormClosingEventArgs^ e) { // If the no button was pressed ... if ((MessageBox::Show( "Are you sure that you would like to close the form?", "Form Closing", MessageBoxButtons::YesNo, MessageBoxIcon::Question) == DialogResult::No)) { // cancel the closure of the form. e->Cancel = true; } }
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


