ScrollBarVisibility 枚举

定义

命名空间:

Microsoft.UI.Xaml.Controls

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

public enum class ScrollBarVisibility

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class ScrollBarVisibility

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum ScrollBarVisibility

Public Enum ScrollBarVisibility

<object property="enumMemberName"/>

继承

Enum

ScrollBarVisibility

属性

ContractVersionAttribute

字段

Auto	1	仅当视区无法显示所有内容时， 才会显示 ScrollBar 。 内容维度设置为 ScrollViewer 父级的相应维度。 对于水平 ScrollBar，内容宽度设置为 ScrollViewer 的 ViewportWidth。 对于垂直 ScrollBar，内容的高度设置为 ScrollViewer 的 ViewportHeight。
Disabled	0	即使视区无法显示所有内容， 滚动条 也不会显示。 滚动已禁用。 内容维度设置为 ScrollViewer 父级的相应维度。 对于水平 ScrollBar，内容宽度设置为 ScrollViewer 的 ViewportWidth。 对于垂直 ScrollBar，内容的高度设置为 ScrollViewer 的 ViewportHeight。
Hidden	2	即使视区无法显示所有内容， 滚动条 也不会显示。 滚动仍然已启用，可以通过触摸、键盘或鼠标滚轮交互进行滚动。 内容维度不受 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>