DataGrid.CanUserReorderColumns Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
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)
Syntax
'Declaration
Public Property CanUserReorderColumns As Boolean
public bool CanUserReorderColumns { get; set; }
<sdk:DataGrid CanUserReorderColumns="bool"/>
Property Value
Type: System.Boolean
true if the user can reorder columns; otherwise, false.
Remarks
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.
Examples
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
private void cbColReorder_Changed(object sender, RoutedEventArgs e)
{
CheckBox cb = sender as CheckBox;
if (this.dataGrid1 != null)
this.dataGrid1.CanUserReorderColumns = (bool)cb.IsChecked;
}
Version Information
Silverlight
Supported in: 5, 4, 3
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.