TableView.AutoWidth Property

Gets or sets whether column widths are automatically changed so that the total columns’ width matches the grid’s width. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public bool AutoWidth { get; set; }

VB.NET

Public Property AutoWidth As Boolean

Property Value

Type	Default	Description
Boolean	false	true, to enable the column auto width feature; otherwise, false.

Remarks

Tip

Topics:

• Columns Layout and Width
• Fixed Columns and Bands

Set the AutoWidth property to true to make the GridControl change the column widths automatically. In this case, when an end user changes a column’s width, the GridControl changes the widths of other columns.

Xaml

<dxg:GridControl AutoGenerateColumns="AddNew" 
                 EnableSmartColumnsGeneration="True" 
                 ItemsSource="{Binding Customers}">
    <dxg:GridControl.View>
        <dxg:TableView AutoWidth="True"/>
    </dxg:GridControl.View>
</dxg:GridControl> 

Use the BaseColumn.ActualWidth property to obtain the column width.

If the automatic column width calculation is disabled, a column’s width is specified by its BaseColumn.Width property. If the total columns’ width exceeds the grid’s width, a horizontal scrollbar is displayed, allowing an end user to scroll grid columns. If you want a column (or columns) to always be displayed onscreen, regardless of scrolling, specify the BaseColumn.Fixed property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AutoWidth 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-implement-crud-operations/CS/GridControlCRUDSimple/MainWindow.xaml#L21

<dxg:GridControl.View>
    <dxg:TableView x:Name="view" AutoWidth="True" ShowUpdateRowButtons="OnCellEditorOpen"
                   ValidateRow="tableView_ValidateRow" NewItemRowPosition="Top"/>

wpf-data-grid-display-icon-in-unbound-column-based-on-value-in-bound-column/CS/UnboundColumnWithIcons_CodeBehind/Window1.xaml#L22

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

wpf-data-grid-validate-data-rows/CS/ValidateRow_CodeBehind/MainWindow.xaml#L10

<dxg:GridControl.View>
    <dxg:TableView AutoWidth="True"
                   ValidateRow="OnValidateRow"

wpf-data-grid-display-group-summaries/CS/DisplayGroupSummaries_CodeBehind/MainWindow.xaml#L10

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

wpf-data-grid-display-detail-content-in-tabs/CS/WpfApplication18/MainWindow.xaml#L14

<dxg:GridControl.View>
    <dxg:TableView DetailHeaderContent="Employees" AutoWidth="True" ShowGroupPanel="False"/>
</dxg:GridControl.View>

C#

wpf-data-grid-create-master-detail-grid-in-code/CS/MasterDetailInCode/MainWindow.xaml.cs#L19

gridControl.View = new TableView();
((TableView)gridControl.View).AutoWidth = true;
((TableView)gridControl.View).ShowGroupPanel = false;

VB.NET

wpf-data-grid-create-master-detail-grid-in-code/VB/MasterDetailInCode/MainWindow.xaml.vb#L22

gridControl.View = New TableView()
CType(gridControl.View, TableView).AutoWidth = True
CType(gridControl.View, TableView).ShowGroupPanel = False