MessageBoxButton Enumeration


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Specifies the buttons that are displayed on a message box. Used as an argument of the Show method.

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

Public Enumeration MessageBoxButton

Member nameDescription

The message box displays an OK button.


The message box displays OK and Cancel buttons.


The message box displays Yes and No buttons.


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

By default, the Show method of the MessageBox type displays a message box that has an OK button. You can use overloads of the Show method that accept a MessageBoxButton argument in order to specify different combinations of buttons, which include OK, OK/Cancel, Yes/No, and Yes/No/Cancel.

If you specify YesNo, you disable the Close button in the message box title bar. However, the Close button is enabled for all other options. When a user clicks the Close button or presses the ESC key, a message box returns a message box result value of Cancel. However, if a message box displays only an OK button, clicking the Close button or pressing the ESC key causes a message box to return a message box result value of OK.

The value of the button that a user clicks is returned by Show and is one of the values of the MessageBoxResult enumeration.

For more information, see MessageBox Sample.

.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top