WinUIMessageBox.Show(FrameworkElement, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions, FloatingMode, Boolean) Method
Displays the WinUIMessageBox with specific owner, text, title, icon, display options, floating mode, animation, 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
public static MessageBoxResult Show(
FrameworkElement owner,
string messageBoxText,
string caption,
MessageBoxButton button,
MessageBoxImage icon,
MessageBoxResult defaultResult,
MessageBoxOptions options,
FloatingMode desiredFloatingMode,
bool allowShowAnimatoin
)
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 MessageBoxImageenumerator 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. |
allowShowAnimatoin | Boolean | true, if message box show should be followed with smooth animation effects; otherwise, false. |
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.