DataGrid.HorizontalScrollBarVisibility Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that indicates how the horizontal scroll bar is displayed.

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

Syntax

'Declaration
Public Property HorizontalScrollBarVisibility As ScrollBarVisibility

public ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }

<sdk:DataGrid HorizontalScrollBarVisibility="scrollBarVisibilityValue"/>

XAML Values

• scrollBarVisibilityValue
  A named constant of the ScrollBarVisibility enumeration, such as Disabled.

Property Value

Type: System.Windows.Controls.ScrollBarVisibility
One of the enumeration values that specifies the horizontal scroll bar visibility. The default is Auto.

Remarks

Dependency property identifier field: HorizontalScrollBarVisibilityProperty

Examples

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

Private Sub cbHorizontalScroll_Changed(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs)
    Dim cb As CheckBox = sender
    If Me.dataGrid1 IsNot Nothing Then
        If cb.IsChecked = True Then
            Me.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Visible
        ElseIf cb.IsChecked = False Then
            Me.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Hidden
        Else
            Me.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Auto
        End If
    End If
End Sub

private void cbHorizontalScroll_Changed(object sender, RoutedEventArgs e)
{
    CheckBox cb = sender as CheckBox;
    if (this.dataGrid1 != null)
    {
        if (cb.IsChecked == true)
            this.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Visible;
        else if (cb.IsChecked == false)
            this.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Hidden;
        else 
            this.dataGrid1.HorizontalScrollBarVisibility = ScrollBarVisibility.Auto;
    }

}

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.

See Also

Reference

DataGrid Class

System.Windows.Controls Namespace

Other Resources

DataGrid