PivotGridControl.FieldAreaChanged Event
Occurs after a field location or visibility has been changed.
Namespace: DevExpress.Xpf.PivotGrid
Assembly: DevExpress.Xpf.PivotGrid.v14.2.dll
#Declaration
#Event Data
The FieldAreaChanged event's handler receives an argument of the PivotFieldEventArgs type. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Field | Gets the field being processed. |
| Handled |
Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Inherited from Routed |
| Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
| Routed |
Gets or sets the Routed |
| Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
#Remarks
The FieldAreaChanged event occurs when a field location or visibility is changed either by an end-user, or via code.
A field can be placed within one of four areas: Filter Area, Column Area, Row Area or Data Area. By default, an end-user can drag a field between and within the areas. Dragging a field to the customization form hides this field.
To change the field location via code, use the PivotGridField.Area and PivotGridField.AreaIndex properties. The PivotGridField.Visible property controls the field visibility.
The FieldAreaChanged event only serves as a notification. To control the drag-and-drop of individual fields, and prevent specific fields from being dropped by an end-user within a particular area, handle the PivotGridControl.FieldAreaChanging event.
The following events are raised after the FieldAreaChanged event:
- the PivotGridControl.FieldAreaIndexChanged event is raised if the field location has been changed;
- the PivotGridControl.FieldVisibleChanged event is raised if the field visibility has been changed.