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>

Комментарии

Используйте это перечисление для задания значений HorizontalScrollBarVisibilityScrollViewer свойств и VerticalScrollBarVisibility элемента управления .

Значения элементов этого перечисления определяют ScrollBar видимость в заданном направлении. Эти значения элементов также указывают, применяется ли соответствующее ScrollViewer измерение к его заключенному содержимому.

При применении ViewportWidth или ViewportHeight к содержимому ScrollViewer задается размер окна просмотра для содержимого.

См. также раздел

• VerticalScrollBarVisibility
• HorizontalScrollBarVisibility
• ScrollBar
• ScrollViewer