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

Displays the XtraMessageBox with the specified settings.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public static DialogResult Show(
    IWin32Window owner,
    string text,
    string caption,
    DialogResult[] buttons,
    Icon icon,
    int defaultButton,
    MessageBoxIcon messageBeepSound,
    DefaultBoolean allowHtmlText
)

VB.NET

<Browsable(False)>
<EditorBrowsable(EditorBrowsableState.Never)>
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,
    allowHtmlText As DefaultBoolean
) As DialogResult

Parameters

Name	Type	Description
owner	IWin32Window	An object that serves as the top-level window and owner of a dialog box.
text	String	The text to display in the message box.
caption	String	A string value that specifies the caption of a message box.
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.
allowHtmlText	DefaultBoolean	A value that specifies whether HTML tags can be used to format the text and caption of a message box. See XtraMessageBox.AllowHtmlText to learn more.

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