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.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

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.

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#

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();

VB.NET

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