TcxPivotGridFieldGroup.Area Property

Specifies the area in which the group is displayed.

Declaration

property Area: TcxPivotGridFieldArea read; write;

Property Value

Type
TcxPivotGridFieldArea

Remarks

A field group like any field can be positioned in one of the available areas: column, row, header, filter, and data header areas. The Area property specifies the area in which the current group is displayed (i.e. the headers of all the visible fields within this group are displayed).

Dragging any of the grouped fields from one area to another automatically changes the group’s Area property’s value and vice versa provided that no restrictive options are set.

To determine the group’s position amongst the other fields and groups within the same area, use the group’s AreaIndex property.

Note

The position of a group within the control is determined by the Area property of the first field in the group. Assigning a value to the group’s Area property sets this field’s Area property to the same value. Modifying the Area property of the second and subsequent fields in the group is ignored. The restrictive options of the first field (which have been set via the AllowedAreas property) are applied to the group.

The Area property of an empty group (a group which doesn’t contain any fields) returns faFilter.