Skip to main content
All docs
V25.1
  • TreeListView.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.v25.1.dll

    NuGet Package: DevExpress.Wpf.Grid.Core

    Declaration

    public BestFitMode? BestFitModeOnSourceChange { get; set; }

    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.

    <dxg:GridControl Name="grid">
        <dxg:GridControl.View>
            <dxg:TreeListView Name="view" BestFitModeOnSourceChange="VisibleRows"/>
        </dxg:GridControl.View>
    </dxg:GridControl> 
    
    See Also