Paradigm Support Desk

Report Designer Pivot Grid Control

The Pivot Grid control represents dynamic data (obtained from an underlying data source) in a cross-tabulated form to create cross-tab reports, similar to Pivot Tables in Microsoft Excel®. Column headers display unique values from one data field, and row headers - from another field. Each cell displays a summary for the corresponding row and column values. By specifying different data fields, you can see different totals. This allows you to get a compact layout for a complex data analysis.

The Pivot Grid has a designer which allows you to easily adjust its layout. It can be invoked using the control's Smart Tag.

In the Property Grid, the Pivot Grid's properties are divided into the following groups:

1. Appearance

  • Appearance
    Allows you to define the appearance properties (such as Background Colour, Foreground Colour, Font, etc.) for the Pivot Grid's elements (Cell, Field Value, Filter Separator, Header Group Line, etc.).
  • Formatting Rules
    Invokes the Formatting Rules Editor allowing you to choose which rules should be applied to the control during report generation, and define the precedence of the applied rules.
  • Styles
    Allows you to invoke the Styles Editor, which is intended to manage and customize the control's styles, which then can be assigned to the Pivot Grid's elements.

2. Behavior

  • Anchor Vertically 
    Specifies the vertical anchoring style of the Pivot Grid, so that after page rendering it stays attached to the top control, bottom control, or both.
  • Keep Together
    Specifies whether the contents of the control can be horizontally split across pages. In other words, if the control occupies more space than remains on the page, this property specifies whether this Pivot Grid should be split between the current page and the next, or whether it will be printed entirely on the next page. This property is in effect only when a Pivot Grid's content does not fit on the current page. If it does not fit on the next page, then the Pivot Grid will be split despite this property's value.
  • Scripts 
    This property contains events, which you can handle by the required scripts.
  • Visible 
    Specifies whether the control should be visible in print preview.

3. Data

  • Data Adapter 
    Determines a data adapter that will populate a Pivot Grid's data source which is assigned via the Data Source property. It is automatically set to the appropriate value, when the Data Member property is defined.
  • Data Source 
    Determines a Pivot Grid's data source.
  • Fields
    Invokes the Pivot Grid Field Collection Editor, allowing you to manage and fully customize a Pivot Grid's fields.
  • OLAP Connection String
    Specifies a connection string to a cube in an Microsoft Analysis Services database. A sample connection string is shown below:


OLAPConnectionString="Provider=msolap;Data Source=localhost;Initial Catalog=Adventure Works DW;Cube Name=Adventure Works;Query Timeout=100;" 

A connection string can be built via the Connection String Editor. To invoke it, click the ellipsis button for the OLAP Connection String property.

To represent information from the bound cube, create specific Pivot Grid fields, and bind them to the required fields in the data source. If the OLAP Connection String property is set to a valid string, the value of the Data Source property is cleared. Setting the Data Source property to a valid object clears the OLAP Connection String property.

  • Prefilter
    When this property is expanded in the Property Grid, you can set its Enabled property to Yes, and use the Criteria property to invoke the Pivot Grid Prefilter dialog. This dialog allows you to build complex filter criteria with an unlimited number of filter conditions, combined by logical operators. It provides a set of logical operators that significantly simplify the process of creating filters for text, numeric and date-time fields.

4. Design

  • Name
    Determines a control's name, by which it can be accessed in the Report Explorer, Property Grid or via scripts.

6. Layout

  • Location 
    Specifies the control's location, in report measurement units.
  • Size 
    Specifies the control's size, in report measurement units.
  • Snap Line Margin 
    Specifies the margin (in report measurement units), which is to be preserved around the control when it is aligned using Snap Lines, or when other controls are aligned next to it.

7. Navigation

  • Bookmark and Parent Bookmark 
    These properties are intended for the creation of a hierarchical structure within a report called a document map.

7. Options

  • Data Field Options
    Allows you to customize the options which control the presentation of the data fields.
  • Data Options
    Allows you to define whether a Pivot Grid's fields must be case sensitive or not.
  • Options Chart Data Source
    Provides access to the options controlling the display of the Pivot Grid's data in a Chart.
  • Print Options
    Allows you to customize the print options of a Pivot Grid.
  • View Options
    Allows you to customize the Pivot Grid's display options.

Paradigm is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.