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	捲軸一律會出現。 內容的維度會設定為 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>