New to Telerik UI for WinForms? Download free 30-day trial


This article describes the inner structure and organization of the elements which build the RadPivotGrid control.

Like all Telerik WinForms controls RadPropertyGrid is build upon Telerik Presentation Framework (TPF). TPF consists of various elements (such as primitives and layouts) that are the building blocks of the controls.

Figure 1: RadPivotGrid`s Element Hierarchy

WinForms RadPivotGrid Element Hierarchy

RadPivotGrid groups the records in the assigned data source according to column descriptors and row descriptors which are displayed in the Column descriptors area and Row descriptors area. What you see in the Column headers and Row headers areas are the group names. Each cell in the Data cells area displays the aggregated result of all records that belong to both groups defined by the row and column of the cell. The aggregate descriptors are displayed in the Aggregates area. In the Report filters area you can add fields by which you can filter the displayed results. For example, if you need to see a report of the sales only in the USA, then you can add the Country field to the Report filters area and select USA from its filter menu.

RadPivotGrid consists of several different areas and visual elements which have specific purposes and functionality. The structure of the control is described on the following picture.

Figure 2: RadPivotGrid`s Element Structure

WinForms RadPivotGrid Element Structure

  • RadPivotGridElement: Represents the main element of the control.
    • PivotHeaderVirtualizedContainer: Represents a virtualized container holding the row and column headers.
    • PivotRowDescriptorContainer: Container element of the group row descriptors.
    • PivotAggregateDescriptorContainer: Container holding the aggregate elements.
    • PivotFilterDescriptorContainer: Container element of the filters.
    • PivotColumnDescriptorContainer: Container element of the group column descriptors.
    • RadScrollbarElement: Scroll bar element.
    • PivotStackVirtualizedContainer: Virtualized container holding the pivot cells.

See Also

In this article