menu

WinForms

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class TableListChangedEventArgs - API Reference

    Show / Hide Table of Contents

    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
    System.Object
    TableListChangedEventArgs
    Namespace: Syncfusion.Grouping
    Assembly: Syncfusion.Grouping.Base.dll
    Syntax
    public class TableListChangedEventArgs : ListChangedEventArgs
    Remarks

    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.

    Back to top Generated by DocFX
    Copyright © 2001 - 2023 Syncfusion Inc. All Rights Reserved