XAML - ScrollViewer

此控件提供可滚动区域，可包含其他可见元素。ScrollViewer 类的层次继承如下 −

属性

下面给出了 ScrollViewer 类的常用属性。

Sr.No.	属性 &描述
1	ComputedHorizontalScrollBarVisibility 获取一个值，该值指示水平 ScrollBar 是否可见。
2	ComputedHorizontalScrollBarVisibilityPropertyy 标识 ComputedHorizontalScrollBarVisibility 依赖属性。
3	HorizontalScrollBarVisibility 获取或设置一个值，该值指示是否应显示水平 ScrollBar。
4	HorizontalScrollBarVisibilityProperty 标识 HorizontalScrollBarVisibility 依赖项属性。
5	HorizontalScrollMode 获取或设置一个值，该值确定操作输入如何影响水平轴上的滚动行为。
6	HorizontalScrollModeProperty 标识 HorizontalScrollMode 依赖项属性。
7	HorizontalSnapPointsAlignment 获取或设置一个值，指示现有捕捉点相对于初始视口的水平对齐方式。
8	HorizontalSnapPointsAlignmentProperty 标识 HorizontalSnapPointsAlignment 依赖项属性。
9	IsHorizontalScrollChainingEnabled 获取或设置一个值，指示是否启用从此子级到其父级的水平轴滚动链。
10	IsHorizontalScrollChainingEnabledProperty 标识IsHorizontalScrollChainingEnabled 依赖项属性。
11	IsScrollInertiaEnabled 获取或设置一个值，该值指示滚动操作是否应在其行为和值中包含惯性。
12	IsScrollInertiaEnabledProperty 标识 IsScrollInertiaEnabled 依赖项属性。
13	IsVerticalScrollChainingEnabled 获取或设置一个值，该值指示是否启用从此子级到其父级的滚动链，例如垂直轴。
14	IsVerticalScrollChainingEnabledProperty 标识 IsVerticalScrollChainingEnabled 依赖属性。
15	ScrollableHeight 获取表示可滚动区域垂直大小的值；范围宽度与视口宽度之间的差值。
16	ScrollableHeightProperty 标识 ScrollableHeight 依赖属性。
17	ScrollableWidth 获取表示可滚动区域水平大小的值；范围宽度与视口宽度之间的差异。
18	ScrollableWidthProperty 标识 ScrollableWidth 依赖项属性。
19	VerticalScrollBarVisibility 获取或设置一个值，该值指示是否应显示垂直 ScrollBar。
20	VerticalScrollBarVisibilityProperty 标识 VerticalScrollBarVisibility 依赖项属性。
21	VerticalScrollMode 获取或设置一个值，该值确定操作输入如何影响垂直轴上的滚动行为。
22	VerticalScrollModeProperty 标识 VerticalScrollMode 依赖属性。

事件

下面给出了 ScrollViewer 类的常用事件。

Sr.No.	事件 &描述
1	DirectManipulationCompleted 当 ScrollViewer 的任何直接操作完成时发生。
2	DirectManipulationStarted 当 ScrollViewer 的任何直接操作开始时发生。
3	ViewChanged 当滚动和缩放等操作导致视图发生变化时发生。
4	ViewChanging 当滚动和缩放等操作导致视图发生变化时发生。

方法

下面给出了 ScrollViewer 类的常用方法。

Sr.No.	方法和说明
1	GetHorizontalScrollBarVisibility 从指定元素获取 HorizontalScrollBarVisibility 依赖项属性 / ScrollViewer.HorizontalScrollBarVisibility XAML 附加属性的值。
2	GetHorizontalScrollMode 从指定元素获取 HorizontalScrollMode 依赖项属性 / ScrollViewer.HorizontalScrollMode XAML 附加属性的值。
3	GetIsDeferredScrollingEnabled 从指定元素获取 IsDeferredScrollingEnabled 依赖项属性 / ScrollViewer.IsDeferredScrollingInertiaEnabled XAML 附加属性的值。
4	GetIsHorizontalScrollChainingEnabled 从指定元素获取 IsHorizontalScrollChainingEnabled 依赖项属性 / ScrollViewer.IsHorizontalScrollChainingEnabled XAML 附加属性的值。
5	GetIsScrollInertiaEnabled 从指定元素获取 IsScrollInertiaEnabled 依赖项属性 / ScrollViewer.IsScrollInertiaEnabled XAML 附加属性的值。
6	GetIsVerticalScrollChainingEnabled 获取从指定元素获取 IsVerticalScrollChainingEnabled 依赖项属性 / ScrollViewer.IsVerticalScrollChainingEnabled XAML 附加属性的值。
7	GetVerticalScrollBarVisibility 从指定元素获取 VerticalScrollBarVisibility 依赖项属性 / ScrollViewer.VerticalScrollBarVisibility XAML 附加属性的值。
8	GetVerticalScrollMode 从指定元素获取 VerticalScrollMode 依赖项属性 / ScrollViewer.VerticalScrollMode XAML 附加属性的值。
9	InvalidateScrollInfo 当描述滚动区域大小和位置的属性值发生变化时调用。
10	ScrollToHorizontalOffset 将 ScrollViewer 中的内容滚动到指定的水平偏移位置。
11	ScrollToVerticalOffset 将 ScrollViewer 中的内容滚动到指定的垂直偏移位置。
12	SetHorizontalScrollBarVisibility 设置指定元素上的 HorizontalScrollMode 依赖项属性 / ScrollViewer.HorizontalScrollMode XAML 附加属性的值。
13	SetIsDeferredScrollingEnabled 设置指定元素上的 HorizontalScrollBarVisibility 依赖项属性 / ScrollViewer.HorizontalScrollBarVisibility XAML 附加属性的值。
14	SetIsDeferredScrollingEnabled 设置 IsDeferredScrollingEnabled 依赖项属性的值 /指定元素上的 ScrollViewer.IsDeferredScrollingEnabled XAML 附加属性。
15	SetIsHorizontalScrollChainingEnabled 设置指定元素上的 IsHorizontalScrollChainingEnabled 依赖项属性 / ScrollViewer.IsHorizontalScrollChainingEnabled XAML 附加属性的值。
16	SetIsScrollInertiaEnabled 设置指定元素上的 IsScrollInertiaEnabled 依赖项属性 / ScrollViewer.IsScrollInertiaEnabled XAML 附加属性的值元素。
17	SetIsVerticalScrollChainingEnabled 设置指定元素上的 IsVerticalScrollChainingEnabled 依赖属性 / ScrollViewer.IsVerticalScrollChainingEnabled XAML 附加属性的值。
18	SetVerticalScrollBarVisibility 设置指定元素上的 VerticalScrollBarVisibility 依赖属性 / ScrollViewer.VerticalScrollBarVisibility XAML 附加属性的值。
19	SetVerticalScrollMode 设置指定元素上的 VerticalScrollMode 依赖项属性 / ScrollViewer.VerticalScrollMode XAML 附加属性的值。

示例

以下示例展示了如何在 XAML 应用程序中添加 ScrollViewer。以下是 XAML 代码，其中添加了两个 TextBlocks，一个带有 ScrollViewer，并使用一些属性和事件进行了初始化。

<Window x:Class = "XAMLScrollViewer.MainWindow" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   Title = "MainWindow" Height = "550" Width = "604">
	
   <Grid>
      <StackPanel> 
         <!-- A large TextBlock. --> 
         <TextBlock Width = "300" TextWrapping = "Wrap" Margin = "0,0,0,30"
            Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit.
            Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra,
            enim sit amet mattis tincidunt, felis nisi semper lectus, vel 
            porta diam nisi in augue. Pellentesque lacus tortor, aliquam et 
            faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinardiam. 
            Suspendisse eleifend ornare libero, in luctus purus aliquet non. 
            Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices
            sem, in eleifend eros ante id neque." />
				
         <!-- The same large TextBlock, wrapped in a ScrollViewer. -->
				
         <ScrollViewer Height = "200" Width = "200"  
            HorizontalScrollBarVisibility = "Auto" 
            VerticalScrollBarVisibility = "Auto">
					
            <TextBlock Width = "300" TextWrapping = "Wrap"
               Text = " This license governs use of code marked as “sample” or
               “example” available on this web site without a license
               agreement, as provided under the section above titled “NOTICE
               SPECIFIC TO SOFTWARE AVAILABLE ON THIS WEB SITE.” 
               If you use such code (the “software”), you accept this license. 
               If you do not accept the license, do not use the software.
               Lorem ipsum dolor sit amet, consectetur adipiscing elit. 
               Sed ac mi ipsum. Phasellus vel malesuada mauris. 
               Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. 
               Pellentesque lacus tortor, aliquam et faucibus id, 
               rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. 
               Suspendisse eleifend ornare libero, in luctus purus aliquet non. 
               Sed interdum, sem vitae rutrum rhoncus, 
               felis ligula ultrices sem, in eleifend eros ante id neque." />
         </ScrollViewer>
      </StackPanel> 
   </Grid>
   
</Window>

当你编译并执行上面的代码时，它将产生以下输出−

我们建议您执行上面的示例代码并尝试一些其他属性和事件。

xaml_controls.html

XAML 教程

XAML 其他

XAML - ScrollViewer

属性

事件

方法

示例

颜色选择器

读后有收获微信请站长喝咖啡

错误报告

您的建议:

感谢您的帮助！