MessageBoxButtons Enum

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Specifies constants defining which buttons to display on a MessageBox.

public enum class MessageBoxButtons

public enum MessageBoxButtons

type MessageBoxButtons = 

Public Enum MessageBoxButtons

Inheritance

Object

ValueType

Enum

MessageBoxButtons

Fields

Name	Value	Description
OK	0	The message box contains an OK button.
OKCancel	1	The message box contains OK and Cancel buttons.
AbortRetryIgnore	2	The message box contains Abort, Retry, and Ignore buttons.
YesNoCancel	3	The message box contains Yes, No, and Cancel buttons.
YesNo	4	The message box contains Yes and No buttons.
RetryCancel	5	The message box contains Retry and Cancel buttons.
CancelTryContinue	6	Specifies that the message box contains Cancel, Try Again, and Continue buttons.

Examples

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.

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;
      }
   }

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;
    }
}

Private Sub Form1_FormClosing( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.FormClosingEventArgs) _
    Handles MyBase.FormClosing

    Dim message As String = _
            "Are you sure that you would like to close the form?"
    Dim caption As String = "Form Closing"
    Dim result = MessageBox.Show(message, caption, _
                                 MessageBoxButtons.YesNo, _
                                 MessageBoxIcon.Question)

    ' If the no button was pressed ...
    If (result = DialogResult.No) Then
        ' cancel the closure of the form.
        e.Cancel = True
    End If
End Sub

Remarks

This enumeration is used by the MessageBox class.

See also

• MessageBoxDefaultButton