ScrollBarVisibility 枚举

定义

命名空间:

Windows.UI.Xaml.Controls

定义指定 ScrollViewer 控件中滚动条的可见性的常量。

public enum class ScrollBarVisibility

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class ScrollBarVisibility

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum ScrollBarVisibility

Public Enum ScrollBarVisibility

<object property="enumMemberName"/>

继承

Enum

ScrollBarVisibility

属性

ContractVersionAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

字段

Auto	1	仅当视区无法显示所有内容时， 才显示 ScrollBar 。 内容维度设置为 ScrollViewer 父级的相应维度。 对于水平 ScrollBar，内容宽度设置为 ScrollViewer 的 ViewportWidth。 对于垂直 ScrollBar，内容的高度设置为 ScrollViewer 的 ViewportHeight。
Disabled	0	即使视区无法显示所有内容， 也不会显示 ScrollBar 。 滚动已禁用。 内容维度设置为 ScrollViewer 父级的相应维度。 对于水平 ScrollBar，内容宽度设置为 ScrollViewer 的 ViewportWidth。 对于垂直 ScrollBar，内容的高度设置为 ScrollViewer 的 ViewportHeight。
Hidden	2	即使视区无法显示所有内容， 也不会显示 ScrollBar 。 滚动功能仍处于启用状态，并且可以通过触摸、键盘或鼠标滚轮交互进行滚动。 内容维度不受 ScrollViewer 维度的影响。
Visible	3	始终显示 ScrollBar 。 内容维度设置为 ScrollViewer 父级的相应维度。 对于水平 ScrollBar，内容宽度设置为 ScrollViewer 的 ViewportWidth。 对于垂直 ScrollBar，内容的高度设置为 ScrollViewer 的 ViewportHeight。

示例

以下示例演示如何使用 ScrollBarVisibility 枚举成员设置 ScrollViewer 控件的 HorizontalScrollBarVisibility 属性。

<StackPanel Height="400" Width="300">
    <ScrollViewer HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Disabled">
        <Grid VerticalAlignment="Top" HorizontalAlignment="Left">
            <Rectangle Fill="Green" Width="450" Height="200"></Rectangle>
            <TextBlock Margin="10,10,10,10">
                Auto. The horizontal scroll bar is shown if the content is wider than the viewport.
            </TextBlock>
        </Grid>
    </ScrollViewer>
    <ScrollViewer HorizontalScrollBarVisibility="Hidden">
        <Grid>
            <Rectangle Fill="Blue" Width="450" Height="200" />
            <TextBlock Margin="10,10,10,10">
                Hidden. The horizontal scroll bar is hidden even if the content is wider than the viewport.
            </TextBlock>
        </Grid>
    </ScrollViewer>
</StackPanel>