이것은 새로운 기능 또는 API 제안을 위한 템플릿입니다. 예를 들어 이를 사용하여 기존 유형에 대한 새 API를 제안하거나 새 UI 컨트롤에 대한 아이디어를 제안할 수 있습니다. 모든 세부 사항이 없어도 괜찮습니다. 요약 및 근거부터 시작할 수 있습니다. 이 링크는 WinUI 기능/API 제안 프로세스를 설명합니다. https://github.com/Microsoft/microsoft-ui-xaml-specs/blob/master/docs/feature_proposal_process.md 기능 또는 API 제안에 대한 제목을 추가합니다. 짧고 구체적으로 기술해 주십시오.

제안: 스크롤 뷰어

요약

tl:dr; Win10의 하위 릴리스를 대상으로 할 때 여전히 활용할 수 있는 유연하면서도 사용하기 쉬운 스크롤 및 확대/축소 컨트롤을 XAML에서 제공합니다.

ScrollViewer 컨트롤은 애플리케이션과 컨트롤(플랫폼 및 비플랫폼 모두)에 대한 기본적인 스크롤 방식 때문에 모든 UI에서 중요한 역할을 합니다. 컨트롤은 기본 정책 및 UX(예: 의식 스크롤 막대, 포커스/키보드 상호 작용, 접근성, 기본 스크롤 애니메이션 등)와 함께 이동 및 확대/축소 기능을 제공합니다. 또한 일상적인 앱 시나리오를 쉽게 만드는 것에서 스크롤 기반 컨트롤의 핵심 구성 요소가 되고 매우 고급 사용 사례를 서비스할 수 있을 만큼 충분히 유연해야 합니다. 현재 제어는 이러한 수준의 유연성을 제공하지 않습니다.

이론적 해석

핵심 플랫폼의 공개 API 위에 계층화된 방식으로 ScrollViewer 컨트롤을 리포지토리로 가져오는 것은 다음과 같은 중요한 디딤돌입니다.

1. 리포지토리로 더 많은 제어 권한을 부여할 수 있습니다(민첩성 증가).
2. 상위 수준 프레임워크 서비스(예: 접근성)의 이점과 결합된 하위 수준 플랫폼 기능의 유연성을 표시하는 사용하기 쉬운 제어 기능을 개발자에게 제공합니다.
3. 이전 버전의 Win10에서 XAML의 최신 스크롤 관련 기능을 켤 수 있습니다.

기존 컨트롤은 1) UWP 내에서 직접 사용할 수 없고, 2) 개발자가 고유한 스크롤 경험을 생성할 것으로 기대하는 사용자 지정 수준을 허용하지 않으며, 3) 대체되는 DirectManipulation API 를 기반으로 Win8에서 작성되었습니다. UWP의 최신 InteractionTracker API로

기존 ScrollViewer 컨트롤을 있는 그대로 추출하는 것은 시작이 아닙니다. 대신 컨트롤은 InteractionTracker 의 최신(및 이미 사용 가능한) 기능을 기반으로 거의 동일한 API 표면을 사용하여 다시 구현해야 합니다.

상위 계획

_Windows_.UI.Xaml.Controls 네임스페이스의 기존 ScrollViewer는 변경되지 않은 상태로 유지됩니다(중요한 버그 수정 제외).

새 ScrollViewer는 _Microsoft_.UI.Xaml.Controls 네임스페이스에 있습니다. API는 대부분 _Windows_ 버전과 동일합니다. 분명한 이점이 있는 경우(공통 시나리오 단순화, 새로운 기능 도입 등) 컨트롤의 API를 대상으로 조정합니다.

새로운 ScrollViewer와 함께 Microsoft.UI.Xaml.Controls._Primitives_ 네임스페이스에 있는 새로운 유형인 Scroller를 소개합니다. Scroller는 InteractionTracker 의 기능을 기반으로 XAML에서 스크롤 및 확대/축소를 위한 핵심 기능을 제공합니다.

두 컨트롤의 초기 목표는 다음 공식 릴리스의 일부로 품질을 제공하기 위한 핵심 기능을 얻는 것입니다. 완료되지 않은 API는 '미리보기'로 유지되며 시험판 ​​패키지의 일부로만 사용할 수 있습니다.

-------------------- 아래 섹션은 아이디어나 제안서를 제출할 때 선택 사항입니다. PR을 마스터하기 전에 모든 섹션이 필요하지만 토론을 시작하는 데는 필요하지 않습니다. ----------------------

기능 요구 사항

| # | 기능 | | 우선순위 |
|:-:|:--|-|:-:|
| 1 | 기존 ScrollViewer와 일치하는 기본 UX로 _비밀봉_, 이동 및 확대/축소 제어를 제공합니다. || 필수 |
| 2 | 공개된 플랫폼 지원 API에만 의존하여 플랫폼 기능을 보여줍니다. || 필수 |
| 3 | 프레임워크 수준 XAML 서비스와 통합됩니다.
예를 들어:
- 시스템 포커스를 올바르게 렌더링합니다.
- 초점이 맞춰진 요소를 자동으로 보기(키보드, 게임패드, 스크린 리더)
- 효과적인 뷰포트 변경에 참여
- 스크롤 고정 지원 || 필수|
| 4 | 입력 기반 애니메이션을 수행할 수 있음 || 필수 |
| 5 | 이미 리포지토리에 있는 기존 스크롤 종속 컨트롤(예: ParallaxView, RefreshContainer, SwipeControl)과 함께 사용할 수 있습니다. || 필수 |
| 6 | 관성 보기 변경(예: 사용자 지정 애니메이션 스크롤 또는 확대/축소)에 대한 곡선을 제어할 수 있습니다. || 필수 |
| 7 | 절대 또는 상대 오프셋을 기반으로 보기를 변경할 수 있습니다(예: 관심 지점으로 스크롤) || 필수 |
| 8 | 임펄스/추가 속도를 기반으로 보기 변경 가능(예: 드래그 앤 드롭 또는 마우스 선택 직사각형을 통한 다중 선택 중 자동 부드러운 스크롤) || 필수 |
| 9 | 오버팬과 그 정도를 감지할 수 있음 || 필수 |
| 10 | 스크롤 상태의 변화를 관찰하고 대응할 수 있음 || 필수 |
| 11 | 스냅 포인트 스크롤 및 확대/축소 지원. || 해야 |
| 12 | 사용자 지정 "스크롤 막대" 컨트롤을 사용하여 스크롤을 구동할 수 있습니다(예: 사진 타임라인 스크러버). || 해야 |
| 13 | 특정 입력 유형을 무시하도록 컨트롤을 쉽게 구성할 수 있습니다(예: 터치 또는 펜에 응답하지만 마우스 휠 입력은 무시). || 해야 |
| 14 | 스크롤 위치를 저장하고 복원할 수 있습니다(예: 가상화 목록에서) || 해야 |
| 15 | 고정 헤더/요소를 지원합니다. || 해야 |
| 16 | 사용자가 빠르게 연속적으로 반복되는 제스처를 할 때 가속 스크롤을 지원합니다 . || 해야 |
| 17 | 마우스 가운데 클릭 및 스크롤 을 지원하는 기본 UX를 제공합니다. | | 해야 |
| 18 | 마우스를 통해 클릭 및 이동하는 모드를 지원합니다(예: PDF 뷰어 내에서 콘텐츠 이동). | | 해야 |
| 19 | 사용자 정의 컨트롤을 사용하여 확대/축소를 구동할 수 있습니다(예: 확대/축소 슬라이더). || 해야 |
| 20 | 스크롤 가능 영역에 포함된 콘텐츠를 인쇄할 수 있습니다. || 해야 |
| 21 | 회전 제스처를 지원합니다. || 수 |
| 22 | 깜박임 및 버벅거림 없는 스크롤로 둘 이상의 영역을 동기화할 수 있습니다(예: 텍스트 차이 시나리오). || 수 |
| 23 | 입력 기반 보기 변경에 대한 애니메이션 곡선을 사용자 정의할 수 있습니다(예: 중력 우물과 같은 손가락 아래로 동작 정의). || 수 |
| 24 | 위로 스크롤 또는 아래로 스크롤을 지원합니다 . || 수 |
| 25 | 오버패닝을 비활성화할 수 있습니다. || 수 |
| 26 | UIElement의 ManipulationMode 속성을 기반으로 ScrollViewer 내에서 콘텐츠를 선택적으로 조작할 수 있습니다 . || 수 |
| 27 | 관성 및/또는 관성에서 튀는 기능을 끌 수 있습니다. || 수|
| 28 | 콘텐츠 자르기를 비활성화할 수 있습니다(예: CanContentRenderOutsideBounds ). || 수 |
| 29 | 뷰 변경의 끝에서 완료 이유를 결정할 수 있습니다. || 수 |

술어

• _Overpan_ 은 사용자가 콘텐츠 크기 이상으로 이동하거나 확대/축소하려고 하면 탄성/고무 밴드 효과가 나타납니다.
• _Railing_ 은 스크롤러가 초기 제스처의 방향에 따라 "선호하는" 축으로의 움직임을 자동으로 잠글 때입니다.
• _Chaining_ 은 다른 표면 안에 중첩된 scrollabe 표면이 있고 내부의 스크롤 이동이 그 범위에 도달하면 외부 표면에서 계속하도록 승격되는 경우입니다.
• _스냅 포인트_ 는 관성 스크롤(즉, 사용자가 손가락을 뗀 후 애니메이션 스크롤)이 끝나면 뷰포트가 정지하는 스크롤 가능한 콘텐츠 내의 위치입니다. FlipView와 같은 컨트롤에는 스냅 포인트가 필요합니다.
• _Scroll anchoring_ 은 표시되는 콘텐츠의 상대적 위치를 유지하기 위해 뷰포트가 자동으로 이동하는 곳입니다. 레이아웃으로 인한 콘텐츠 위치 또는 크기의 갑작스러운 이동으로 인해 사용자가 영향을 받는 것을 방지합니다(예: 사용자가 기사를 읽고 있고 잠시 후 기사 상단의 이미지/광고가 마침내 로드되어 모든 것이 아래로 이동함) . 스크롤 앵커링은 다양한 크기의 콘텐츠를 다룰 때 UI 가상화를 위한 필수 요소입니다.
• _중력 우물_ 은 사용자가 콘텐츠를 조작하는 동안(즉, 사용자의 손가락이 아래로 내려간 경우) 스크롤 동작에 영향을 주는 스크롤 가능한 콘텐츠 내의 위치입니다. 예를 들어, 중력 우물은 사용자가 능동적으로 이동하거나 확대/축소할 때 움직임이 느려지거나 빨라지는 것처럼 보이는 스크롤링의 감지된 마찰을 변경하는 데 사용할 수 있습니다.

사용 예

머리말

기본적으로 ScrollViewer는 콘텐츠의 크기가 뷰포트보다 클 때 콘텐츠에 대한 패닝을 지원합니다. 콘텐츠의 크기는 XAML의 레이아웃 시스템에 의해 결정됩니다.

여기에 있는 예제는 현재 ScrollViewer와 새 ScrollViewer 간의 주요 API 차이점을 강조하기 위한 것입니다.

세로 스크롤(차이 없음)

콘텐츠의 너비는 뷰포트와 동일하도록 자동으로 제한됩니다. 높이는 제한이 없습니다. 뷰포트의 높이를 초과하면 사용자는 다양한 입력 방식을 통해 팬할 수 있습니다.

<ScrollViewer Width="500" Height="400">
    <ItemsRepeater ItemsSource="{x:Bind ViewModel.Items}" ItemTemplate="{StaticResource MyTemplate}"/>
</ScrollViewer>

수평 스크롤

이는 이전에 HorizontalScrollBarVisibility를 변경해야 했던 기존 ScrollViewer에서 의도적으로 벗어났습니다. 많은 개발자들을 혼란스럽게 했습니다.

<ScrollViewer Width="500" Height="400" ContentOrientation="Horizontal">
    <StackPanel Orientation="Horizontal">
        <!-- ... -->
    </StackPanel>
</ScrollViewer>

_ContentOrientation_ 속성을 설정하면 가로 전용 스크롤이 활성화됩니다. 레이아웃 중에 콘텐츠에 사용되는 제약 조건을 결정합니다. Horizontal 값은 콘텐츠가 수평으로 제한되지 않고(무한한 크기 허용) 뷰포트와 일치하도록 수직으로 제한됨을 의미합니다. 마찬가지로 수직(기본값)은 수직으로 구속되지 않고 수평으로 구속됨을 의미합니다.

큰 이미지 스크롤

_Both_의 ContentOrientation은 콘텐츠가 수평 및 수직으로 제한되지 않음을 의미합니다.

<ScrollViewer Width="500" Height="400" ContentOrientation="Both">
    <Image Source="Assets/LargeEiffelTower.png"/>
</ScrollViewer>

ScrollBar 가시성 변경

이 예에서는 항상 두 스크롤 막대를 모두 숨깁니다. 사용자는 여전히 어느 방향으로든 콘텐츠를 이동할 수 있습니다.

<ScrollViewer Width="500" Height="400"
              ContentOrientation="Both"
              HorizontalScrollBarVisibility="Hidden"
              VerticalScrollBarVisibility="Hidden">
    <Image Source="Assets/LargeEiffelTower.png"/>
</ScrollViewer>

특정 유형의 입력에 대한 기본 제공 지원 끄기

이 예에서 개발자는 마우스 휠 입력에 대해 사용자 지정 처리를 수행하고 펜을 통해 올가미 선택 환경을 지원하는 캔버스 기반 앱을 만들고 있습니다. Touch와 같은 다른 유형은 허용하면서 이러한 입력 유형은 무시하도록 ScrollViewer를 구성할 수 있습니다.

<ScrollViewer IgnoredInputKind="MouseWheel,Pen"
              Width="500" Height="400"
              ContentOrientation="Both" >
    <SwapChainPanel x:Name="swapChainPanel" Width="40000" Height="40000">
        ...
    </SwapChainPanel>
</ScrollViewer>

프로그래밍 방식 스크롤의 애니메이션 사용자 지정

개발자는 Slider의 ValueChanged 이벤트를 수신하고 기본 애니메이션의 사용자 지정 기간을 사용하여 ScrollViewer의 VerticalOffset에 애니메이션을 적용합니다.

private void VerticalOffsetSlider_ValueChanged(
    object sender,
    RangeBaseValueChangedEventArgs e)
{
    double verticalOffsetDelta = GetOffsetDelta();
    TimeSpan animationDuration = GetCustomAnimationDuration();

    // Initiate the scroll and enqueue the ScrollInfo we'll use to identify related events
    ScrollInfo scrollInfo = _scrollViewer.ScrollBy(0.0, verticalOffsetDelta);
    _myScrollRequests.Add(new MyScrollRequest(scrollInfo, animationDuration));
}

// Listen to the ScrollViewer's ScrollAnimationStarting event and customize 
// the default animation
private void ScrollViewer_ScrollAnimationStarting(
    ScrollViewer scrollViewer,
    ScrollAnimationStartingEventArgs e)
{
    MyScrollRequest myScrollRequest = _myScrollRequests.FindRequest(e.ScrollInfo);
    e.Animation.Duration = myScrollRequest.AnimationDuration;
}

// Dequeue the ScrollInfo once the action completes
private void ScrollViewer_ScrollCompleted(
    ScrollViewer scrollViewer,
    ScrollCompletedEventArgs e)
{
    _myScrollRequests.RemoveRequest(e.ScrollInfo);
}

세부 기능 설계

높은 정책 및 낮은 정책 스크롤

스크롤러(낮은 정책)

Scroller는 모든 필수 이동 및 확대/축소 논리를 제공하는 크롬이 없는 저수준 빌딩 블록입니다. 플랫폼의 정책이 훨씬 더 낮은 InteractionTracker 를 XAML 태그 친화적인 요소로 래핑합니다.
문자 그대로 Scroller는 ScrollViewer의 "표시 영역"이며 ScrollContentPresenter를 대신합니다. 그러나 Scroller는 ScrollContentPresenter와 달리 단순히 콘텐츠를 클리핑하는 것 이상을 수행합니다.

Scroller는 다음과 같은 이점과 함께 InteractionTracker를 직접 사용할 수 있는 유연성을 제공합니다.

• 접근성 지원
• 마크업 친화적인 구문 및 사용하기 쉬운 API
• XAML의 레이아웃 시스템 및 가상화 기능과의 통합

ScrollViewer(높은 정책)

새로운 ScrollViewer는 Scroller를 래핑하고 해당 속성을 공통 값으로 설정합니다. 예를 들어 <ScrollViewer/> 는 수평 및 수직 스크롤 상호 작용을 모두 지원하도록 Scroller를 구성하지만 기본 사용자 경험이 수직 전용 스크롤(일반적인 경우)로 나타나도록 콘텐츠의 너비를 제한합니다.

ScrollViewer는 Scroller 사용에 비해 다음과 같은 이점을 제공합니다.

• 기본 UX(예: 스크롤 표시기, 마우스용 의식 스크롤바, 기본 애니메이션 곡선)
• Scroller/InteractionTracker(예: 키보드 및 GamePad)에서 처리하지 않는 UI 스레드 바운드 입력에 대한 기본 지원
• GamePad의 기본 포커스 이동(페이지 업/다운 및 트리거에 대한 응답으로 자동으로 포커스 설정)
• 사용자 시스템 설정에 대한 기본 인식(예: Windows에서 자동으로 스크롤 막대 숨기기)
• (향후) 스냅 포인트를 위한 손쉬운 구성 옵션
• (향후) 더 많은 마우스 패닝 모드 지원(예: 열기/닫기 손으로 콘텐츠 클릭 및 드래그, 마우스 휠을 통한 마우스 패닝 / "나침반" 커서를 표시하는 가운데 버튼 클릭)

어느 것을 사용할 것인가?

앱 및 많은 컨트롤 작성자에 대한 기본 선택은 ScrollViewer를 사용하는 것입니다. 플랫폼과 일치하는 기본 UX와 더 큰 사용 편의성을 제공합니다. Scroller는 기본 UX/정책이 필요하지 않은 경우에 적합합니다(예: 향상된 FlipView 컨트롤 생성 또는 크롬 없는 스크롤 표면 생성).

ScrollViewer 전용 API

HorizontalScrollBarVisibility / VerticalScrollBarVisibility

가로 및 세로 스크롤 막대의 기본값은 _Auto_입니다. 콘텐츠가 뷰포트보다 넓거나 높은지 여부에 따라 자동으로 표시되거나 숨겨집니다.

새 ScrollViewer에 사용할 수 있는 열거형 옵션에는 '비활성화됨' 옵션이 없습니다. 대신 가로 또는 세로로 이동하는 사용자 상호 작용에 응답하도록 컨트롤을 구성하는 것은 _HorizontalScrollMode_ 및 _VerticalScrollMode_ 속성에만 기반합니다.

namespace Microsoft.UI.Xaml.Controls
{
    public enum ScrollBarVisibility
    {
        Auto = 0,    // Only visible when the ZoomFactor * content size > viewport
        Visible = 1, // Always visible
        Hidden = 2   // Always hidden
    }
}

아래 그림에서 마우스 커서는 수직 스크롤 막대 위에 있습니다. 콘텐츠가 뷰포트와 너비가 같기 때문에 볼 수 있는 유일한 것입니다.

콘텐츠가 두 차원 모두에서 뷰포트보다 크면 의식 스크롤 막대가 모두 표시되고 오른쪽 하단 모서리에 구분 기호가 표시됩니다.

스크롤러 전용 API

수평 스크롤 컨트롤러 / 수직 스크롤 컨트롤러

Scroller는 _HorizontalScrollController_ 및 _VerticalScrollController_를 _IScrollController_ 인터페이스를 구현하는 유형으로 설정하여 스크롤을 제어하는 ​​대화형 "위젯"에 연결할 수 있습니다. ScrollBars는 이러한 위젯의 친숙한 예입니다. ScrollViewer는 Scroller에 이러한 두 개의 위젯을 제공합니다. 예를 들어 개발자는 UI 스레드 독립 입력에 대해 Composition.Visual에 의존하는 사용자 지정 IScrollController 구현을 만들 수 있습니다.

_scroller.HorizontalScrollController = new Acme.Slider(orientation: Orientation.Horizontal);
_scroller.VerticalScrollController = new Acme.Slider(orientation: Orientation.Vertical);

ScrollViewer / Scroller의 하위 제한 사항

프레임워크에는 Windows 10 2018년 4월 업데이트를 기준으로 사용자 지정 스크롤 컨트롤을 빌드하는 데 필요한 모든 후크가 노출되어 있어야 합니다. 이전 릴리스를 대상으로 하는 경우 다음과 같은 제한 사항이 있을 수 있습니다.
| 출시 | 제한 | 이유 |
|:-:|:--|:-:|
| Windows 10 Fall Creators 업데이트(빌드 16299) 및 이전 | 포커스를 받으면 요소가 자동으로 표시되지 않습니다. | UIElement의 BringIntoViewRequested 이벤트를 사용할 수 없습니다. |
| | 컨트롤은 EffectiveViewportChanged 이벤트에 참여할 수 없습니다. 시스템에서 렌더링된 포커스 사각형은 뷰포트의 경계로 잘리지 않습니다. | UIElement의 RegisterAsScrollPort를 사용할 수 없습니다. |

제안된 API

스크롤 뷰어

```C#
공개 클래스 Microsoft.UI.Xaml.Controls.ScrollViewer : 컨트롤
{
스크롤 뷰어();

// Default Value: non-null instance
Windows.UI.Composition.CompositionPropertySet ExpressionAnimationSources { get; }

/*

• 레이아웃 중심 속성
  */
  // 기본값: null
  UIElement 콘텐츠 { get; 세트; };

// Default Value: Vertical
Microsoft.UI.Xaml.Controls.ContentOrientation ContentOrientation { get; set; };

// Default Value: 0.0
Double HorizontalOffset { get; };

// Default Value: 0.0
Double VerticalOffset { get; };

// Default Value: 1.0
Single ZoomFactor { get; };

// Default Value: 0.0
Double ExtentWidth { get; };

// Default Value: 0.0
Double ExtentHeight { get; };

// Default Value: 0.0
Double ViewportWidth { get; };

// Default Value: 0.0
Double ViewportHeight { get; };

// Default Value: 0.0
Double ScrollableWidth { get; };

// Default Value: 0.0
Double ScrollableHeight { get; };

// Default Value: Auto
M.UI.Xaml.Controls.ScrollBarVisibility HorizontalScrollBarVisibility {get;set;};

// Default Value: Auto
M.UI.Xaml.Controls.ScrollBarVisibility VerticalScrollBarVisibility {get;set;};

// Default Value: Collapsed
// Used for template binding the Visibility property of the horizontal
// ScrollBar in the control template
Visibility ComputedHorizontalScrollBarVisibility{ get; };

// Default Value: Collapsed
// Used for template binding the Visibility property of the vertical
// ScrollBar in the control template
Visibility ComputedVerticalScrollBarVisibility{ get; };

/*

• 사용자 상호작용 중심 속성
  */
  // 기본값: 사용
  Microsoft.UI.Xaml.Controls.ScrollMode HorizontalScrollMode { 가져오기; 세트; };

// Default Value: Enabled
Microsoft.UI.Xaml.Controls.ScrollMode VerticalScrollMode { get; set; };

// Default Value: Disabled
Microsoft.UI.Xaml.Controls.ZoomMode ZoomMode { get; set; };

// Default Value: All
Microsoft.UI.Xaml.Controls.InputKind IgnoredInputKind { get; set; };

// Default Value: Idle
Microsoft.UI.Xaml.Controls.InteractionState State { get; };

// Default Value: Auto
Microsoft.UI.Xaml.Controls.ChainingMode HorizontalScrollChainingMode { get; set; };

// Default Value: Auto
Microsoft.UI.Xaml.Controls.ChainingMode VerticalScrollChainingMode { get; set; };

// Default Value: True
boolean IsHorizontalRailEnabled { get; set; };

// Default Value: True
boolean IsVerticalRailEnabled { get; set; };

// Default Value: Auto
Microsoft.UI.Xaml.Controls.ChainingMode ZoomChainingMode { get; set; };

// Default Value: None
M.UI.Xaml.Controls.SnapPointsType HorizontalSnapPointsType { get; set; };

// Default Value: None
M.UI.Xaml.Controls.SnapPointsType VerticalSnapPointsType { get; set; };

// Default Value: Near
M.UI.Xaml.C.Primitives.SnapPointsAlignment HorizontalSnapPointsAlignment { g;s; };

// Default Value: Near
M.UI.Xaml.C.Primitives.SnapPointsAlignment VerticalSnapPointsAlignment { g;s; };

// Default Value: 0.95, 0.95
Windows.Foundation.Numerics.Vector2 ScrollInertiaDecayRate { get; set; }; 

// Default Value: 0.95
Single ZoomInertiaDecayRate { get; set; }; 

// Default Value: 0.1
Double MinZoomFactor { get; set; };

// Default Value: 10.0
Double MaxZoomFactor { get; set; };

// Default Value: 0.0
Double HorizontalAnchorRatio { get; set; };

// Default Value: 0.0
Double VerticalAnchorRatio { get; set; };

// Forwarded to inner Scroller’s IScrollAnchorProvider implementation
// Default Value: null
Windows.UI.Xaml.UIElement CurrentAnchor { get; };

/*

• 행동 양식
  */
  // 지정된 오프셋으로 비동기식으로 스크롤합니다. 애니메이션 허용,
  // 스냅 포인트를 존중합니다. ScrollInfo 구조체를 반환합니다.
  Microsoft.UI.Xaml.Controls.ScrollInfo ScrollTo(
  이중 수평 오프셋,
  이중 수직 오프셋);

// Asynchronously scrolls to specified offsets with optional animation,
// with optional snap points respecting. Returns a ScrollInfo struct.
Microsoft.UI.Xaml.Controls.ScrollInfo ScrollTo(
    double horizontalOffset,
    double verticalOffset,
    Microsoft.UI.Xaml.Controls.ScrollOptions options);

// Asynchronously scrolls by the provided delta amount.
// Allows animation, respects snap points. Returns a ScrollInfo struct.
Microsoft.UI.Xaml.Controls.ScrollInfo ScrollBy(
    double horizontalOffsetDelta,
    double verticalOffsetDelta);

// Asynchronously scrolls by the provided delta amount with
// optional animation, with optional snap points respecting.
// Returns a ScrollInfo struct.
Microsoft.UI.Xaml.Controls.ScrollInfo ScrollBy(
    double horizontalOffsetDelta,
    double verticalOffsetDelta,
    Microsoft.UI.Xaml.Controls.ScrollOptions options);

// Asynchronously adds scrolling inertia. Returns a ScrollInfo struct.
Microsoft.UI.Xaml.Controls.ScrollInfo ScrollFrom(
    Vector2 offsetsVelocity,
    Nullable<Vector2> inertiaDecayRate);

// Asynchronously zooms to specified zoom factor. Allows animation
// (respects snap points in v2). Returns a ZoomInfo struct.
Microsoft.UI.Xaml.Controls.ZoomInfo ZoomTo(
    float zoomFactor,
    Nullable<Vector2> centerPoint);

// Asynchronously zooms to specified offsets with optional animation
// (with optional snap points respecting in v2). Returns a ZoomInfo struct.
Microsoft.UI.Xaml.Controls.ZoomInfo ZoomTo(
    float zoomFactor,
    Nullable<Vector2> centerPoint,
    Microsoft.UI.Xaml.Controls.ZoomOptions options);

// Asynchronously zooms by the provided delta amount. Allows animation
// (respects snap points in v2). Returns a ZoomInfo struct.
Microsoft.UI.Xaml.Controls.ZoomInfo ZoomBy(
    float zoomFactorDelta,
    Nullable<Vector2> centerPoint);

// Asynchronously zooms by the provided delta amount with optional animation
// (with optional snap points respecting in v2). Returns an ZoomInfo struct.
Microsoft.UI.Xaml.Controls.ZoomInfo ZoomBy(
    float zoomFactorDelta,
    Nullable<Vector2> centerPoint,
    Microsoft.UI.Xaml.Controls.ZoomOptions options);

// Asynchronously adds zooming inertia. Returns a ZoomInfo struct.
Microsoft.UI.Xaml.Controls.ZoomInfo ZoomFrom(
    float zoomFactorVelocity,
    Nullable<Vector2> centerPoint,
    Nullable<float> inertiaDecayRate);

/*

• 내부 Scroller의 IScrollAnchorProvider 구현으로 전달됨
  */
  무효 RegisterAnchorCandidate(UIElement 요소);
  무효 UnregisterAnchorCandidate(UIElement 요소);

/*

• 이벤트
  */
  // HorizontalOffset, VerticalOffset 및 ZoomFactor 중 하나가 있을 때마다 발생
  // 종속성 속성이 변경되었습니다.
  이벤트 유형 이벤트 핸들러보기변경됨;

// Raised when any of the ExtentWidth and ExtentHeight dependency property changed.
event TypedEventHandler<ScrollViewer, Object> ExtentChanged;

// Raised when the State dependency property changed.
event TypedEventHandler<ScrollViewer, Object> StateChanged;

// Raised when a ScrollTo or ScrollBy call triggers an animation.
// Allows customization of that animation.
event TypedEventHandler<ScrollViewer, Microsoft.UI.Xaml.Controls.ScrollAnimationStartingEventArgs>
    ScrollAnimationStarting;

// Raised when a ZoomTo or ZoomBy call triggers an animation.
// Allows customization of that animation.
event TypedEventHandler
    <ScrollViewer, Microsoft.UI.Xaml.Controls.ZoomAnimationStartingEventArgs>
    ZoomAnimationStarting;

// Raised at the end of a ScrollTo, ScrollBy, or ScrollFrom asynchronous
// operation. Provides the original ScrollInfo struct.
event TypedEventHandler
    <ScrollViewer, Microsoft.UI.Xaml.Controls.ScrollCompletedEventArgs>
    ScrollCompleted;

// Raised at the end of a ZoomTo, ZoomBy, or ZoomFrom asynchronous operation.
// Provides the original ZoomInfo struct.
event TypedEventHandler
    <ScrollViewer, Microsoft.UI.Xaml.Controls.ZoomCompletedEventArgs>
    ZoomCompleted;

// Raised at the beginning of a bring-into-view-request participation.
// Allows customization of that participation. 
event TypedEventHandler
    <ScrollViewer, Microsoft.UI.Xaml.Controls.BringingIntoViewEventArgs>
    BringingIntoView;

// Raised to allow the listener to pick an anchor element, when anchoring
// is turned on.
event TypedEventHandler
    <ScrollViewer, Microsoft.UI.Xaml.Controls.AnchorRequestedEventArgs>
    AnchorRequested;

/*

• 종속성 속성
  */
  정적 DependencyProperty ContentProperty { 가져오기; };
  정적 DependencyProperty ContentOrientationProperty { 가져오기; };
  정적 DependencyProperty ComputedHorizontalScrollBarVisibilityProperty { get; };
  정적 DependencyProperty ComputedVerticalScrollBarVisibilityProperty { get; };
  정적 DependencyProperty HorizontalScrollBarVisibilityProperty { get; };
  정적 DependencyProperty VerticalScrollBarVisibilityProperty { get; };

static DependencyProperty IgnoredInputKindProperty { get; };
static DependencyProperty HorizontalScrollModeProperty { get; };
static DependencyProperty VerticalScrollModeProperty { get; };
static DependencyProperty ZoomModeProperty { get; };
static DependencyProperty HorizontalScrollChainingModeProperty {g};
static DependencyProperty VerticalScrollChainingModeProperty {g};
static DependencyProperty IsHorizontalRailEnabledProperty {g};
static DependencyProperty IsVerticalRailEnabledProperty {g};
static DependencyProperty ZoomChainingModeProperty { get; };
static DependencyProperty MinZoomFactorProperty { get; };
static DependencyProperty MaxZoomFactorProperty { get; };
static DependencyProperty HorizontalAnchorRatioProperty { get; };
static DependencyProperty VerticalAnchorRatioProperty { get; };

}
```

열린 질문

• 레이아웃 제약 조건이 콘텐츠에 적용되는 방식에 영향을 미치는 ContentOrientation 속성(또는 다른 이름의 속성)이 있으면 상황이 더 복잡하거나 쉬워집니까?
• 확대/축소 관련 API를 파생된 컨트롤(예: ZoomViewer)로 분리하여 ScrollViewer가 스크롤에 대해 엄격하게 적용되도록 해야 합니까?