XtraMessageBox.Show(UserLookAndFeel, IWin32Window, String, String, DialogResult[], Icon, Int32, MessageBoxIcon) Method

Displays the XtraMessageBox with the specified look and feel settings, owner, text, caption, buttons, icon, default button, and plays the sound that corresponds to the specified system-alert level.

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

csharp

public static DialogResult Show(
    UserLookAndFeel lookAndFeel,
    IWin32Window owner,
    string text,
    string caption,
    DialogResult[] buttons,
    Icon icon,
    int defaultButton,
    MessageBoxIcon messageBeepSound
)

Public Shared Function Show(
    lookAndFeel As UserLookAndFeel,
    owner As IWin32Window,
    text As String,
    caption As String,
    buttons As DialogResult(),
    icon As Icon,
    defaultButton As Integer,
    messageBeepSound As MessageBoxIcon
) As DialogResult

Parameters

Name	Type	Description
lookAndFeel	UserLookAndFeel

A UserLookAndFeel object whose properties specify the look and feel of the message box.

| | owner | IWin32Window |

An object that serves as a dialog box’s top-level window and owner.

| | text | String |

A string value that specifies the text to display in the message box.

| | caption | String |

A string value that specifies the message box’s caption.

| | buttons | DialogResult[] |

An array of values that specify which buttons to display in the message box.

| | icon | Icon |

The Icon displayed in the message box.

| | defaultButton | Int32 |

The zero-based index of the default button.

| | messageBeepSound | MessageBoxIcon |

One of the MessageBoxIcon values that specifies a system-alert level.

Returns

Type	Description
DialogResult

One of the DialogResult values.

Remarks

The following code snippet displays an XtraMessageBox using the WXI skin, regardless of the application’s current skin.

csharp

const string text = "Do you want to close the form?";
const string caption = "Information";
Icon icon = SystemIcons.Exclamation;
var lookAndFeel = new UserLookAndFeel(this) { SkinName = "WXI", UseDefaultLookAndFeel = false };

XtraMessageBox.Show(lookAndFeel, this, text, caption, new DialogResult[] {DialogResult.Yes, DialogResult.No }, icon, 1, MessageBoxIcon.Exclamation);

Default Parameters

Parameter	Default Value	Property Name
`Caption`	`String.Empty`	Caption
`Buttons`	`MessageBoxButtons.OK`	Buttons
`DefaultButtonIndex`	0	DefaultButtonIndex
`Owner`	`null`	Owner
`Icon`	`MessageBoxIcon.None`	ImageOptions

The following code snippet displays the XtraMessageBox with formatted text and a warning icon. If the user clicks Yes , the application closes the current form.

C#
VB.NET

csharp

using DevExpress.XtraEditors;
using DevExpress.Utils;

if(XtraMessageBox.Show(
    "Do you want to close the <b>form</b>?", "Warning",
    MessageBoxButtons.YesNo, MessageBoxIcon.Warning,
    DefaultBoolean.True) == DialogResult.Yes)
    this.Close();

Imports DevExpress.XtraEditors
Imports DevExpress.Utils

If XtraMessageBox.Show("Do you want to close the <b>form</b>?", "Warning", MessageBoxButtons.YesNo, MessageBoxIcon.Warning, DefaultBoolean.True) = DialogResult.Yes Then
    Me.Close()
End If