ScrollViewer.HorizontalSnapPointsType Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает или задает значение, которое объявляет, как поведение манипуляции реагирует на точки привязки вдоль горизонтальной оси.

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" />

Значение свойства

SnapPointsType

Значение перечисления. Значение по умолчанию — Нет , но может быть задано с помощью шаблона элемента управления.

Примеры

Этот код XAML является шаблоном по умолчанию для элемента управления Hub . Концентратор имеет часть ScrollViewer, которая окружает ItemsStackPanel для его содержимого. Концентратор использует значение Optional для прикрепления в обоих измерениях (хотя VerticalScrollMode отключен в начальных визуальных состояниях) и отключает ZoomMode. Обратите внимание, что свойства 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 .

**Точки близости (необязательные и необязательные): ** Когда пользователь естественным образом останавливает манипуляцию в непосредственной близости от точки привязки, точки близости помогают пользователю приземлиться на естественном месте остановки. Поскольку пользователь должен приземлиться в непосредственной близости от точки привязки, чтобы заставить его остановиться на ней, иногда пользователю придется выполнить еще один прокрутку, чтобы достичь точки привязки.

**Обязательные точки привязки (Обязательные и Обязательные): ** В отличие от близкого расположения, обязательные точки привязки гарантируют, что содержимое всегда помещается в точку привязки. Даже если пользователь отпускает манипуляцию на полпути между двумя точками привязки, она всегда будет переходить к одной из точек привязки.

Чтобы самостоятельно увидеть влияние точек прикрепления на поведение ScrollViewer , получите пример прокрутки, сдвига и масштабирования XAML. Запустите пример на сенсорном устройстве (не в симуляторе). Попробуйте использовать значения SnapPointsType при просмотре примера страницы примера "Сдвиг с точками прикрепления".

Дополнительные сведения о жесте прокрутки и сдвиге см. в разделе "Поведение сдвига" статьи Рекомендации по сдвигу.

Значение по умолчанию None является значением по умолчанию перечисления . Если оно задано, это свойство часто задается как атрибут в части шаблона XAML или как метод задания стиля. Каждый элемент управления может задать этот параметр по-разному. Получение значения во время выполнения предоставит значение, полученное из примененных стилей и шаблонов.

См. также раздел

• SnapPointsType
• Пример прокрутки, сдвига и масштабирования на XAML
• Элементы управления "Средство прокрутки"
• Руководство по функции сдвига