Back to Devexpress

ColumnView Events

windowsforms-devexpress-dot-xtragrid-dot-views-dot-base-dot-columnview-dot-underscore-events.md

latest20.4 KB
Original Source

ColumnView Events

The base class for Views that display tabular data.

NameDescription
AsyncCompletedFires when async data loading has finished, in Instant Feedback Mode.
BeforeLeaveRowOccurs before the focused row changes. Handle this event to prevent the focused row change.
BeforeLoadLayoutOccurs before a layout is restored from storage (a stream, xml file or the system registry). Inherited from BaseView.
CellValueChangedFires immediately after a cell value has been changed.
CellValueChangingFires when a user changes a cell value: types or deletes a character, chooses a value from the dropdown list, etc. Does not fire when you change cell values in code.
ClickOccurs when a View is clicked. Inherited from BaseView.
ColumnChangedFires when changing a column’s properties.
ColumnFilterChangedOccurs when a column’s filter condition changes. This event also raises when the Find Panel finishes its search.
ColumnPositionChangedAllows you to respond to changing a column’s position within the View.
ColumnUnboundExpressionChangedFires after a column’s GridColumn.UnboundExpression property has been changed.
CustomColumnDisplayTextAllows you to replace cell display text (for cells with textbox-based editors), group row text, and filter menu item captions.
CustomColumnSortAllows you to implement custom rules according to which a Grid column will sort its data. A column uses these custom rules only when its GridColumn.SortMode property is set to ColumnSortMode.Custom.
CustomDrawEmptyForegroundEnables a View’s empty space to be custom painted when there aren’t any rows displayed.
CustomDrawFilterPanelEnables you to paint the filter panel manually.
CustomDrawViewCaptionEnables you to paint the view caption.
CustomFilterDialogEnables the Custom Filter Dialog to be replaced with custom filtering facilities.
CustomFilterDisplayTextAllows you to set a custom Filter Panel text. This techique is aplicable only when the Filter Panel is in “Text” mode (see the FilterCriteriaDisplayStyle property).
CustomRowFilterAllows you to hide/show specific rows (that exist in the data source) based on a condition regardless of the grid’s filter.
CustomUnboundColumnDataAllows you to supply data to cells in visible unbound columns, and save values entered by users.
DataErrorFires when an error occurs in the data controller and allows you to handle the error.
DataManagerResetFires when significant data source changes occur.
DataSourceChangedOccurs when the data source of the current View changes. Inherited from BaseView.
DisposedOccurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DoubleClickOccurs when a View is double-clicked. Inherited from BaseView.
EndGroupingFires after the grouping operation has been completed.
EndSortingFires after the sorting operation has been completed.
FilterEditorCreatedAllows you to customize the Filter Editor before it is displayed on screen.
FilterExpressionEditorCreatedAllows you to customize the Expression Editor used to edit custom expressions that are displayed in the control’s Filter Editor.
FilterPopupExcelCustomizeTemplateAllows you to customize templates for Excel-style filters and for external editors generated with Filtering UI Context.
FilterPopupExcelDataAllows you to add, remove, and modify data values and customize predefined filters in the Excel style pop-up filter menus. Filter items added manually on this event must be unique and sorted.
FilterPopupExcelParseFilterCriteriaAllows you to parse the filter criteria applied to data and select the corresponding values in the filter menu.
FilterPopupExcelPrepareTemplateAllows you to replace the UI for the Excel-styled menus’ “Values” tab. Also affects editors generated by the Filtering UI Context component attached to this Data Grid.
FilterPopupExcelQueryFilterCriteriaFires when a filter criteria is about to be applied to data and allows you to customize the filter criteria.
FocusedColumnChangedFires in response to changing column focus.
FocusedRowChangedFires when the focused row’s handle changes.
FocusedRowLoadedFires when the focused row’s data has been loaded (in Instant Feedback Mode).
FocusedRowObjectChangedFires after focus is moved to another row object.
FormatRuleExpressionEditorCreatedAllows you to customize the Expression Editor embedded in the Edit Formatting Rule dialog.
FormatRuleManagerFormCreatedFires when the Conditional Formatting Rules Manager is about to be displayed.
GotFocusOccurs when a View receives focus. Inherited from BaseView.
HiddenEditorFires immediately after an inplace editor has been closed.
InitNewRowEnables you to initialize added rows.
InvalidRowExceptionFires when a row fails validation or when it cannot be saved to the data source.
InvalidValueExceptionEnables you to provide a proper response to entering an invalid cell value. Inherited from BaseView.
KeyDownFires when a user presses a key while the View has focus. Inherited from BaseView.
KeyPressFires when a character key is pressed while the View has focus. Inherited from BaseView.
KeyUpOccurs when releasing the pressed key. Inherited from BaseView.
LayoutFires immediately after a View’s layout has been changed. Inherited from BaseView.
LayoutUpgradeOccurs when a layout is restored from storage (a stream, xml file or system registry) and its version differs from the version of the current View’s layout. Inherited from BaseView.
LostFocusOccurs when a View loses focus. Inherited from BaseView.
MouseDownOccurs when the mouse pointer is over a View and a mouse button is pressed. Inherited from BaseView.
MouseEnterOccurs when the mouse pointer enters the View. Inherited from BaseView.
MouseLeaveOccurs when the mouse pointer leaves the View. Inherited from BaseView.
MouseMoveOccurs when the mouse pointer moves over a View. Inherited from BaseView.
MouseUpOccurs when the mouse button is released if it was pressed within a View. Inherited from BaseView.
MouseWheelOccurs when the mouse wheel is moved while a View has focus. Inherited from BaseView.
PaintStyleChangedFires after the View’s paint style has changed. Inherited from BaseView.
ParseFindPanelTextFires after the query in the find panel changes. Allows you to create a filter condition based on the query and specify how to highlight results in the control.
PrintExportCompletedAllows you to determine whether the view data was printed or exported without errors. Inherited from BaseView.
PrintExportProgressFires repeatedly while the View’s data is being printed/exported. Inherited from BaseView.
PrintInitializeAllows you to customize general print/export settings when the View is about to be printed/exported. Inherited from BaseView.
PropertyDeserializingAllows you to restore certain settings previously saved in the layout. Inherited from BaseView.
PropertySerializingAllows you to include certain settings in the layout when you save it. Inherited from BaseView.
QueryCustomFunctionsAllows you to add custom-function-based filters (for example, ‘discount is more than 15%’) to Excel-style pop-up filter menus and/or the filter editor.
RowCellDefaultAlignmentEnables you to specify content alignment for individual cells.
RowCountChangedOccurs when the number of visible records is changed within a View. Inherited from BaseView.
RowDeletedFires after a data row is deleted.
RowDeletingFires when a data row is about to be deleted.
RowEditCanceledFires after row editing was canceled.
RowLoadedFires when a row’s data has been loaded (in Instant Feedback Mode).
RowUpdatedOccurs after changes made to a focused data row have been saved to an underlying data source.
SelectionChangedFires when row/cell selection is changed. In v21.1 and higher, the event fires both in single and multiple row selection modes.
SelectionChangingAllows you to specify whether users can select and unselect rows.
ShowFilterPopupCheckedListBoxAllows you to customize checked filter dropdown lists before they are displayed.
ShowFilterPopupDateAllows you to customize the filter dropdown for date-time columns.
ShowFilterPopupExcelAllows you to hide specific filter conditions from Filters and Values tabs of the Excel-style Drop-down Filter.
ShowFilterPopupListBoxEnables you to customize a particular column’s filter dropdown list.
ShowingEditorOccurs when a cell editor is about to open, and allows you to cancel the action.
ShownEditorFires immediately after a cell editor is invoked.
StartGroupingFires before a grouping operation is started.
StartSortingFires before a sorting operation is started.
SubstituteFilterAllows you to update or replace the filter that is about to be applied with a custom filter.
SubstituteSortInfoFor internal use only.
UnboundExpressionEditorCreatedFires after an Expression Editor has been created for an unbound column.
ValidateRowFires when a user edits row cell values and attempts to select another row. Handle this event to check whether these new values are valid, and if not, choose the required behavior (discard edits, show a warning message, ignore errors, or keep the focus on this row until a user enters valid values).
ValidatingEditorFires when a user edits a row cell value and attempts to select another cell. Handle this event to check whether this new value is valid, and if not, choose the required behavior (discard edits, show a warning message, ignore errors, or keep the focus on this cell until a user enters valid values). This event allows you to track edits made in the Edit Form. Inherited from BaseView.

See Also

ColumnView Class

ColumnView Members

DevExpress.XtraGrid.Views.Base Namespace