Skip to main content

GridView.State Property

Gets the View’s current state.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation


public virtual GridState State { get; }

Property Value

Type Description

A GridState enumeration member indicating the View’s current state

Available values:

Show 25 items
Name Description

The View is in its normal state. No specific action is being performed by the end-user.


A column’s right edge is being dragged to change the column’s width. The desired column’s OptionsColumn.AllowSize option must be enabled to allow such resizing.


A cell editor is presently active.


A column header is being dragged. The desired column’s OptionsColumn.AllowMove and View’s GridOptionsCustomization.AllowColumnMoving options must be enabled to allow column header dragging (the default behavior).


A column header is presently pressed.


A filter button is presently pressed.


The Find panel’s Find button is pressed.


A detail clone View’s bottom edge is being dragged to resize the View vertically.


A filter close button is pressed.


The header panel button is presently pressed.


A data row’s bottom edge is being dragged to change row height. The View’s GridOptionsCustomization.AllowRowSizing option must be enabled to allow such resizing operations.


Incremental search is being performed.


Multiple rows are being selected using drag and drop. End-users must click an indicator cell and drag the mouse for this purpose. The ColumnViewOptionsSelection.MultiSelect option must be enabled to allow such selections.


A check box residing in a filter panel is pressed. This implies that the filter criteria applied to a View is going to be enabled or disabled.


The string in the filter panel which represents the filter criteria applied to a View is pressed. This shows/hides a dropdown window with a list of the most recently used filter criteria.


The button which is used to display a dropdown window with a list of the most recently used filter criteria is pressed.


A filter panel customize button is pressed.


Multiple cells are being selected by an end-user via a mouse. The GridOptionsSelection.MultiSelectMode property must be set to the GridMultiSelectMode.CellSelect value to make this operation available.


A View is being scrolled. This implies that an end-user depresses the mouse wheel and moves the mouse to scroll the View’s contents.


A column header search button is pressed.


The Search button displayed within the group panel is pressed.


The user types within the column header (in column header search).


Reserved for future use.


Reserved for future use.


An unknown action is being performed within the Grid View.


Use this property to determine which action is being performed by the end-user. Refer to the GridState enumeration description for a list of all available states.

An example of using the State property can include suspension of a given operation until the end-user completes an action against the grid control. For instance, you may need to display a notification message and suspend it if the user is performing a dragging operation at a given moment in time.


Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the State member must not be invoked for these Views. The State member can only be used with Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

The following code snippets (auto-collected from DevExpress Examples) contain references to the State property.


The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also