Skip to main content

IDropDownEditSettings.DropDownDirection Property

Specifies the direction in which the drop-down window is displayed in relation to the editor’s input element.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.1.dll

NuGet Package: DevExpress.Blazor

Declaration

[DefaultValue(DropDownDirection.Down)]
[Parameter]
DropDownDirection DropDownDirection { get; set; }

Property Value

Type Default Description
DropDownDirection Down

An enumeration value.

Available values:

Name Description
Down

A drop-down window is displayed below an editor’s input element.

Up

A drop-down window is displayed up an editor’s input element.

Remarks

At runtime, use the DropDownDirection property to change the direction in which the drop-down window is displayed.

Note

If the editor’s position within the browser viewport does not leave enough space to display the drop-down window in the specified direction, the drop-down window is displayed in the opposite direction instead.

To specify the window direction in markup, use the DxDropDownEditSettings.DropDownDirection property.

The IDropDownEditSettings interface allows you to get and customize settings of editors that contain a drop-down window. You can get editor settings in the following ways. Note that you can cast settings to the base IDropDownEditSettings interface or to an editor-specific interface.

  • Call the GetColumnEditSettings method to get editor settings of the column bound to the specified data source field.

    Important

    You need to enclose your code between BeginUpdate and EndUpdate method calls to change values of Grid component parameters outside the Grid component markup. Otherwise, an exception occurs.

    var hireDateEditSettings = e.Grid.GetColumnEditSettings<IDropDownEditSettings>("HireDate");
    // or var hireDateEditSettings = e.Grid.GetColumnEditSettings<IDateEditSettings>("HireDate");
    if(hireDateEditSettings != null) {
        e.Grid.BeginUpdate();
        hireDateEditSettings.DropDownDirection = DropDownDirection.Up;
        e.Grid.EndUpdate();
    }
    
  • Handle the CustomizeFilterRowEditor event to customize a cell editor in the filter row.
    void Grid_CustomizeFilterRowEditor(GridCustomizeFilterRowEditorEventArgs e) {
        if(e.EditSettings is IDropDownEditSettings hireDateEditSettings)
        // or if(e.EditSettings is IDateEditSettings hireDateEditSettings)
            hireDateEditSettings.DropDownDirection = DropDownDirection.Up;
    }
    
  • Handle the CustomizeDataRowEditor event to customize a cell editor in a data row.
    void Grid_CustomizeDataRowEditor(GridCustomizeDataRowEditorEventArgs e) {
        if(e.EditSettings is IDropDownEditSettings hireDateEditSettings)
        // or if(e.EditSettings is IDateEditSettings hireDateEditSettings)
            hireDateEditSettings.DropDownDirection = DropDownDirection.Up;
    }
    
See Also