TableView.CustomBestFit Event

Enables you to manually calculate the optimal width for a column(s).

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v14.2.dll

Declaration

C#

public event CustomBestFitEventHandler CustomBestFit

VB.NET

Public Event CustomBestFit As CustomBestFitEventHandler

Event Data

The CustomBestFit event's handler receives an argument of the CustomBestFitEventArgs type. The following properties provide information specific to this event:

Property	Description
BestFitMode	Gets or sets how the optimal width required for a column to completely display its contents is calculated. This is a dependency property.
BestFitRows	Rows that should be taken into account when calculating the optimal width of CustomBestFitEventArgs.Column.
Column	Provides access to a grid column whose width should be adjusted.
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 RoutedEventArgs.
OriginalSource	Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEvent	Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
Source	Gets the View that raised the event.

Remarks

The CustomBestFit event is raised before the Best Fit feature is applied to a column, allowing you to manually calculate the optimal width for a column. When handling this event, you can do the following:

• Change the Best Fit Mode

  The CustomBestFit event is fired if the ColumnBase.BestFitMode property is set to BestFitMode.Smart. By default, the column's optimal width is calculated as BestFitMode.AllRows if the total number of cells is less than 3,000, and as BestFitMode.DistinctValues if the total number of cells is greater than or equal to 3,000. Use the event parameter's CustomBestFitEventArgsBase.BestFitMode property to select the required mode.

• Manually Specify Rows

  Populate the CustomBestFitEventArgsBase.BestFitRows collection with rows that should be taken into account when calculating the optimal width of CustomBestFitEventArgs.Column.

To learn more, see Best Fit in Columns Layout and Width.