ScrollViewer—WPF滚动条控件

ScrollViewer—WPF滚动条控件

参考地址：ScrollViewer 概述 - WPF .NET Framework | Microsoft Learn

1.ScrollViewer定义与功能

• ScrollViewer是WPF应用程序的一个容器控件，用于在可以滚动的区域中显示其他可见元素。
• ScrollViewer封装； 水平和垂直ScrollBar元素以及一个内容容器，响应鼠标命令和键盘命令。
• 应用场景
  • 长文本
  • 大量数据的显示
  • 图片浏览等

2.ScrollViewer使用

<ScrollViewer Name="scrollViewer" HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto">
	<StackPanel VerticalAlignment="Top" HorizontalAlignment="Center">
		<TextBlock TextWrapping="Wrap" Margin="0,0,0,20"
				   Text="这是一段很长的文本内容，用于演示TextBlock的文本换行和ScrollViewer的垂直滚动。当文本内容过多时，它将向下滚动以显示所有内容。同时，下方的矩形将保持固定，并在需要时触发水平滚动。">
		</TextBlock>
		<Rectangle Fill="AliceBlue" Width="500" Height="500"></Rectangle>
	</StackPanel>
</ScrollViewer>

运行结果：

3.ScrollViewer常用属性

属性	解释	属性值
VerticalScrollBarVisibility	设置垂直滚动条可见属性	Auto：内容超出时显示 Visible：显示 Hidden：隐藏，用光标仍可以滚动内容 Disable：隐藏，用光标不可以滚动内容
HorizontalScrollBarVisibility	设置水平滚动条可见属性	与VerticalScrollBarVisibility属性的用法相同
IsEnabled	设置ScrollViewer控件是否使用滚动条	默认：True

4.滚动类型

• 物理滚动
  用于按预设的物理增量滚动内容。这是大多数Panel元素的默认滚动行为。
• 滚动逻辑
  用于滚动到逻辑树的下一项。

5.用Button来控制ScrollViewer的滚动

<StackPanel VerticalAlignment="Top" HorizontalAlignment="Center">
    <Button Name="btnPageUp" Width="80" Height="20" Margin="0,0,0,5" Content="向上翻页" Click="btnPageUp_Click"/>
    <Button Name="btnPageDown" Width="80" Height="20" Margin="0,0,0,5" Content="向下翻页" Click="btnPageDown_Click"/>
    <Button Name="btnLineUp" Width="80" Height="20" Margin="0,0,0,5" Content="向上滚动" Click="btnLineUp_Click"/>
    <Button Name="btnLineDown" Width="80" Height="20" Margin="0,0,0,5" Content="向下滚动" Click="btnLineDown_Click"/>
    <Button Name="btnScrollToTop" Width="80" Height="20" Margin="0,0,0,5" Content="滚到顶部" Click="btnScrollToTop_Click"/>
    <Button Name="btnScrollToEnd" Width="80" Height="20" Margin="0,0,0,5" Content="滚到底部" Click="btnScrollToEnd_Click"/>
</StackPanel>

private void btnPageUp_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.PageUp();  //向上翻页
}

private void btnPageDown_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.PageDown();   //向下翻页
}

private void btnLineUp_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.LineUp();  //向上滚动
}

private void btnLineDown_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.LineDown();  //向下滚动
}

private void btnScrollToTop_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.ScrollToTop();  //滚到顶部
}

private void btnScrollToEnd_Click(object sender, RoutedEventArgs e)
{
	scrollViewer.ScrollToEnd();  //滚到底部
}