PivotGridControl.CustomColumnWidth Event

Enables the column width to be customized.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.XtraPivotGrid.v20.1.dll

Declaration

public event EventHandler<PivotCustomColumnWidthEventArgs> CustomColumnWidth
Public Event CustomColumnWidth As EventHandler(Of PivotCustomColumnWidthEventArgs)

Event Data

The CustomColumnWidth event's data class is PivotCustomColumnWidthEventArgs. The following properties provide information specific to this event:

Property Description
ColumnCount Gets the number of PivotGridControl columns in the data area.
ColumnIndex Gets the column zero-based index for fields located in the data area.
ColumnLineCount Gets the height of the column field values located in the column header area, in text lines.
ColumnWidth Gets or sets a width for the data area columns.
CustomTotal Gets the custom total that corresponds to the currently processed column/row header. Inherited from PivotFieldValueEventArgsBase<T>.
Data For internal use. Inherited from PivotFieldValueEventArgsBase<T>.
DataField Gets the data field that specifies the processed value. Inherited from PivotFieldValueEventArgsBase<T>.
Field Gets the field being processed. Inherited from PivotFieldEventArgsBase<T>.
FieldIndex Gets the field position among the visible fields within the header area. Inherited from PivotFieldValueEventArgsBase<T>.
IsCollapsed Gets whether the processed field value is collapsed. Inherited from PivotFieldValueEventArgsBase<T>.
IsColumn Gets whether the field is displayed within the Column Header Area. Inherited from PivotFieldValueEventArgsBase<T>.
IsOthersValue Gets or sets whether the current header corresponds to the "Others" row/column. Inherited from PivotFieldValueEventArgsBase<T>.
Item For internal use. Inherited from PivotFieldValueEventArgsBase<T>.
MaxIndex Gets the maximum row index (for row fields) or column index (for column fields) that corresponds to the processed field value. Inherited from PivotFieldValueEventArgsBase<T>.
MinIndex Gets the minimum row index (for row fields) or column index (for column fields) that corresponds to the processed field value. Inherited from PivotFieldValueEventArgsBase<T>.
RowCount Gets a number of PivotGridControl rows in the data area.
Value Gets the column field or row field value that corresponds to the currently processed column/row header. Inherited from PivotFieldValueEventArgsBase<T>.
ValueType Gets the type of the currently processed header of a column or a row. Inherited from PivotFieldValueEventArgsBase<T>.

Remarks

The CustomColumnWidth event allows you to customize the column width of the Pivot Grid control. To do this, use the PivotCustomColumnWidthEventArgs.ColumnWidth property. To get the index of a specified column cell, use the PivotCustomColumnWidthEventArgs.ColumnIndex property. Use the PivotCustomColumnWidthEventArgs.RowCount property to get the number of Pivot Grid Control rows in the column.

IMPORTANT

Do not change cell values, modify the control's layout, or change the control's object model in the events used for custom control painting. Actions that update the layout can cause the control to malfunction.

To specify the row height, use the PivotGridControl.CustomRowHeight event.

See Also