DxDropDown.CloseAsync(CancellationToken) Method

Asynchronously closes the drop-down window.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.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.