LayoutView Events
Displays records as cards in one or more columns, in one or more rows, in an ellipse (carousel mode), or as a single card at a time. Supports complex card field layouts, built-in groups, tabbed groups, and labels.Name | Description |
---|---|
AsyncCompleted | Fires when async data loading has finished, in Instant Feedback Mode. Inherited from ColumnView. |
BeforeLeaveRow | Enables you to prevent row focus changes. Inherited from ColumnView. |
BeforeLoadLayout | Occurs before a layout is restored from storage (a stream, xml file or the system registry). Inherited from BaseView. |
CardClick | Occurs when a card is clicked. |
CardCollapsed | Fires immediately after a card has been collapsed. |
CardCollapsing | Provides the ability to prevent particular cards from being collapsed. |
CardExpanded | Fires immediately after a card has been expanded. |
CardExpanding | Provides the ability to prevent particular cards from being expanded. |
CellValueChanged | Fires immediately after a cell value has been changed. Inherited from ColumnView. |
CellValueChanging | Fires 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. Inherited from ColumnView. |
Click | Occurs when a View is clicked. Inherited from BaseView. |
ColumnChanged | Fires when changing a column’s properties. Inherited from ColumnView. |
ColumnFilterChanged | Occurs when a column’s filter condition changes. This event also raises when the Find Panel finishes its search. Inherited from ColumnView. |
ColumnPositionChanged | Allows you to respond to changing a column’s position within the View. Inherited from ColumnView. |
ColumnUnboundExpressionChanged | Fires after a column’s GridColumn.UnboundExpression property has been changed. Inherited from ColumnView. |
CustomCardCaptionImage | Allws you to display custom images within card captions. |
CustomCardLayout | Allows you to dynamically customize the layout of fields within specific cards. |
CustomCardStyle | Allows you to customize the appearance of a card’s caption and border. |
CustomColumnDisplayText | Allows you to replace cell display texts (for cells with textbox-based editors), group row texts, and filter menu item captions. Inherited from ColumnView. |
CustomColumnSort | Allows 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. Inherited from ColumnView. |
CustomDrawCardBackground | Allows you to highlight or manually paint a card’s border and background in a custom manner. |
CustomDrawCardCaption | Enables card captions to be custom painted. |
CustomDrawCardFieldCaption | Enables card field captions to be custom painted. |
CustomDrawCardFieldValue | Enables you to custom paint card field value cells |
CustomDrawEmptyForeground | Enables a View’s empty space to be custom painted when there aren’t any rows displayed. Inherited from ColumnView. |
CustomDrawFilterPanel | Enables you to paint the filter panel manually. Inherited from ColumnView. |
CustomDrawViewCaption | Enables you to paint the view caption. Inherited from ColumnView. |
CustomFieldCaptionImage | Allows you to dynamically display images in field captions. |
CustomFieldCaptionStyle | Allows you to customize the appearance of field captions in cards. |
CustomFieldEditingValueStyle | Allows you to customize the appearance of field value regions in edit mode. |
CustomFieldValueStyle | Allows you to customize the appearance of field value regions in display mode. |
CustomFilterDialog | Enables the Custom Filter Dialog to be replaced with custom filtering facilities. Inherited from ColumnView. |
CustomFilterDisplayText | Allows 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). Inherited from ColumnView. |
CustomRowCellEdit | Enables you to assign editors to individual cells. |
CustomRowFilter | Allows you to hide/show specific rows (that exist in the data source) based on a condition regardless of the grid’s filter. Inherited from ColumnView. |
CustomSeparatorStyle | Enables you to change the separator’s width and customize its appearance. |
CustomUnboundColumnData | Allows you to supply data to cells in visible unbound columns, and save values entered by users. Inherited from ColumnView. |
DataError | Fires when an error occurs in the data controller and allows you to handle the error. Inherited from ColumnView. |
DataManagerReset | Fires when significant data source changes occur. Inherited from ColumnView. |
DataSourceChanged | Occurs when the data source of the current View changes. Inherited from BaseView. |
Disposed | Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component. |
DoubleClick | Occurs when a View is double-clicked. Inherited from BaseView. |
EndGrouping | Fires after the grouping operation has been completed. Inherited from ColumnView. |
EndSorting | Fires after the sorting operation has been completed. Inherited from ColumnView. |
FieldValueClick | Occurs when a field value is clicked. |
FilterEditorCreated | Allows you to customize the Filter Editor before it is displayed on screen. Inherited from ColumnView. |
FilterExpressionEditorCreated | Allows you to customize the Expression Editor used to edit custom expressions that are displayed in the control’s Filter Editor. Inherited from ColumnView. |
FilterPopupExcelCustomizeTemplate | Allows you to customize templates for Excel-style filters and for external editors generated with Filtering UI Context. Inherited from ColumnView. |
FilterPopupExcelData | Allows 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. Inherited from ColumnView. |
FilterPopupExcelParseFilterCriteria | Allows you to parse the filter criteria applied to data and select the corresponding values in the filter menu. Inherited from ColumnView. |
FilterPopupExcelPrepareTemplate | Allows 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. Inherited from ColumnView. |
FilterPopupExcelQueryFilterCriteria | Fires when a filter criteria is about to be applied to data and allows you to customize the filter criteria. Inherited from ColumnView. |
FocusedColumnChanged | Fires in response to changing column focus. Inherited from ColumnView. |
FocusedRowChanged | Fires when row focus moves from one row to another. Inherited from ColumnView. |
FocusedRowLoaded | Fires when the focused row’s data has been loaded (in Instant Feedback Mode). Inherited from ColumnView. |
FocusedRowObjectChanged | Fires after focus is moved to another row object. Inherited from ColumnView. |
FormatRuleExpressionEditorCreated | Allows you to customize the Expression Editor embedded in the Edit Formatting Rule dialog. Inherited from ColumnView. |
FormatRuleManagerFormCreated | Fires when the Conditional Formatting Rules Manager is about to be displayed. Inherited from ColumnView. |
GotFocus | Occurs when a View receives focus. Inherited from BaseView. |
HiddenEditor | Fires immediately after an inplace editor has been closed. Inherited from ColumnView. |
HideCustomization | Fires after the Customization Form has been hidden. |
InitNewRow | Enables you to initialize added rows. Inherited from ColumnView. |
InvalidRowException | Fires when a row fails validation or when it cannot be saved to the data source. Inherited from ColumnView. |
InvalidValueException | Enables you to provide a proper response to entering an invalid cell value. Inherited from BaseView. |
KeyDown | Fires when a user presses a key while the View has focus. Inherited from BaseView. |
KeyPress | Fires when a character key is pressed while the View has focus. Inherited from BaseView. |
KeyUp | Occurs when releasing the pressed key. Inherited from BaseView. |
Layout | Fires immediately after a View’s layout has been changed. Inherited from BaseView. |
LayoutUpgrade | Occurs 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. |
LostFocus | Occurs when a View loses focus. Inherited from BaseView. |
MouseDown | Occurs when the mouse pointer is over a View and a mouse button is pressed. Inherited from BaseView. |
MouseEnter | Occurs when the mouse pointer enters the View. Inherited from BaseView. |
MouseLeave | Occurs when the mouse pointer leaves the View. Inherited from BaseView. |
MouseMove | Occurs when the mouse pointer moves over a View. Inherited from BaseView. |
MouseUp | Occurs when the mouse button is released if it was pressed within a View. Inherited from BaseView. |
MouseWheel | Occurs when the mouse wheel is moved while a View has focus. Inherited from BaseView. |
PaintStyleChanged | Fires after the View’s paint style has changed. Inherited from BaseView. |
ParseFindPanelText | Fires 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. Inherited from ColumnView. |
PrintExportCompleted | Allows you to determine whether the view data was printed or exported without errors. Inherited from BaseView. |
PrintExportProgress | Fires repeatedly while the View’s data is being printed/exported. Inherited from BaseView. |
PrintInitialize | Allows you to customize general print/export settings when the View is about to be printed/exported. Inherited from BaseView. |
PropertyDeserializing | Allows you to restore certain settings previously saved in the layout. Inherited from BaseView. |
PropertySerializing | Allows you to include certain settings in the layout when you save it. Inherited from BaseView. |
QueryCustomFunctions | Allows 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. Inherited from ColumnView. |
RowCellDefaultAlignment | Enables you to specify content alignment for individual cells. Inherited from ColumnView. |
RowCountChanged | Occurs when the number of visible records is changed within a View. Inherited from BaseView. |
RowDeleted | Fires after a data row is deleted. Inherited from ColumnView. |
RowDeleting | Fires when a data row is about to be deleted. Inherited from ColumnView. |
RowEditCanceled | Fires after row editing was canceled. Inherited from ColumnView. |
RowLoaded | Fires when a row’s data has been loaded (in Instant Feedback Mode). Inherited from ColumnView. |
RowUpdated | Occurs after changes made to a focused data row have been saved to an underlying data source. Inherited from ColumnView. |
SelectionChanged | Fires when row/cell selection is changed. In v21.1 and higher, the event fires both in single and multiple row selection modes. Inherited from ColumnView. |
SelectionChanging | Allows you to specify whether users can select and unselect rows. Inherited from ColumnView. |
ShowCustomization | Fires before the Customization Form is opened. |
ShowFilterPopupCheckedListBox | Allows you to customize checked filter dropdown lists before they are displayed. Inherited from ColumnView. |
ShowFilterPopupDate | Allows you to customize the filter dropdown for date-time columns. Inherited from ColumnView. |
ShowFilterPopupExcel | Allows you to hide specific filter conditions from Filters and Values tabs of the Excel-style Drop-down Filter. Inherited from ColumnView. |
ShowFilterPopupListBox | Enables you to customize a particular column’s filter dropdown list. Inherited from ColumnView. |
ShowingEditor | Occurs when a cell editor is about to open, and allows you to cancel the action. Inherited from ColumnView. |
ShownEditor | Fires immediately after a cell editor is invoked. Inherited from ColumnView. |
StartGrouping | Fires before a grouping operation is started. Inherited from ColumnView. |
StartSorting | Fires before a sorting operation is started. Inherited from ColumnView. |
SubstituteFilter | Allows you to update or replace the filter that is about to be applied with a custom filter. Inherited from ColumnView. |
SubstituteSortInfo | For internal use only. Inherited from ColumnView. |
UnboundExpressionEditorCreated | Fires after an Expression Editor has been created for an unbound column. Inherited from ColumnView. |
ValidateRow | Fires 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). Inherited from ColumnView. |
ValidatingEditor | Fires 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. |
VisibleRecordIndexChanged | Fires on scrolling the Layout View. |
See Also