Partilhar via

ScrollBarVisibility Enumeração

  • Referência

Definição

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Especifica a visibilidade de uma ScrollBar para conteúdo rolável.

public enum class ScrollBarVisibility
public enum ScrollBarVisibility
type ScrollBarVisibility = 
Public Enum ScrollBarVisibility
Herança
Object
ValueType
Enum
ScrollBarVisibility

Campos

Auto 1

Uma ScrollBar é exibida e a dimensão do ScrollViewer é aplicada ao conteúdo quando o visor não pode exibir todo o conteúdo. Para uma ScrollBar horizontal, a largura do conteúdo é definida como a ViewportWidth do ScrollViewer. Para uma ScrollBar vertical, a altura do conteúdo é definida como a ViewportHeight do ScrollViewer.
Disabled 0

Uma ScrollBar não é exibida, mesmo quando o visor não pode exibir todo o conteúdo. A dimensão do conteúdo é definida para a dimensão correspondente do pai do ScrollViewer. Para uma ScrollBar horizontal, a largura do conteúdo é definida como a ViewportWidth do ScrollViewer. Para uma ScrollBar vertical, a altura do conteúdo é definida como a ViewportHeight do ScrollViewer.
Hidden 2

Uma ScrollBar não é exibida, mesmo quando o visor não pode exibir todo o conteúdo. A dimensão do ScrollViewer não é aplicada ao conteúdo.
Visible 3

Uma ScrollBar sempre aparece. A dimensão do ScrollViewer é aplicada ao conteúdo. Para uma ScrollBar horizontal, a largura do conteúdo é definida como a ViewportWidth do ScrollViewer. Para uma ScrollBar vertical, a altura do conteúdo é definida como a ViewportHeight do ScrollViewer.

Exemplos

O exemplo a seguir mostra como usar os valores de membro dessa enumeração para definir a HorizontalScrollBarVisibility propriedade do ScrollViewer controle.


// 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>

Comentários

Use essa enumeração para definir os HorizontalScrollBarVisibility valores e VerticalScrollBarVisibility a propriedade do ScrollViewer controle.

Os valores de membro dessa enumeração especificam ScrollBar visibilidade em uma determinada direção. Esses valores de membro também especificam se a dimensão correspondente ScrollViewer é aplicada ao seu conteúdo fechado.

Ao aplicar o ViewportWidth conteúdo ou ViewportHeight ao ScrollViewer conteúdo, defina o tamanho do visor para o conteúdo.

Aplica-se a

Confira também