menu

WinForms

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class GridAddNewRecordSection - WindowsForms API Reference | Syncfusion

    Show / Hide Table of Contents

    Class GridAddNewRecordSection

    The section with the AddNewRecord:

    Inheritance
    System.Object
    Element
    Section
    DetailsSection
    RecordsDetails
    AddNewRecordSection
    GridAddNewRecordSection
    Implements
    System.IDisposable
    ITreeTableCounterSource
    ITreeTableSummaryArraySource
    IGridTableCellAppearanceSource
    Inherited Members
    AddNewRecordSection.AddNewRecord
    AddNewRecordSection.IsBeforeDetails
    AddNewRecordSection.ToString()
    DetailsSection.GetCustomCount()
    DetailsSection.GetElementCount()
    DetailsSection.GetFilteredRecordCount()
    DetailsSection.GetRecordCount()
    DetailsSection.GetVisibleCount()
    DetailsSection.GetVisibleCustomCount()
    DetailsSection.GetYAmountCount()
    DetailsSection.HasRecords
    DetailsSection.InvalidateCounter()
    DetailsSection.InvalidateCounterTopDown(Boolean)
    DetailsSection.InvalidateSummariesTopDown()
    DetailsSection.InvalidateSummary()
    Element.ChildTableGroupLevel
    Element.Dispose()
    Element.Disposed
    Element.Disposing
    Element.EnsureInitialized(Object)
    Element.EnsureInitialized(Object, Boolean)
    Element.GetCaptionSection()
    Element.GetCaptionSection(Element)
    Element.GetChildCount()
    Element.GetColumnHeaderSection()
    Element.GetColumnHeaderSection(Element)
    Element.GetCustomPosition()
    Element.GetData()
    Element.GetFilterBar()
    Element.GetFilterBar(Element)
    Element.GetRecord()
    Element.GetRecord(Element)
    Element.GetSummaries(Table)
    Element.GetSummaries(Table, Boolean)
    Element.GetVisibleCustomPosition()
    Element.GetVisibleInHierarchy()
    Element.GetVisibleInParent()
    Element.GroupLevel
    Element.Id
    Element.InDisposed
    Element.Info
    Element.InvalidateCounterBottomUp()
    Element.IsCaption()
    Element.IsCaption(Element)
    Element.IsChildVisible(Element)
    Element.IsColumnHeader()
    Element.IsColumnHeader(Element)
    Element.IsDisposed
    Element.IsFilterBar()
    Element.IsFilterBar(Element)
    Element.IsRecord()
    Element.IsRecord(Element)
    Element.ITreeTableSummaryArraySource.GetSummaries(ITreeTableEmptySummaryArraySource, Boolean)
    Element.Kind
    Element.OnBeginEditCalled()
    Element.OnBeginEditComplete(Boolean)
    Element.OnCancelEditCalled()
    Element.OnCancelEditComplete(Boolean)
    Element.OnDisposed(EventArgs)
    Element.OnElementTreeInvalidateCounterBottomUp()
    Element.OnEndEditCalled()
    Element.OnEndEditComplete(Boolean)
    Element.OnEnterRecordCalled()
    Element.OnEnterRecordComplete(Boolean)
    Element.OnLeaveRecordCalled()
    Element.OnLeaveRecordComplete(Boolean)
    Element.ParentDisplayElement
    Element.ParentGroup
    Element.ParentSection
    Element.Reserved1
    Element.Reserved10
    Element.Reserved11
    Element.Reserved16a
    Element.Reserved16b
    Element.Reserved16c
    Element.Reserved2
    Element.Reserved3
    Element.Reserved4
    Element.Reserved5
    Element.Reserved6
    Element.Reserved7
    Element.Reserved8
    Element.Reserved9
    Element.SupportsId()
    Element.TableLevel
    RecordsDetails.CompareSortedColumns()
    RecordsDetails.FilteredRecords
    RecordsDetails.OnEnsureInitialized(Object)
    RecordsDetails.Records
    RecordsDetails.UpdateSortedColumns()
    Section.GetCounter()
    Section.InvalidateSummariesBottomUp()
    Section.ParentElement
    System.Object.Equals(System.Object)
    System.Object.Equals(System.Object, System.Object)
    System.Object.GetHashCode()
    System.Object.GetType()
    System.Object.MemberwiseClone()
    System.Object.ReferenceEquals(System.Object, System.Object)
    Namespace: Syncfusion.Windows.Forms.Grid.Grouping
    Assembly: Syncfusion.Grid.Grouping.Windows.dll
    Syntax
    public class GridAddNewRecordSection : AddNewRecordSection, IDisposable, IDisposedEvent, IIsDisposedProperty, ITreeTableCounterSource, ITreeTableSummaryArraySource, IContainerElement, IElementTreeTableSource, IElement, IGridTableCellAppearanceSource
    Remarks

    This is the section within a group which provides the AddNewRecord that is shown above the table records and / or below the records for each group and implements logic to add new records. See the AddNewRecord class for more information.

    The AddNewRecordSection is a RecordsDetails section and thus also a container element. Normally, a RecordsDetails section has a collection of one or multiple records but with a AddNewRecordSection you have exactly one child record, the AddNewRecord.

    If AddNewRecord(s) should be displayed at end of each group, then AddNewRecordSection(s) are created when the grouping for a table is initialized. The grouping engine loops through all sorted records and categorizes them. For each new group, the virtual TableDescriptor.CreateGroup factory method is called. The TableDescriptor.CreateGroup method instantiates an AddNewRecordSection by calling the virtual TableDescriptor.CreateAddNewRecordSection factory method.

    One AddNewRecord is displayed at the top of the table below the column headers. It belongs to the AddNewRecordSection of the TopLevelGroup of a table. The TopLevelGroup is created with the virtual TableDescriptor.CreateGroup factory method. The TableDescriptor.CreateGroup method instantiates an AddNewRecordSection by calling the virtual TableDescriptor.CreateAddNewRecordSection factory method.

    Because AddNewRecordSection is a container element and not a display element, it will not be an item returned by the Table.DisplayElements and Table.GroupedElements collection. Instead, AddNewRecordSection can be accessed only through the Group.Sections collection of its parent group.

    See also:

    TableDescriptor.CreateGroup, CreateAddNewRecordSection(Group), TopLevelGroup, AddNewRecord, IContainerElement, Group.Sections

    Constructors

    GridAddNewRecordSection(Group)

    Initializes a new instance of the GridAddNewRecordSection class.

    Declaration
    public GridAddNewRecordSection(Group parent)
    Parameters
    Type Name Description
    Group parent

    The group this section is created in.

    Properties

    Appearance

    Gets or sets the default GridTableCellAppearance with GridTableCellStyleInfo information for cells of this element.

    Declaration
    public GridTableCellAppearance Appearance { get; set; }
    Property Value
    Type
    GridTableCellAppearance

    Engine

    Gets the engine this element belongs to.

    Declaration
    public GridEngine Engine { get; }
    Property Value
    Type
    GridEngine

    EngineTable

    Gets the GridTable of the engine this element belongs to.

    Declaration
    public GridTable EngineTable { get; }
    Property Value
    Type
    GridTable

    ParentChildTable

    Gets a reference to the child table this element belongs.

    Declaration
    public GridChildTable ParentChildTable { get; }
    Property Value
    Type
    GridChildTable

    ParentRecord

    Gets a reference to the parent record this element belongs to.

    Declaration
    public GridRecord ParentRecord { get; }
    Property Value
    Type
    GridRecord

    ParentTable

    Gets or sets a reference to the parent table this section belongs to.

    Declaration
    public GridTable ParentTable { get; set; }
    Property Value
    Type
    GridTable

    ParentTableDescriptor

    Gets the table descriptor this element belongs to.

    Declaration
    public GridTableDescriptor ParentTableDescriptor { get; }
    Property Value
    Type
    GridTableDescriptor

    ReadOnlyAppearance

    Gets the appearance of the element, If this element is modified; otherwise it returns a GridTableCellAppearance of the first parent element with appearance in the hierarchy.

    Declaration
    public GridTableCellAppearance ReadOnlyAppearance { get; }
    Property Value
    Type
    GridTableCellAppearance

    Methods

    Dispose(Boolean)

    Release the unmanaged resource.

    Declaration
    protected override void Dispose(bool disposing)
    Parameters
    Type Name Description
    System.Boolean disposing

    True to release both managed and unmanaged resources; false to release only unmanaged resources.

    Overrides
    RecordsDetails.Dispose(Boolean)

    GetBaseAppearance()

    Gets a GridTableCellAppearance of the first parent element with appearance in the hierarchy.

    Declaration
    public GridTableCellAppearance GetBaseAppearance()
    Returns
    Type Description
    GridTableCellAppearance

    A GridTableCellAppearance.

    ResetAppearance()

    Discards any changes for the Appearance object.

    Declaration
    public void ResetAppearance()

    ShouldSerializeAppearance()

    Determines whether Appearance has been modified and its contents should be serialized at design-time.

    Declaration
    public bool ShouldSerializeAppearance()
    Returns
    Type Description
    System.Boolean

    true if contents were changed; false otherwise.

    Explicit Interface Implementations

    IGridTableCellAppearanceSource.GetAppearance()

    Declaration
    GridTableCellAppearance IGridTableCellAppearanceSource.GetAppearance()
    Returns
    Type
    GridTableCellAppearance

    IGridTableCellAppearanceSource.RaiseAppearanceChanged(GridTableCellStyleInfoChangedEventArgs)

    Declaration
    void IGridTableCellAppearanceSource.RaiseAppearanceChanged(GridTableCellStyleInfoChangedEventArgs e)
    Parameters
    Type Name Description
    GridTableCellStyleInfoChangedEventArgs e

    IGridTableCellAppearanceSource.RaiseAppearanceChanging(GridTableCellStyleInfoChangedEventArgs)

    Declaration
    void IGridTableCellAppearanceSource.RaiseAppearanceChanging(GridTableCellStyleInfoChangedEventArgs e)
    Parameters
    Type Name Description
    GridTableCellStyleInfoChangedEventArgs e

    Implements

    System.IDisposable
    ITreeTableCounterSource
    ITreeTableSummaryArraySource
    IGridTableCellAppearanceSource
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved