MessageBoxButtons Enum

Definition

Specifies constants defining which buttons to display on a MessageBox.

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

Fields

AbortRetryIgnore 2

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

CancelTryContinue 6

Specifies that the message box contains Cancel, Try Again, and Continue buttons.

OK 0

The message box contains an OK button.

OKCancel 1

The message box contains OK and Cancel buttons.

RetryCancel 5

The message box contains Retry and Cancel buttons.

YesNo 4

The message box contains Yes and No buttons.

YesNoCancel 3

The message box contains Yes, No, and Cancel 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.

Applies to

See also