WinUIMessageBox.Show(FrameworkElement, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions, FloatingMode) Method

Displays the WinUIMessageBox with specific owner, text, title, icon, display options, floating mode and set of buttons, one of which is set as default.

Namespace: DevExpress.Xpf.WindowsUI

Assembly: DevExpress.Xpf.Controls.v24.2.dll

NuGet Package: DevExpress.Wpf.Controls

Declaration

C#

public static MessageBoxResult Show(
    FrameworkElement owner,
    string messageBoxText,
    string caption,
    MessageBoxButton button,
    MessageBoxImage icon,
    MessageBoxResult defaultResult,
    MessageBoxOptions options,
    FloatingMode desiredFloatingMode
)

VB.NET

Public Shared Function Show(
    owner As FrameworkElement,
    messageBoxText As String,
    caption As String,
    button As MessageBoxButton,
    icon As MessageBoxImage,
    defaultResult As MessageBoxResult,
    options As MessageBoxOptions,
    desiredFloatingMode As FloatingMode
) As MessageBoxResult

Parameters

Name	Type	Description
owner	FrameworkElement	A FrameworkElement object that owns the current WinUIMessageBox.
messageBoxText	String	A String value that is the text to be displayed within the current WinUIMessageBox.
caption	String	A String value that is the WinUIMessageBox window caption.
button	MessageBoxButton	A MessageBoxButton enumerator value that specifies the set of buttons displayed within the current WinUIMessageBox.
icon	MessageBoxImage	A MessageBoxImage enumerator value that specifies which icon to display within the current WinUIMessageBox.
defaultResult	MessageBoxResult	A MessageBoxResult that specifies which message box button is default. A default button is highlighted when a WinUIMessageBox is shown.
options	MessageBoxOptions	A MessageBoxOptions enumerator value that specifies which display and association options will be used for the message box.
desiredFloatingMode	FloatingMode	A FloatingMode enumerator value that specifies the floating mode for the WinUIMessageBox.

Returns

Type	Description
MessageBoxResult	A MessageBoxResult enumerator value that indicates which message box button an end-user has clicked.

Remarks

Depending on the desiredFloatingMode parameter, the WinUIMessageBox can float in 3 ways:

• FloatingMode.Adorner - the message box is initially centered against the application window and stuck to it. The message box is displayed above the application window only and is always focused. Moving the application window moves the message box respectively.
• FloatingMode.Popup - the message box is initially centered against the application window and displayed above all windows.
• FloatingMode.Window - the message box is initially centered against a screen and behaves similar to modal windows - it can lose focus and is displayed above the application window only.