ScrollViewer.VerticalSnapPointsType 属性

  • 参考

定义

命名空间:
Windows.UI.Xaml.Controls
编辑

获取或设置一个值，该值声明操作行为如何响应垂直轴上的对齐点。

public:
 property SnapPointsType VerticalSnapPointsType { SnapPointsType get(); void set(SnapPointsType value); };
SnapPointsType VerticalSnapPointsType();

void VerticalSnapPointsType(SnapPointsType value);
public SnapPointsType VerticalSnapPointsType { get; set; }
var snapPointsType = scrollViewer.verticalSnapPointsType;
scrollViewer.verticalSnapPointsType = snapPointsType;
Public Property VerticalSnapPointsType As SnapPointsType
<ScrollViewer VerticalSnapPointsType="snapPointsTypeMemberName" />

属性值

SnapPointsType

枚举的一个值。 默认值为 None ，但可以通过控件模板进行设置。

示例

此 XAML 来自 中心 控件的默认模板。 中心有一个 ScrollViewer 部件，该部件围绕其内容的 ItemsStackPanel。 尽管VerticalScrollMode 在开始视觉状态) 禁用并禁用 ZoomMode，但中心在两个维度 (使用 Optional 值作为贴靠行为。 请注意，如何在此处将 SnapPointsAlignment 属性设置为属性。

<ControlTemplate TargetType="Hub">
...
<ScrollViewer x:Name="ScrollViewer"
    Grid.RowSpan="2"
    HorizontalScrollMode="Auto"
    HorizontalScrollBarVisibility="Auto"
    VerticalScrollMode="Disabled"
    VerticalScrollBarVisibility="Disabled"
    HorizontalSnapPointsAlignment="Near"
    HorizontalSnapPointsType="Optional"
    VerticalSnapPointsAlignment="Near"
    VerticalSnapPointsType="Optional"
    ZoomMode="Disabled">
  <ItemsStackPanel x:Name="Panel" 
       Orientation="{TemplateBinding Orientation}"
       CacheLength="20" />
</ScrollViewer>
...
</ControlTemplate>

注解

对于平移操作，通常有自然的停止位置。 捕捉点提供了一种指示这些位置位置的方法。 然后，当用户轻扫时，操作结果使用 SnapPointsType 值表示的行为有利于该自然点。

**邻近点 (Optional 和 OptionalSingle) ：** 当用户要在捕捉点附近自然停止操作时，邻近点可帮助用户降落在自然停止位置。 由于用户必须降落在贴靠点附近才能使其停止，因此用户有时必须执行另一次轻扫才能到达对齐点。

**强制捕捉点 (必需 和 MandatorySingle) ：** 与邻近度相比，强制对齐点可确保将内容调整为始终位于对齐点上。 即使用户在两个对齐点之间中途释放操作，它也会始终移动到其中一个对齐点。

若要自行查看对齐点对 ScrollViewer 行为的影响，请获取 XAML 滚动、平移和缩放示例。 在触摸设备上 (而不是模拟器) 上运行示例。 查看示例的“使用对齐点平移”示例页时，请尝试 SnapPointsType 值。

若要了解有关轻扫手势和平移的详细信息，请参阅平移指南的“ 平移行为”部分。

默认值 None 是枚举的默认值。 如果已设置，则此属性通常设置为 XAML 模板部件中的属性或样式 Setter。 每个控件可能以不同的方式设置此值。 在运行时获取值将提供来自应用样式和模板的值。

适用于

另请参阅