Row Field

  • 2 minutes to read

Row fields represent data source fields that are located in a Pivot Grid Control's row header area. A PivotGridControl that has more than one row field will have an inner row field ('Category Name' in the image below). This field is the one located closest to the Data Area. Any other row fields are outer row fields. Values of the outermost row field ('Order Quarter' in the image below) are displayed only once, while values in the rest of the row field can be repeated.

Fields consist of the following elements:

  • a field header, which displays the field caption and enables end-users to sort and filter field values, change the field's location via drag-and-drop, etc.;
  • field values.

 

veRowField

 

The table below lists the main properties that affect the field's functionality:

Field Name

PivotGridFieldBase.FieldName

Bound Type

PivotGridFieldBase.UnboundType

Position

PivotGridFieldBase.Area, PivotGridFieldBase.AreaIndex

For row fields, the PivotGridFieldBase.Area property is set to PivotArea.RowArea.

Visibility

PivotGridFieldBase.Visible

Row Fields Layout

PivotGridFieldBase.Width

PivotGridFieldBase.MinWidth

The PivotGridControl.FieldWidthChanged event provides a notification that the field width has been changed.

The PivotGridOptionsViewBase.RowTreeOffset and PivotGridOptionsViewBase.RowTreeWidth properties are in effect when the PivotGridOptionsViewBase.RowTotalsLocation property is set to PivotRowTotalsLocation.Tree.

Grouping Field Values

PivotGridFieldBase.GroupInterval

Linking with Other Fields

PivotGridControl.Groups

Sort Order

PivotGridFieldBase.SortOrder, PivotGridFieldBase.SortBySummaryInfo

Filter Criteria

PivotGridFieldBase.FilterValues

Totals

PivotGridFieldBase.TotalsVisibility, PivotGridField.CustomTotals

See Also