ScrollBarVisibility 枚举

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

指定可滚动内容的 ScrollBar 的可见性。

public enum class ScrollBarVisibility

public enum ScrollBarVisibility

type ScrollBarVisibility = 

Public Enum ScrollBarVisibility

继承

Object

ValueType

Enum

ScrollBarVisibility

字段

Auto	1	当视区无法显示所有内容时，ScrollBar 会出现，并将 ScrollViewer 的维度应用于内容。 对于水平 ScrollBar，内容的宽度设置为 ViewportWidth 的 ScrollViewer。 对于垂直 ScrollBar，内容的高度设置为 ViewportHeight 的 ScrollViewer。
Disabled	0	即使当视区无法显示所有内容时，ScrollBar 也不会出现。 将内容的维度设置为 ScrollViewer 父级的对应维度。 对于水平 ScrollBar，内容的宽度设置为 ViewportWidth 的 ScrollViewer。 对于垂直 ScrollBar，内容的高度设置为 ViewportHeight 的 ScrollViewer。
Hidden	2	即使当视区无法显示所有内容时，ScrollBar 也不会出现。 未将 ScrollViewer 的维度应用于内容。
Visible	3	ScrollBar 始终出现。 将 ScrollViewer 的维度应用于内容。 对于水平 ScrollBar，内容的宽度设置为 ViewportWidth 的 ScrollViewer。 对于垂直 ScrollBar，内容的高度设置为 ViewportHeight 的 ScrollViewer。

示例

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

// Create the application's main window
mainWindow = gcnew System::Windows::Window();
mainWindow->Title = "ScrollViewer Sample";

// Define a ScrollViewer
myScrollViewer = gcnew ScrollViewer();
myScrollViewer->HorizontalScrollBarVisibility = ScrollBarVisibility::Auto;

// Add Layout control
myStackPanel = gcnew StackPanel();
myStackPanel->HorizontalAlignment = HorizontalAlignment::Left;
myStackPanel->VerticalAlignment = VerticalAlignment::Top;

TextBlock^ myTextBlock = gcnew TextBlock();
myTextBlock->TextWrapping = TextWrapping::Wrap;
myTextBlock->Margin = System::Windows::Thickness(0, 0, 0, 20);
myTextBlock->Text = "Scrolling is enabled when it is necessary. Resize the Window, making it larger and smaller.";

Rectangle^ myRectangle = gcnew Rectangle();
myRectangle->Fill = Brushes::Red;
myRectangle->Width = 500;
myRectangle->Height = 500;

// Add child elements to the parent StackPanel
myStackPanel->Children->Add(myTextBlock);
myStackPanel->Children->Add(myRectangle);

// Add the StackPanel as the lone Child of the Border
myScrollViewer->Content = myStackPanel;

// Add the Border as the Content of the Parent Window Object
mainWindow->Content = myScrollViewer;
mainWindow->Show();

// Create the application's main window
mainWindow = new Window ();
mainWindow.Title = "ScrollViewer Sample";

// Define a ScrollViewer
myScrollViewer = new ScrollViewer();
myScrollViewer.HorizontalScrollBarVisibility = ScrollBarVisibility.Auto;

// Add Layout control
myStackPanel = new StackPanel();
myStackPanel.HorizontalAlignment = HorizontalAlignment.Left;
myStackPanel.VerticalAlignment = VerticalAlignment.Top;

TextBlock myTextBlock = new TextBlock();
myTextBlock.TextWrapping = TextWrapping.Wrap;
myTextBlock.Margin = new Thickness(0, 0, 0, 20);
myTextBlock.Text = "Scrolling is enabled when it is necessary. Resize the Window, making it larger and smaller.";

Rectangle myRectangle = new Rectangle();
myRectangle.Fill = Brushes.Red;
myRectangle.Width = 500;
myRectangle.Height = 500;

// Add child elements to the parent StackPanel
myStackPanel.Children.Add(myTextBlock);
myStackPanel.Children.Add(myRectangle);
            
// Add the StackPanel as the lone Child of the Border
myScrollViewer.Content = myStackPanel;

// Add the Border as the Content of the Parent Window Object
mainWindow.Content = myScrollViewer;
mainWindow.Show ();

'Define a ScrollViewer.
Dim myScrollViewer As New ScrollViewer
myScrollViewer.HorizontalScrollBarVisibility = ScrollBarVisibility.Auto

'Add Layout control.
Dim myStackPanel As New StackPanel
myStackPanel.HorizontalAlignment = System.Windows.HorizontalAlignment.Left
myStackPanel.VerticalAlignment = System.Windows.VerticalAlignment.Top

Dim myTextBlock As New TextBlock
myTextBlock.TextWrapping = TextWrapping.Wrap
myTextBlock.Margin = New Thickness(0, 0, 0, 20)
myTextBlock.Text = "Scrolling is enabled when it is necessary. Resize the Window, making it larger and smaller."

Dim myRectangle As New Rectangle
myRectangle.Fill = Brushes.Red
myRectangle.Width = 500
myRectangle.Height = 500

'Add child elements to the parent StackPanel.
myStackPanel.Children.Add(myTextBlock)
myStackPanel.Children.Add(myRectangle)

'Add the StackPanel as the lone Child of the Border
myScrollViewer.Content = myStackPanel
Me.Content = myScrollViewer

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      WindowTitle="ScrollViewer Sample">
  <ScrollViewer HorizontalScrollBarVisibility="Auto">
    <StackPanel VerticalAlignment="Top" HorizontalAlignment="Left">
      <TextBlock TextWrapping="Wrap" Margin="0,0,0,20">Scrolling is enabled when it is necessary. 
      Resize the window, making it larger and smaller.</TextBlock>
      <Rectangle Fill="Red" Width="500" Height="500"></Rectangle>
    </StackPanel>
  </ScrollViewer>
</Page>

注解

使用此枚举可设置 HorizontalScrollBarVisibility 控件的 ScrollViewer 和 VerticalScrollBarVisibility 属性值。

此枚举的成员值指定 ScrollBar 给定方向的可见性。 这些成员值还指定是否将相应的 ScrollViewer 维度应用于其封闭内容。

将 或 ViewportHeight 应用于ViewportWidthScrollViewer内容时，可以设置内容的视区大小。

另请参阅

• VerticalScrollBarVisibility
• HorizontalScrollBarVisibility
• ScrollBar
• ScrollViewer