ScrollViewer.HorizontalSnapPointsType 属性

定义

获取或设置一个值,该值声明操作行为如何响应沿水平轴的对齐点。

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

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

属性值

枚举的一个值。 默认值为 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 值表示的行为有利于该自然点。

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

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

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

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

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

适用于

另请参阅