MessageBoxOptions.CloseOnOutsideClick Property

Specifies whether the message box should be closed when a user clicks outside the box’s boundaries.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v25.1.dll

NuGet Package: DevExpress.Blazor

Declaration

[DefaultValue(null)]
public bool? CloseOnOutsideClick { get; set; }

Property Value

Type	Default	Description
Nullable<Boolean>	null	true to close the message box when a user clicks outside the element; false to keep the message box open when a user clicks outside the element; null to inherit the value from the DxDialogProvider.CloseOnOutsideClick property.

Remarks

Users can close a message box in the following ways:

• Click the Close button in the header.
• Press Escape.
• Click outside the message box’s boundaries.

The last approach is disabled by default. Set the CloseOnOutsideClick property to true to enable this functionality. The ShowCloseButton and CloseOnEscape properties allow you to control other user capabilities.

Run Demo

<DxDialogProvider />
<DxButton Text="Show a message box window" Click="@OpenConfirmDialogAsync" />

@code {
    [Inject] IDialogService DialogService { get; set; }

    private async Task OpenConfirmDialogAsync() {
    await DialogService.ConfirmAsync(new MessageBoxOptions() {
            Title = "Error",
            Text = "Unable to process the request. Please try again later or contact support.",
            CloseOnEscape = false,
            ShowCloseButton = false,
            CloseOnOutsideClick = true
        });
    }
}

If the CloseOnOutsideClick property is not specified, the DxDialogProvider.CloseOnOutsideClick property determines the message box behavior.