DataGrid.CanUserReorderColumns Property

Gets or sets a value that indicates whether the user can change the column display order by dragging column headers with the mouse.

Namespace:  System.Windows.Controls
Assembly:  System.Windows.Controls.Data (in System.Windows.Controls.Data.dll)

'Declaration
Public Property CanUserReorderColumns As Boolean
<sdk:DataGrid CanUserReorderColumns="bool"/>

Property Value

Type: System.Boolean
true if the user can reorder columns; otherwise, false.

Dependency property identifier field: CanUserReorderColumnsProperty

You can set this behavior for individual columns by setting the DataGridColumn.CanUserReorder property. If the DataGridColumn.CanUserReorder property and the DataGrid.CanUserReorderColumns property are both set, a value of false will take precedence over a value of true.

Columns can be frozen by setting the FrozenColumnCount property greater than 0. Frozen columns are always the leftmost columns in display order. You cannot drag frozen columns into the group of unfrozen columns or drag unfrozen columns into the group of frozen columns.

The following code example demonstrates how to set the CanUserReorderColumns property in code. This example is part of a larger example available in the Walkthrough: Customizing the DataGrid Control Using Properties topic.


Private Sub cbColReorder_Changed(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs)
    Dim cb As CheckBox = sender
    If Me.dataGrid1 IsNot Nothing Then
        Me.dataGrid1.CanUserReorderColumns = cb.IsChecked
    End If
End Sub


Silverlight

Supported in: 5, 4, 3

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show: