Skip to main content

IGrid Members

An interface that defines the DxGrid component’s API members (properties and methods).

Properties

Name Description
AllowColumnReorder Specifies whether users can reorder columns.
AllowGroup Specifies whether users can group grid data.
AllowSelectRowByClick Specifies whether users can select and deselect rows by mouse clicks.
AllowSort Specifies whether users can sort grid data.
AutoCollapseDetailRow Specifies whether an expanded detail row should be automatically collapsed when a user expands another detail row.
AutoExpandAllGroupRows Specifies whether to expand all group rows automatically when the grid loads data or users interact with the grid.
ColumnCaptionAlignment Specifies the alignment of all column captions.
ColumnFooterTemplate Specifies a common template used to display all footer cells in the Grid.
ColumnGroupFooterTemplate Specifies a common template used to display all column’s group footers in the Grid.
ColumnHeaderCaptionTemplate Specifies a common template used to display captions of all column headers in the Grid.
ColumnResizeMode Specifies whether and how users can resize Grid columns.
CssClass Assign a CSS class to the Grid.
CustomValidators Allows you to declare custom validator components.
Data Specifies an object that supplies Grid data.
DataColumnCellDisplayTemplate Specifies a common template used to display all data column cells in the Grid.
DataColumnCellEditTemplate Allows you to replace automatically generated editors with custom content in all edit cells displayed for data columns.
DataColumnFilterMenuTemplate Specifies a common template used to display all column filter menus in the Grid.
DataColumnFilterRowCellTemplate Specifies a common template used to display all filter row cells in the Grid data columns.
DataColumnGroupRowTemplate Specifies a common template used to display all group rows in the Grid.
DetailExpandButtonDisplayMode Specifies when to display master-detail expand buttons.
DetailRowDisplayMode Specifies when to display detail rows in the Grid.
DetailRowTemplate Specifies a template used to display a detail row.
EditFormButtonsVisible Specifies whether the edit form contains the predefined Save and Cancel buttons.
EditFormTemplate Specifies the template used to display the edit form.
EditMode Specifies how users edit Grid data.
EditNewRowPosition Specifies the position of the edit form used to create new rows.
EditorRenderMode Specifies how the Grid renders editors in the filter row and in data rows during edit operations.
EmptyDataAreaTemplate Specifies the template used to display an empty data area.
FilterMenuButtonDisplayMode Specifies when the Grid displays filter menu buttons in column headers.
FocusedRowEnabled Specifies whether the row focus is enabled.
FooterDisplayMode Specifies when to display the footer in the Grid.
GroupFooterDisplayMode Specifies when to display group footers in the Grid.
HighlightRowOnHover Specifies whether to highlight a data row when a user hovers the mouse pointer over it.
KeyboardNavigationEnabled Obsolete. This property is now obsolete because the Grid component activates keyboard navigation and built-in shortcuts by default. Do not use this property in your project.
KeyFieldName Specifies the name of a data field that contains unique identifiers for Grid data items.
KeyFieldNames Specifies the names of data fields that contain key values. The combination of key values forms a unique identifier for a Grid data item.
PageIndex Specifies the grid’s active page index.
PagerAutoHideNavButtons Specifies whether arrow navigation buttons are hidden when all numeric buttons are displayed in the pager.
PagerNavigationMode Specifies how users navigate between Grid pages.
PagerPosition Specifies the pager position.
PagerSwitchToInputBoxButtonCount Specifies the number of pages when the pager switches from numeric buttons to the input box in Auto mode.
PagerVisible Specifies whether the Grid displays the pager.
PagerVisibleNumericButtonCount Specifies the maximum number of numeric buttons displayed in the pager.
PageSize Specifies the maximum number of rows that the grid can display on a page.
PageSizeSelectorAllRowsItemVisible Specifies whether the page size selector contains the All item.
PageSizeSelectorItems Specifies items available in the page size selector.
PageSizeSelectorVisible Specifies whether the Grid displays the page size selector in the pager.
PopupEditFormCssClass Assign a CSS class to the pop-up edit form.
PopupEditFormHeaderText Specifies text displayed in the pop-up edit form’s header.
SearchBoxInputDelay Specifies the time interval between the last typed character in the search box and the consequent search text update.
SearchBoxNullText Specifies the prompt text displayed in the search box when it is empty.
SearchBoxTemplate Specifies a template for the search box.
SearchText Specifies the text that the Grid uses to filter and highlight data.
SearchTextParseMode Specifies how the grid treats search words.
SelectAllCheckboxMode Specifies whether the Select All checkbox selects all rows on the current page or on all grid pages.
SelectedDataItem In single selection mode, specifies the data item that corresponds to the selected Grid row.
SelectedDataItems In multiple selection mode, specifies data items that correspond to selected Grid rows.
SelectionMode Specifies selection mode.
ShowAllRows Specifies whether the Grid displays all rows on one page.
ShowFilterRow Specifies whether the Grid displays the filter row.
ShowGroupedColumns Specifies whether to display grouped columns among other columns in the grid’s data area.
ShowGroupPanel Specifies whether to show the Group Panel.
ShowSearchBox Specifies whether the Grid displays the search box.
SizeMode Specifies the size of grid elements (for instance, text size and row height) and other components that are built-in to the grid (for instance, pager and buttons).
SkeletonRowsEnabled Specifies whether the Grid displays skeletons on row loading.
TextWrapEnabled Specifies whether the Grid wraps words or trims extra words and displays an ellipsis.
ToolbarTemplate Specifies a template for a toolbar area.
ValidationEnabled Specifies whether the Grid validates user input in DevExpress data editors located in the edit form or edit cells.
VirtualScrollingEnabled Specifies whether vertical virtual scrolling is enabled.

Methods

Name Description
AutoFitColumnWidths() Automatically adjusts column widths to their content.
AutoFitColumnWidths(Boolean) Obsolete. Automatically adjusts column widths to their content.
BeginUpdate() Suspends Grid updates caused by parameter changes and method calls until the EndUpdate() method is called.
CancelEditAsync() Cancels row editing and discards changes.
ClearFilter() Clears the filter applied to grid data.
ClearSelection() Clears selection.
ClearSort() Clears sorting.
CollapseAllDetailRows() Collapses all detail rows.
CollapseAllGroupRows() Collapses all group rows.
CollapseDetailRow(Int32) Collapses the specified detail row.
CollapseGroupRow(Int32, Boolean) Collapses the group row.
DeselectAllAsync() Deselects all rows in the grid.
DeselectAllOnPage() Deselects all rows on the current visible page.
DeselectDataItem(Object) Deselects a row that corresponds to the specified data item.
DeselectDataItems(IEnumerable<Object>) Deselects rows that correspond to the specified data items.
DeselectRow(Int32) Deselects a row with the specified visible index.
DeselectRows(IEnumerable<Int32>) Deselects rows with the specified visible indexes.
EndUpdate() Resumes Grid updates (when the BeginUpdate() method pauses updates) and re-renders the Grid.
ExpandAllGroupRows() Expands all group rows.
ExpandDetailRow(Int32) Expands the specified detail row.
ExpandGroupRow(Int32, Boolean) Expands the group row.
ExportToCsvAsync(Stream, GridCsvExportOptions) Exports grid data to a stream in CSV format.
ExportToCsvAsync(String, GridCsvExportOptions) Exports grid data in CSV format and downloads the result file to the client machine.
ExportToXlsAsync(Stream, GridXlExportOptions) Exports grid data to a stream in XLS format.
ExportToXlsAsync(String, GridXlExportOptions) Exports grid data in XLS format and downloads the result file to the client machine.
ExportToXlsxAsync(Stream, GridXlExportOptions) Exports grid data in XLSX format to a stream.
ExportToXlsxAsync(String, GridXlExportOptions) Exports grid data in XLSX format and downloads the result file to the client machine.
FilterBy(String, GridFilterRowOperatorType, Object) Filters data by the specified column value.
GetColumnEditSettings<T>(String) Returns editor settings of the column bound to the specified data source field.
GetColumns() Returns a column collection.
GetDataColumns() Returns a data column collection.
GetDataItem(Int32) Gets a data source item that is bound to the processed row.
GetDataItemValue(Object, String) Returns the field value of the specified data item.
GetEditContext() Returns the edit context.
GetFieldFilterCriteria(String) Returns the filter criteria applied to the specified field of the bound data source.
GetFilterCriteria() Returns the filter criteria applied to the grid data.
GetFocusedDataItem() Returns a data item bound to the focused data row.
GetFocusedRowIndex() Returns the visible index of the focused row.
GetGroupCount() Gets the number of grouped columns.
GetGroupSummaryDisplayText(IGridSummaryItem, Int32) Gets a group summary item’s display text.
GetGroupSummaryFormattedValue(IGridSummaryItem, Int32) Gets a group summary item’s formatted value.
GetGroupSummaryItems() Gets the collection of group summary items.
GetGroupSummaryLabel(IGridSummaryItem, Int32) Gets the name of a group summary‘s function name.
GetGroupSummaryValue(IGridSummaryItem, Int32) Gets a group summary item’s value.
GetPageCount() Returns the total number of pages in the Grid.
GetRowLevel(Int32) Gets the nesting level of the processed row.
GetRowValue(Int32, String) Gets the value of the data source field in the specified row.
GetSortedColumns() Get the collection of sorted columns.
GetStartRowVisibleIndex() Gets the visible index of the first row on the current page.
GetTotalSummaryDisplayText(IGridSummaryItem) Gets a total summary item’s display text.
GetTotalSummaryFormattedValue(IGridSummaryItem) Gets a total summary item’s formatted value.
GetTotalSummaryItems() Gets the collection of total summary items.
GetTotalSummaryLabel(IGridSummaryItem) Gets the name of a total summary‘s function name.
GetTotalSummaryValue(IGridSummaryItem) Gets a total summary item’s value.
GetVisibleColumns() Returns a column collection ordered based on visible indexes.
GetVisibleRowCount() Gets the total number of visible rows in the grid.
GroupBy(String, Int32) Groups data by values of the specified column and inserts the grouped column in the specified position between other grouped columns.
GroupBy(String) Groups data by values of the specified column.
IsDataItemFocused(Object) Identifies whether the row bound to the specified data item is focused.
IsDataItemSelected(Object) Returns whether the row that corresponds to the specified data item is selected.
IsDetailRowExpanded(Int32) Indicates whether the specified detail row is expanded.
IsEditing() Returns whether the Grid is currently being edited.
IsEditingNewRow() Returns whether a new Grid row is currently being edited.
IsEditingRow(Int32) Returns whether the specified Grid row is currently being edited.
IsGroupRow(Int32) Specifies whether the specified row is a group row.
IsGroupRowExpanded(Int32) Specifies whether the specified row is a group row.
IsRowFocused(Int32) Identifies whether the row with the specified visible index is focused.
IsRowSelected(Int32) Returns whether the specified row is selected.
LoadLayout(GridPersistentLayout) Restores the Grid’s layout.
MakeDataItemVisibleAsync(Object) Makes the row bound to the specified data item visible on screen.
MakeRowVisible(Int32) Makes the row with the specified visible index visible on screen.
RefreshSummary() Refreshes all total and group summary values in the grid.
Reload() Reloads Grid data.
SaveChangesAsync() Triggers validation and raises the EditModelSaving event if validation succeeds. The method immediately raises this event if validation is disabled.
SaveLayout() Saves information about the Grid’s layout.
SelectAllAsync(Boolean) Selects or deselects all rows in the grid.
SelectAllOnPage(Boolean) Selects or deselects all rows on the current visible page.
SelectDataItem(Object, Boolean) Selects or deselects a row that corresponds to the specified data item.
SelectDataItems(IEnumerable<Object>, Boolean) Selects or deselects rows that correspond to the specified data items.
SelectRow(Int32, Boolean) Selects or deselects a row with the specified visible index.
SelectRows(IEnumerable<Int32>, Boolean) Selects or deselects rows with the specified visible indexes.
SetFieldFilterCriteria(String, CriteriaOperator) Applies a filter to the specified data field.
SetFilterCriteria(CriteriaOperator) Applies a filter to grid data.
SetFocusedDataItemAsync(Object) Moves focus to the row bound to the specified data item.
SetFocusedRowIndex(Int32) Moves focus to the row with the specified visible index.
ShowColumnChooser() Shows the Column Chooser in the center of the grid.
ShowColumnChooser(DialogDisplayOptions) Shows the Column Chooser and position it according to the specified display options.
ShowColumnChooser(String) Shows the Column Chooser.
ShowDataItemDeleteConfirmation(Object) Displays the delete confirmation dialog for the specified data item.
ShowRowDeleteConfirmation(Int32) Displays the delete confirmation dialog for the specified row.
SortBy(String, GridColumnSortOrder, Int32) Sorts data by column values in the specified order, and specifies the sorted column’s index.
SortBy(String, GridColumnSortOrder) Sorts data by column values in the specified order.
SortBy(String) Sorts data by the specified column values.
StartEditDataItemAsync(Object, String) Starts editing the specified data item.
StartEditNewRowAsync(String) Starts editing a new row.
StartEditRowAsync(Int32, String) Starts editing the row with the specified visible index.
WaitForDataLoadAsync() Returns a task that completes when pending asynchronous data load operations are completed.
WaitForInstantFeedbackRowLoadAsync(Int32) Obsolete. Returns a task that is completed when the specified row of an asynchronous Instant Feedback Data Source is loaded.
WaitForRemoteSourceRowLoadAsync(Int32) Returns a task that is completed when the specified row of an asynchronous remote data source is loaded.
See Also