MessageBoxButtons Enum

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

Applies to

Jaa