Skip to main content

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

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

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.

WinForms XtraMessageBox

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();
}
See Also