ScrollView.VerticalScrollRailMode Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gets or sets a value that indicates whether the scroll rail is enabled for the vertical axis.

public:
 property ScrollingRailMode VerticalScrollRailMode { ScrollingRailMode get(); void set(ScrollingRailMode value); };

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")]
/// [get: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")]
/// [set: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")]
ScrollingRailMode VerticalScrollRailMode();

void VerticalScrollRailMode(ScrollingRailMode value);

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")]
public ScrollingRailMode VerticalScrollRailMode { [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")] get; [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="ScrollView::s_defaultVerticalScrollRailMode")] set; }

var scrollingRailMode = scrollView.verticalScrollRailMode;
scrollView.verticalScrollRailMode = scrollingRailMode;

Public Property VerticalScrollRailMode As ScrollingRailMode

Property Value

ScrollingRailMode

A value that indicates whether the scroll rail is enabled for the vertical axis. The default is Enabled.

Attributes

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValueAttribute

Remarks

When content is scrolled without manipulating the scrollbar directly, for example, by touch, we call it panning. Because content can be both wider and taller than the display area, two-dimensional panning (horizontal and vertical) is often necessary. Rails improve the user experience in these cases by locking the panning to the axis of motion, either vertical or horizontal, as if the content were on a rail.

The following diagram demonstrates the concept of rails.

For more info, see Guidelines for panning.