Home Library Learn Downloads Support Community
Sign in | United States - English | |
4 out of 8 rated this helpful - Rate this topic

MessageBoxButtons Enumeration

.NET Framework 4

Specifies constants defining which buttons to display on a MessageBox.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
C#
C++
F#
VB
Copy 
public enum MessageBoxButtons
Member name Description
OK The message box contains an OK button.
OKCancel The message box contains OK and Cancel buttons.
AbortRetryIgnore The message box contains Abort, Retry, and Ignore buttons.
YesNoCancel The message box contains Yes, No, and Cancel buttons.
YesNo The message box contains Yes and No buttons.
RetryCancel The message box contains Retry and Cancel buttons.

This enumeration is used by the MessageBox class.

The following code example shows how to use a MessageBox to give the user an opportunity to prevent a form from closing. This example requires that the method is called from the FormClosing event of the form.

C#
C++
VB
Copy 

private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
    const string message =
        "Are you sure that you would like to close the form?";
    const string caption = "Form Closing";
    var result = MessageBox.Show(message, caption,
                                 MessageBoxButtons.YesNo,
                                 MessageBoxIcon.Question);

    // If the no button was pressed ...
    if (result == DialogResult.No)
    {
        // cancel the closure of the form.
        e.Cancel = true;
    }
}

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Why no Close option?
According to the Microsoft UX guidelines on dialog boxes http://msdn.microsoft.com/en-us/library/aa511268.aspx, Close should be used instead of OK for one button boxes. Will the enum eventually get a Close option?
History