Interface ITableEventsTarget
Provides functionalities that handles events raised by Table objects.
Namespace: Syncfusion.Grouping
Assembly: Syncfusion.Grouping.Base.dll
Syntax
public interface ITableEventsTargetMethods
OnCategorizedRecords(TableEventArgs)
Occurs after records are categorized after a table is marked dirty (TableDirty).
Declaration
void OnCategorizedRecords(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |
Remarks
When TableDirty is set to True, e.g. because schema information for a table was changed or because the grouped columns were changed, the table will categorize records on demand the first time information about a record is accessed. At that time, the EnsureInitialized(Object, Boolean) will start categorization.
OnCategorizingRecords(TableEventArgs)
Occurs before records are categorized after a table is marked dirty (TableDirty).
Declaration
void OnCategorizingRecords(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |
Remarks
When TableDirty is set to True, e.g. because schema information for a table was changed or because the grouped columns were changed, the table will categorize records on demand the first time information about a record is accessed. At that time, the EnsureInitialized(Object, Boolean) of the Table will start categorization.
OnCurrentRecordContextChange(CurrentRecordContextChangeEventArgs)
Occurs before and after the status of the current record was changed. Check the Action of the CurrentRecordContextChangeEventArgs to get information which current record state was changed.
Declaration
void OnCurrentRecordContextChange(CurrentRecordContextChangeEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| CurrentRecordContextChangeEventArgs | e |
OnCurrentRecordManagerReset(TableEventArgs)
Occurs when the Reset() method of the CurrentRecordManager was called.
Declaration
void OnCurrentRecordManagerReset(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |
Remarks
The GridGroupingControl listens to this event and resets any "Current Cell" state when this event was raised.
OnDisplayElementChanged(DisplayElementChangedEventArgs)
After number of visible elements were changed.
Declaration
void OnDisplayElementChanged(DisplayElementChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| DisplayElementChangedEventArgs | e |
OnDisplayElementChanging(DisplayElementChangingEventArgs)
When number of visible elements are changed.
Declaration
void OnDisplayElementChanging(DisplayElementChangingEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| DisplayElementChangingEventArgs | e |
OnExceptionRaised(ExceptionRaisedEventArgs)
Occurs when an unknown exception has been caught while modifying underlying data in the data source.
Declaration
void OnExceptionRaised(ExceptionRaisedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| ExceptionRaisedEventArgs | e |
Remarks
If necessary, you can re-throw the exception in your event handler.
OnGroupAdded(GroupEventArgs)
Occurs when a new group was added in a table after the table was categorized and when a record was changed. The event does not occur during categorization of the table. See the CategorizedRecords elements to when categorization finished.
Declaration
void OnGroupAdded(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupCollapsed(GroupEventArgs)
Occurs after a group is collapsed.
Declaration
void OnGroupCollapsed(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupCollapsing(GroupEventArgs)
Occurs before a group is collapsed.
Declaration
void OnGroupCollapsing(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupExpanded(GroupEventArgs)
Occurs after a group is expanded.
Declaration
void OnGroupExpanded(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupExpanding(GroupEventArgs)
Occurs before a group is expanded.
Declaration
void OnGroupExpanding(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupRemoving(GroupEventArgs)
Occurs when a group was removed from a table after the table was categorized and when a record was changed. The event does not occur during categorization of the table. See the CategorizedRecords elements to when categorization finished.
Declaration
void OnGroupRemoving(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
OnGroupSummaryInvalidated(GroupEventArgs)
Occurs when a summary has been marked dirty.
Declaration
void OnGroupSummaryInvalidated(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
Remarks
The GridGroupingControl listens to this event will force a repaint of the specified summary if it is visible when this event was raised.
OnInvalidatingCounters(TableEventArgs)
Occurs when the InvalidateCounterTopDown(Boolean) of a Table is called and before all counters are marked dirty.
Declaration
void OnInvalidatingCounters(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |
OnInvalidatingSummaries(TableEventArgs)
Occurs when the InvalidateSummariesTopDown() of a Table is called and before all summaries in that table are marked dirty.
Declaration
void OnInvalidatingSummaries(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |
OnRecordCollapsed(RecordEventArgs)
Occurs after a record with nested tables is collapsed.
Declaration
void OnRecordCollapsed(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordCollapsing(RecordEventArgs)
Occurs before a record with nested tables is collapsed.
Declaration
void OnRecordCollapsing(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordDeleted(RecordEventArgs)
Occurs after a record is deleted.
Declaration
void OnRecordDeleted(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordDeleting(RecordEventArgs)
Occurs before a record is deleted.
Declaration
void OnRecordDeleting(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordExpanded(RecordEventArgs)
Occurs after a record with nested tables is expanded.
Declaration
void OnRecordExpanded(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordExpanding(RecordEventArgs)
Occurs before a record with nested tables is expanded.
Declaration
void OnRecordExpanding(RecordEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordEventArgs | e |
OnRecordValueChanged(RecordValueChangedEventArgs)
Occurs when a RecordFieldCell cell's value is changed and after Record.SetValue returned.
Declaration
void OnRecordValueChanged(RecordValueChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordValueChangedEventArgs | e |
OnRecordValueChanging(RecordValueChangingEventArgs)
Occurs when a RecordFieldCell cell's value is changed and before Record.SetValue is called.
Declaration
void OnRecordValueChanging(RecordValueChangingEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordValueChangingEventArgs | e |
OnSelectedRecordsChanged(SelectedRecordsChangedEventArgs)
Occurs after the SelectedRecords collection was modified.
Declaration
void OnSelectedRecordsChanged(SelectedRecordsChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| SelectedRecordsChangedEventArgs | e |
OnSelectedRecordsChanging(SelectedRecordsChangedEventArgs)
Occurs before the SelectedRecords collection was modified.
Declaration
void OnSelectedRecordsChanging(SelectedRecordsChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| SelectedRecordsChangedEventArgs | e |
OnSortedItemsInGroup(GroupEventArgs)
Occurs after the records for a group were sorted.
Declaration
void OnSortedItemsInGroup(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
Remarks
The engine has a built-in optimization for sorting columns that allows it to perform the sorting on an on-demand basis group-by-group. Suppose you have a table with 200 different countries and you change the sort order of the cities. It is not necessary to sort the whole table. Instead, the individual groups can be sorted when they are scrolled into view. SortingItemsInGroup and SortedItemsInGroup events are fired in such case when a specific group was sorted on demand.
If the whole table was set dirty (see TableDirty), then the whole table is simply recategorized. In that case, only a CategorizedElements event is raised but no SortingItemsInGroup event.
OnSortingItemsInGroup(GroupEventArgs)
Occurs before the records for a group are sorted.
Declaration
void OnSortingItemsInGroup(GroupEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| GroupEventArgs | e |
Remarks
The engine has a built-in optimization for sorting columns that allows it to perform the sorting on an on-demand basis group-by-group. Suppose you have a table with 200 different countries and you change the sort order of the cities. It is not necessary to sort the whole table. Instead, the individual groups can be sorted when they are scrolled into view. SortingItemsInGroup and SortedItemsInGroup events are fired in such case when a specific group was sorted on demand.
If the whole table was set dirty (see TableDirty), then the whole table is simply recategorized. In that case, only a CategorizedElements event is raised but no SortingItemsInGroup event.
OnSourceListListChanged(TableListChangedEventArgs)
Occurs before the Table processes the System.ComponentModel.IBindingList.ListChanged event of an attached source list. More detailed SourceListRecordChanged events will be raised after this event.
Declaration
void OnSourceListListChanged(TableListChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableListChangedEventArgs | e |
Remarks
The reason for firing this event is to give a programmer a chance to react to an System.ComponentModel.IBindingList.ListChanged event before the engine since there is otherwise no order guaranteed when an IBindingList raises a ListChanged event.
OnSourceListListChangedCompleted(TableListChangedEventArgs)
Occurs after the Table processes the System.ComponentModel.IBindingList.ListChanged event of an attached source list.
Declaration
void OnSourceListListChangedCompleted(TableListChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableListChangedEventArgs | e |
Remarks
The reason for firing this event is to give a programmer the chance to react to an System.ComponentModel.IBindingList.ListChanged event right after the engine since there is otherwise no order guaranteed when an IBindingList raises a ListChanged event.
OnSourceListRecordChanged(RecordChangedEventArgs)
Occurs before the Table processes the System.ComponentModel.IBindingList.ListChanged event of an attached source list. More detailed SourceListRecordChanged events will be raised after this event.
Declaration
void OnSourceListRecordChanged(RecordChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordChangedEventArgs | e |
Remarks
The reason for firing this event is to give a programmer chance to react to an System.ComponentModel.IBindingList.ListChanged event before the engine since there is otherwise no order guaranteed when an IBindingList raises a ListChanged event.
OnSourceListRecordChanging(RecordChangedEventArgs)
Occurs when a record in the underlying data source is added, removed, or changed and before the Table is updated with that change.
Declaration
void OnSourceListRecordChanging(RecordChangedEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| RecordChangedEventArgs | e |
OnTableSourceListChanged(TableEventArgs)
Occurs after the data source is replaced.
Declaration
void OnTableSourceListChanged(TableEventArgs e)Parameters
| Type | Name | Description |
|---|---|---|
| TableEventArgs | e |