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	即使檢視區無法顯示所有內容， 也不會出現 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>