Back to Devexpress

XtraMessageBox.Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) Method

windowsforms-devexpress-dot-xtraeditors-dot-xtramessagebox-dot-show-x28-system-dot-windows-dot-forms-dot-iwin32window-system-dot-string-system-dot-string-system-dot-windows-dot-forms-dot-messageboxbuttons-system-dot-windows-dot-forms-dot-messageboxicon-x29.md

latest7.7 KB
Original Source

XtraMessageBox.Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) Method

Displays the XtraMessageBox with the specified owner, text, caption, buttons and icon.

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
public static DialogResult Show(
    IWin32Window owner,
    string text,
    string caption,
    MessageBoxButtons buttons,
    MessageBoxIcon icon
)
vb
Public Shared Function Show(
    owner As IWin32Window,
    text As String,
    caption As String,
    buttons As MessageBoxButtons,
    icon As MessageBoxIcon
) As DialogResult

Parameters

NameTypeDescription
ownerIWin32Window

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 | MessageBoxButtons |

A value that specifies which buttons to display in the message box.

| | icon | MessageBoxIcon |

One of the MessageBoxIcon values that specifies which icon to display in the message box.

|

Returns

TypeDescription
DialogResult

One of the DialogResult values.

|

Remarks

The following code snippet displays an XtraMessageBox with the specified owner, text, caption, icon, and buttons:

csharp
const string text = "Do you want to close the form?";
const string caption = "Information";

XtraMessageBox.Show(this, text, caption, MessageBoxButtons.OKCancel, MessageBoxIcon.Information);

Default Parameters

ParameterDefault ValueProperty Name
CaptionString.EmptyCaption
ButtonsMessageBoxButtons.OKButtons
DefaultButtonIndex0DefaultButtonIndex
OwnernullOwner
IconMessageBoxIcon.NoneImageOptions

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.

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

The following code snippets (auto-collected from DevExpress Examples) contain references to the Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

winforms-generate-skin-palettes-with-ai/CS/DevExpress.AI.WinForms.AIGeneratePalette.Demo/AccordionShellForm.cs#L66

csharp
if(!UserLookAndFeel.Default.IsSvgSkin()) {
    XtraMessageBox.Show(this, "The current skin does not support SVG palettes. Please switch to an SVG skin and try again.", "SVG Skin Required", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    return;

winforms-scheduler-localizer-translate-ui/CS/SchedulerLocalizerExample/OutlookAppointmentForm.cs#L376

csharp
protected internal virtual DialogResult ShowMessageBox(string text, string caption, MessageBoxButtons buttons, MessageBoxIcon icon) {
    return XtraMessageBox.Show(this, text, caption, buttons, icon);
}

winforms-scheduler-custom-appointment-edit-form/CS/SchedulerDbExample/CustomAppointmentForm.cs#L297

csharp
protected internal virtual DialogResult ShowMessageBox(string text, string caption, MessageBoxButtons buttons, MessageBoxIcon icon) {
    return XtraMessageBox.Show(this, text, caption, buttons, icon);
}

winforms-scheduler-localizer-translate-ui/VB/SchedulerLocalizationExample_VB/OutlookAppointmentForm.vb#L415

vb
Protected Friend Overridable Function ShowMessageBox(text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult
    Return XtraMessageBox.Show(Me, text, caption, buttons, icon)
End Function

winforms-scheduler-custom-appointment-edit-form/VB/SchedulerDbExample/CustomAppointmentForm.vb#L361

vb
Protected Friend Overridable Function ShowMessageBox(ByVal text As String, ByVal caption As String, ByVal buttons As MessageBoxButtons, ByVal icon As MessageBoxIcon) As DialogResult
    Return XtraMessageBox.Show(Me, text, caption, buttons, icon)
End Function

See Also

XtraMessageBox Class

XtraMessageBox Members

DevExpress.XtraEditors Namespace