GridView.State Property
Gets the View’s current state.
Namespace: DevExpress.XtraGrid.Views.Grid
Assembly: DevExpress.XtraGrid.v24.2.dll
NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation
#Declaration
#Property Value
Type | Description |
---|---|
Grid |
A Grid |
Available values:
Name | Description |
---|---|
Normal | The View is in its normal state. No specific action is being performed by the end-user. |
Column |
A column’s right edge is being dragged to change the column’s width. The desired column’s Options |
Editing | A cell editor is presently active. |
Column |
A column header is being dragged. The desired column’s Options |
Column |
A column header is presently pressed. |
Column |
A filter button is presently pressed. |
Group |
The Find panel’s Find button is pressed. |
Row |
A detail clone View’s bottom edge is being dragged to resize the View vertically. |
Filter |
A filter close button is pressed. |
Column |
The header panel button is presently pressed. |
Row |
A data row’s bottom edge is being dragged to change row height. The View’s Grid |
Incremental |
Incremental search is being performed. |
Selection | Multiple rows are being selected using drag and drop. End-users must click an indicator cell and drag the mouse for this purpose. The Column |
Filter |
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. |
Filter |
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. |
Filter |
The button which is used to display a dropdown window with a list of the most recently used filter criteria is pressed. |
Filter |
A filter panel customize button is pressed. |
Cell |
Multiple cells are being selected by an end-user via a mouse. The Grid |
Scrolling | 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. |
Column |
A column header search button is pressed. |
Group |
The Search button displayed within the group panel is pressed. |
Header |
The user types within the column header (in column header search). |
Column |
Reserved for future use. |
Group |
Reserved for future use. |
Unknown | An unknown action is being performed within the Grid View. |
#Remarks
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.
Note
Detail pattern Views do not contain data and they are never displayed within Xtra
- Grid
Control. - returns the top most View in a grid;Main View - Grid
Control. - returns the focused View;Focused View - Grid
Control. - returns the currently maximized View;Default View - the sender parameter of View specific events;
- Grid
View. - returns a detail clone View for a specific master row.Get Detail View
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the State property.
Note
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.