MessageBoxButtons MessageBoxButtons MessageBoxButtons MessageBoxButtons Enum


Specifies constants defining which buttons to display on a MessageBox.

public enum class MessageBoxButtons
public enum MessageBoxButtons
type MessageBoxButtons = 
Public Enum MessageBoxButtons


AbortRetryIgnore AbortRetryIgnore AbortRetryIgnore AbortRetryIgnore 2

The message box contains Abort, Retry, and Ignore buttons.


The message box contains an OK button.

OKCancel OKCancel OKCancel OKCancel 1

The message box contains OK and Cancel buttons.

RetryCancel RetryCancel RetryCancel RetryCancel 5

The message box contains Retry and Cancel buttons.

YesNo YesNo YesNo YesNo 4

The message box contains Yes and No buttons.

YesNoCancel YesNoCancel YesNoCancel YesNoCancel 3

The message box contains Yes, No, and Cancel buttons.


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.

   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,

    // 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, _

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


This enumeration is used by the MessageBox class.

Applies to

See also