Row Field

• Apr 01, 2018
• 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.

 

 

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