TableView.BestFitModeOnSourceChange Property

Gets or sets how to calculate the optimal width required for all columns to completely display their contents when the grid’s ItemsSource is changed. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public BestFitMode? BestFitModeOnSourceChange { get; set; }

VB.NET

Public Property BestFitModeOnSourceChange As BestFitMode?

Property Value

Type	Default	Description
Nullable<BestFitMode>	null	A mode that specifies how to calculate the optimal width.

Available values:

Name	Description
Default	If this mode is assigned to the ColumnBase.BestFitMode of a grid column, this means that it obtains its value from the TableView.BestFitMode property of the owner view.
AllRows	The column width is calculated based on text of all cells within this column.
VisibleRows	The column width is calculated based on the values in the currently visible cells.
DistinctValues	The column width is calculated based on all distinct values in the underlying datasource.
Smart	In this mode, the column width is calculated as BestFitMode.AllRows if the total count of rows is less than 3,000, and as BestFitMode.DistinctValues if the total count of rows is greater than or equal to 3,000. Also, if the Smart mode is enabled, the TableView.CustomBestFit is raised, thus allowing you to manually calculate the column width.

Remarks

If the BestFitModeOnSourceChange property is set to null, the GridControl does not calculate the optimal width when the source is changed.

Xaml

<dxg:GridControl Name="grid">
    <dxg:GridControl.View>
        <dxg:TableView Name="view" BestFitModeOnSourceChange="VisibleRows"/>
    </dxg:GridControl.View>
</dxg:GridControl> 

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BestFitModeOnSourceChange property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-data-grid-getting-started-net-framework/CS/WPFDataGridGettingStartedNETFramework/MainWindow.xaml#L42

<dxg:TableView AutoWidth="True"
               BestFitModeOnSourceChange="VisibleRows"
               ShowFixedTotalSummary="True"

wpf-lookupedit-filter-by-multiple-columns/CS/MainWindow.xaml#L24

<dxg:GridControl.View>
    <dxg:TableView AutoWidth="True" BestFitModeOnSourceChange="AllRows"/>
</dxg:GridControl.View>

wpf-data-grid-apply-data-annotations/CS/Apply Data Annotations/MainWindow.xaml#L19

<dxg:GridControl.View>
    <dxg:TableView AutoWidth="True" BestFitModeOnSourceChange="AllRows"/>
</dxg:GridControl.View>