MessageBoxIcon Enumeration
Specifies constants defining which information to display.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| None | The message box contain no symbols. | |
| Hand | The message box contains a symbol consisting of a white X in a circle with a red background. | |
| Question | The message box contains a symbol consisting of a question mark in a circle. The question-mark message icon is no longer recommended because it does not clearly represent a specific type of message and because the phrasing of a message as a question could apply to any message type. In addition, users can confuse the message symbol question mark with Help information. Therefore, do not use this question mark message symbol in your message boxes. The system continues to support its inclusion only for backward compatibility. | |
| Exclamation | The message box contains a symbol consisting of an exclamation point in a triangle with a yellow background. | |
| Asterisk | The message box contains a symbol consisting of a lowercase letter i in a circle. | |
| Stop | The message box contains a symbol consisting of white X in a circle with a red background. | |
| Error | The message box contains a symbol consisting of white X in a circle with a red background. | |
| Warning | The message box contains a symbol consisting of an exclamation point in a triangle with a yellow background. | |
| Information | The message box contains a symbol consisting of a lowercase letter i in a circle. |
This enumeration is used by the MessageBox class. The description of each member of this enumeration contains a typical representation of the symbol. The actual graphic displayed is a function of the operating system constants. In current implementations there are four unique symbols with multiple values assigned to them.
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 Button and a TextBox on it.
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; } }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.