TableView.ShowCheckBoxSelectorColumn Property

Gets or sets whether to enable the Selector Column This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Grid.Core, DevExpress.Wpf.Grid.Core

Declaration

C#

public bool ShowCheckBoxSelectorColumn { get; set; }

VB.NET

Public Property ShowCheckBoxSelectorColumn As Boolean

Property Value

Type	Description
Boolean	true, to enable the Selector Column; otherwise, false.

Remarks

Web-style row selection works when the multiple row selection is enabled. Set the DataControlBase.SelectionMode property to MultiSelectMode.Row or MultiSelectMode.MultipleRow. The DataViewBase.NavigationStyle property must be set to GridViewNavigationStyle.Cell or GridViewNavigationStyle.Row.

Note

The Selector Column is not supported in master-detail mode.

Example

This code snippet demonstrates how to enable the Selector Column.

MainWindow.xaml

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
        x:Class="WpfApp41.MainWindow">
    <Grid>
        <dxg:GridControl Name="grid" SelectionMode="MultipleRow">
            <dxg:GridControl.Columns>
                <dxg:GridColumn FieldName="ID"/>
                <dxg:GridColumn FieldName="Name" Header="Name"/>
                <dxg:GridColumn FieldName="LastName" Header="Last Name"/>
                <dxg:GridColumn FieldName="Address" Header="Address"/>
                <dxg:GridColumn FieldName="PhoneNumber" Header="Phone Number"/>
            </dxg:GridControl.Columns>
            <dxg:GridControl.View>
                <dxg:TableView AllowFixedColumnMenu="True" ShowCheckBoxSelectorColumn="True"/>
            </dxg:GridControl.View>
        </dxg:GridControl>

    </Grid>
</Window>

MainWindow.xaml.cs

using System.Collections.ObjectModel;
using System.Windows;

namespace WpfApp41 {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();

            ObservableCollection<Customer> customers = new ObservableCollection<Customer>();
            for(int i = 1; i < 30; i++) {
                customers.Add(new Customer() { ID = i, Name = "Name" + i });
            }
            grid.ItemsSource = customers;
        }
        public class Customer {
            int id;
            string name;
            public int ID {
                get {
                    return id;
                }
                set {
                    id = value;
                }
            }

            public string Name {
                get {
                    return name;
                }
                set {
                    name = value;
                }
            }
        }
    }
}

The image below illustrates the result:

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ShowCheckBoxSelectorColumn 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

how-to-define-a-custom-filter-popup-with-custom-toolbar-buttons-and-a-filter-editor-t357159/CS/DXPivotGrid_CustomFilterPopup/MainWindow.xaml#L36

RetainSelectionOnClickOutsideCheckBoxSelector="False"
ShowCheckBoxSelectorColumn="True" CheckBoxSelectorColumnWidth="35"
ShowGroupPanel="False" AllowGrouping="False" ShowIndicator="False"