Class TableListChangedEventArgs
Represents the class that provides the data for the SourceListListChanged event that occurs before the System.ComponentModel.Table processes the System.ComponentModel.IBindingList.ListChanged event of an attached source list. More detailed SourceListRecordChanged events will be raised after this event.
Inheritance
Namespace: Syncfusion.Grouping
Assembly: Syncfusion.Grouping.Base.dll
Syntax
public class TableListChangedEventArgs : ListChangedEventArgsRemarks
The reason for firing this event is to give a programmer the 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.
Constructors
TableListChangedEventArgs(Table, ListChangedType, Int32, PropertyDescriptor)
Initializes a new instance of the TableListChangedEventArgs class.
Declaration
public TableListChangedEventArgs(Table table, ListChangedType listChangedType, int newIndex, PropertyDescriptor propDesc)Parameters
| Type | Name | Description |
|---|---|---|
| Table | table | The table object. |
| System.ComponentModel.ListChangedType | listChangedType | Gets the way that the list changed. |
| System.Int32 | newIndex | Gets the new index of the item in the list. |
| System.ComponentModel.PropertyDescriptor | propDesc | The PropertyDescriptor describing the item. |
TableListChangedEventArgs(Table, ListChangedType, Int32, Int32)
Initializes a new instance of the TableListChangedEventArgs class.
Declaration
public TableListChangedEventArgs(Table table, ListChangedType listChangedType, int newIndex, int oldIndex)Parameters
| Type | Name | Description |
|---|---|---|
| Table | table | The table object. |
| System.ComponentModel.ListChangedType | listChangedType | Gets the way that the list changed. |
| System.Int32 | newIndex | Gets the new index of the item in the list. |
| System.Int32 | oldIndex | Gets the old index of the item in the list. |
Properties
NavigateCurrentRecordWhenDeleted
Gets or sets the value indicating whether to navigate or not when the current record is deleted.
Declaration
public bool NavigateCurrentRecordWhenDeleted { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
Lets you specify whether the current record should be moved to the previous visible record when an ItemDeleted notification is received for the current record.
By default, the table deactivates the current record. You can avoid this action and force the record to moved if you set this property to True.
ShouldIgnoreReset
Gets or sets the value indicating whether to ignore the reset value or not.
Declaration
public bool ShouldIgnoreReset { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
If the a ListChangedType.Reset notification should be ignored then you set ShouldIgnoreReset = true the table will not set itself dirty and also not repaint the screen. Normally, a listener on a DataView needs to completely reinitialize itself when ListChangedType.Reset is raised because the underlying data source might have been sorted or otherwise changes. Sometimes however you may want to call CurrencyManager.Reset or call DataTable.AcceptChanges without reinitializing the grid. In such case this property will help you avoid delays. The default value for ShouldIgnoreReset is false.
There is an exception when the grid will always handle the Reset event and ignores this setting when the grid detects that the record count it has cached differs from the record count of the underlying source list. In that case the table must be marked dirty to avoid the data and the table to go out of sync.
ShouldInvalidateCounters
Gets or sets the value that indicates whether to resets the counters or not.
Declaration
public bool ShouldInvalidateCounters { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
When specified as counters need to be marked dirty when a ListChanged event is handled. By default, the table does not know whether fields that are changes in a record will affect the counter logic and therefore will always mark all counters dirty from the bottom up. This has performance implications for the next time you need position information about a record (or simply when you call InvalidateRange and the YAmount counter is accessed).
When counters are not marked dirty, subsequent operations that need record position or y-amount position will be much faster. Counters only need to be marked dirty when there is a chance that the sort order is affected or if filter / hidden state of a record is affected or if custom counters are used.
ShouldInvalidateGroupSortOrder
Gets or sets the value indicating whether to reset the group sort order or not.
Declaration
public bool ShouldInvalidateGroupSortOrder { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
Lets you specify if changes to the current record affect the sort order of the parent group
This property only has an affect when a record is changed and you have specified a SortColumnDescriptor.GroupSortOrderComparer for the grouped column, e.g. if you want groups to be sorted by the value of a summary column.
If you know that changes to a specific record won't affect the sort order you can avoid unnecessary resorting of the parent group by setting this property to false.
ShouldInvalidateScreen
Gets or sets the value indicating whether to resets the screen or not.
Declaration
public bool ShouldInvalidateScreen { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
Specified if the grid should repaint the record when changes to the record were made in the underlying data source and a ListChangedType.ItemChanged notification was raised. The default value for ShouldInvalidateScreen is true.
ShouldInvalidateSummaries
Gets or sets the value indicating whether to reset the summaries or not.
Declaration
public bool ShouldInvalidateSummaries { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
specified whether summaries need to be marked dirty when a ListChanged event is handled. By default, the table does not know whether fields that are changed in a record will affect the summaries logic and therefore will always mark all summaries dirty from the bottom up.
ShouldReevaluateSortPosition
Gets or set the value indicating whether to re-evaluate the sort position or not.
Declaration
public bool ShouldReevaluateSortPosition { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
Lets you specify if changes to the current record affect the sort position of the record.
Set this property if you sorted or grouped by an expression field that is dependent on changes in other values of the record. The engine does not track dependencies among fields.
ShouldResetCurrentRecord
Gets or sets a value indicating whether to reset the current record or not.
Declaration
public bool ShouldResetCurrentRecord { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Remarks
Lets you specify whether the current record should be reset when an ItemChanged notification is received for the current record. By default, the table resets the current record, but you can avoid this action if you set this property to False.
Table
Gets or sets the value of the Table instance.
Declaration
[TraceProperty(true)]
public Table Table { get; set; }Property Value
| Type | Description |
|---|---|
| Table |
Methods
Create(Table, ListChangedType, Int32, Int32, PropertyDescriptor)
Creates an instance of the TableListChangedEventArgs class.
Declaration
public static TableListChangedEventArgs Create(Table table, ListChangedType listChangedType, int newIndex, int oldIndex, PropertyDescriptor propDesc)Parameters
| Type | Name | Description |
|---|---|---|
| Table | table | The table object. |
| System.ComponentModel.ListChangedType | listChangedType | Gets the way that the list changed. |
| System.Int32 | newIndex | Gets the new index of the item in the list. |
| System.Int32 | oldIndex | Gets the old index of the item in the list. |
| System.ComponentModel.PropertyDescriptor | propDesc | The PropertyDescriptor describing the item. |
Returns
| Type | Description |
|---|---|
| TableListChangedEventArgs | The instance of the TableListChangedEventArgs class. |