This documentation is archived and is not being maintained.

MessageBoxButtons Enumeration

Specifies constants defining which buttons to display on a MessageBox.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

'Declaration
Public Enumeration MessageBoxButtons
'Usage
Dim instance As MessageBoxButtons

Member nameDescription
Supported by the .NET Compact FrameworkOKThe message box contains an OK button.
Supported by the .NET Compact FrameworkOKCancelThe message box contains OK and Cancel buttons.
Supported by the .NET Compact FrameworkAbortRetryIgnoreThe message box contains Abort, Retry, and Ignore buttons.
Supported by the .NET Compact FrameworkYesNoCancelThe message box contains Yes, No, and Cancel buttons.
Supported by the .NET Compact FrameworkYesNoThe message box contains Yes and No buttons.
Supported by the .NET Compact FrameworkRetryCancelThe 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.

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

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

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0
Show: