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

Displays the XtraMessageBox with the specified 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.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

Public Shared Function Show(
    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
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 list shows the default parameters of the Show method overloads. You can override these parameters using a specific Show method overload.

• Caption - Empty string
• Buttons - MessageBoxButtons.OK
• Owner - null
• Icon - MessageBoxIcon.None
• DefaultButton - MessageBoxDefaultButton.Button1
• XtraMessageBox.AllowHtmlText - DefaultBoolean.Default

Example

This example demonstrates how to display the XtraMessageBox.

C#

using DevExpress.XtraEditors;
using DevExpress.Utils;

private void simpleButton1_Click(object sender, EventArgs e) {
    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

Private Sub simpleButton1_Click(ByVal sender As Object, ByVal e As EventArgs)
    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
End Sub