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

열거형 값입니다. 기본값은 None 이지만 컨트롤 템플릿을 통해 설정할 수 있습니다.

예제

이 XAML은 허브 컨트롤의 기본 템플릿에서 가져옵니다. 허브에는 콘텐츠에 대한 ItemsStackPanel을 둘러싸는 ScrollViewer 부분이 있습니다. 허브 는 두 차원의 맞춤 동작에 선택적 값을 사용하고(Visual States를 시작할 때 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 템플릿 파트의 특성 또는 스타일 Setter로 설정되는 경우가 많습니다. 각 컨트롤은 잠재적으로 이를 다르게 설정합니다. 런타임에 값을 가져오면 적용된 스타일 및 템플릿에서 얻은 값이 표시됩니다.

추가 정보

• SnapPointsType
• XAML 스크롤, 이동 및 확대/축소 샘플
• 스크롤 뷰어 컨트롤
• 이동에 대한 지침