Skip to main content

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

DxDropDown.CloseAsync(CancellationToken) Method

Asynchronously closes the drop-down window.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

#Declaration

C#
public Task<bool> CloseAsync(
    CancellationToken token = default(CancellationToken)
)

#Optional Parameters

Name Type Default Description
token CancellationToken null

An object that propagates a cancellation notification.

#Returns

Type Description
Task<Boolean>

An asynchronous operation that closes the window. The operation returns true if the operation is successful; otherwise, false.’

#Remarks

Call ShowAsync and CloseAsync methods to invoke and close the drop-down window asynchronously.

Razor
<DxButton Text="Show" Click="ShowWindow" />
<DxButton Text="Hide" Click="HideWindow" />

<DxDropDown @ref="ddWindow"
            Width="400"
            BodyText="Lorem ipsum dolor sit amet, consectetur adipiscing elit.">
</DxDropDown>

@code {
    DxDropDown ddWindow { get; set; }

    async Task ShowWindow(MouseEventArgs args) {
        if (ddWindow.IsInitialized)
            await ddWindow.ShowAsync();
        else {
            await ddWindow.InitializedTask;
            await ddWindow.ShowAsync();
        }
    }
    async Task HideWindow(MouseEventArgs args) {
        await ddWindow.CloseAsync();
    }
}

You can handle the following events related to ShowAsync and CloseAsync methods:

Showing
Fires before the window is displayed and allows you to cancel this action.
Shown
Fires after the window is displayed.
Closing
Fires before the window is closed and allows you to cancel this action.
Closed
Fires after the window is closed.

To show and close the drop-down window synchronously, implement two-way binding for the IsOpen property.

See Also