Skip to main content
All docs
V26.1
  • DxDropDown.CloseAsync(CancellationToken) Method

    Asynchronously closes the drop-down window.

    Namespace: DevExpress.Blazor

    Assembly: DevExpress.Blazor.v26.1.dll

    NuGet Package: DevExpress.Blazor

    Declaration

    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.

    <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