ScrollBarVisibility 枚举

定义

指定可滚动内容的 ScrollBar 的可见性。Specifies the visibility of a ScrollBar for scrollable content.

public enum class ScrollBarVisibility
public enum ScrollBarVisibility
type ScrollBarVisibility = 
Public Enum ScrollBarVisibility
继承
ScrollBarVisibility

字段

Auto 1

当视区无法显示所有内容时,ScrollBar 会出现,并将 ScrollViewer 的维度应用于内容。A ScrollBar appears and the dimension of the ScrollViewer is applied to the content when the viewport cannot display all of the content. 对于水平 ScrollBar,内容的宽度设置为 ViewportWidthScrollViewerFor a horizontal ScrollBar, the width of the content is set to the ViewportWidth of the ScrollViewer. 对于垂直 ScrollBar,内容的高度设置为 ViewportHeightScrollViewerFor a vertical ScrollBar, the height of the content is set to the ViewportHeight of the ScrollViewer.

Disabled 0

即使当视区无法显示所有内容时,ScrollBar 也不会出现。A ScrollBar does not appear even when the viewport cannot display all of the content. 将内容的维度设置为 ScrollViewer 父级的对应维度。The dimension of the content is set to the corresponding dimension of the ScrollViewer parent. 对于水平 ScrollBar,内容的宽度设置为 ViewportWidthScrollViewerFor a horizontal ScrollBar, the width of the content is set to the ViewportWidth of the ScrollViewer. 对于垂直 ScrollBar,内容的高度设置为 ViewportHeightScrollViewerFor a vertical ScrollBar, the height of the content is set to the ViewportHeight of the ScrollViewer.

Hidden 2

即使当视区无法显示所有内容时,ScrollBar 也不会出现。A ScrollBar does not appear even when the viewport cannot display all of the content. 未将 ScrollViewer 的维度应用于内容。The dimension of the ScrollViewer is not applied to the content.

Visible 3

ScrollBar 始终出现。A ScrollBar always appears. ScrollViewer 的维度应用于内容。The dimension of the ScrollViewer is applied to the content. 对于水平 ScrollBar,内容的宽度设置为 ViewportWidthScrollViewerFor a horizontal ScrollBar, the width of the content is set to the ViewportWidth of the ScrollViewer. 对于垂直 ScrollBar,内容的高度设置为 ViewportHeightScrollViewerFor a vertical ScrollBar, the height of the content is set to the ViewportHeight of the ScrollViewer.

示例

下面的示例演示如何使用此枚举的成员值设置HorizontalScrollBarVisibility ScrollViewer控件的属性。The following example shows how to use the member values of this enumeration to set the HorizontalScrollBarVisibility property of the ScrollViewer control.


// 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属性值。Use this enumeration to set the HorizontalScrollBarVisibility and VerticalScrollBarVisibility property values of the ScrollViewer control.

此枚举的成员值指定ScrollBar给定方向的可见性。The member values of this enumeration specify ScrollBar visibility in a given direction. 这些成员值还指定是否将相应ScrollViewer的维度应用于其包含的内容。These member values also specify whether the corresponding ScrollViewer dimension is applied to its enclosed content.

ViewportWidthViewportHeight应用到ScrollViewer内容时, 将设置内容的视区大小。When you apply the ViewportWidth or ViewportHeight to ScrollViewer content, you set the viewport size for the content.

适用于

另请参阅