Specifies the visibility of a ScrollBar for scrollable content.
Assembly: PresentationFramework (in PresentationFramework.dll)
A ScrollBar appears and the dimension of the ScrollViewer is applied to the content when the viewport cannot display all of the content. For a horizontal ScrollBar, the width of the content is set to the ViewportWidth of the ScrollViewer. For a vertical ScrollBar, the height of the content is set to the ViewportHeight of the ScrollViewer.
A ScrollBar does not appear even when the viewport cannot display all of the content. The dimension of the content is set to the corresponding dimension of the ScrollViewer parent. For a horizontal ScrollBar, the width of the content is set to the ViewportWidth of the ScrollViewer. For a vertical ScrollBar, the height of the content is set to the ViewportHeight of the ScrollViewer.
The member values of this enumeration specify ScrollBar visibility in a given direction. These member values also specify whether the corresponding ScrollViewer dimension is applied to its enclosed content.
// 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();
<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>
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0