Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

MessageBoxOptions.CloseOnEscape Property

Specifies whether the message box should be closed when a user presses Escape.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

#Declaration

C#
[DefaultValue(null)]
public bool? CloseOnEscape { get; set; }

#Property Value

Type Default Description
Nullable<Boolean> null

true to close the message box when a user presses Escape;
false to keep the message box open when a user presses Escape;
null to inherit the value from the DxDialogProvider.CloseOnEscape 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.

Set the CloseOnEscape property to false to prevent the message box from closing in response to the Escape keystroke. The ShowCloseButton and CloseOnOutsideClick properties allow you to control other user capabilities.

Run Demo

razor
<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 CloseOnEscape property is not specified, the DxDialogProvider.CloseOnEscape property determines the message box behavior.

See Also