これは、新機能またはAPI提案のテンプレートです。 たとえば、これを使用して、既存のタイプに新しいAPIを提案したり、新しいUIコントロールのアイデアを提案したりできます。 すべての詳細がわからなくても問題ありません。要約と理論的根拠から始めることができます。 次のリンクでは、WinUI機能/ APIプロポーザルプロセスについて説明しています。https：//github.com/Microsoft/microsoft-ui-xaml-specs/blob/master/docs/feature_proposal_process.md機能またはAPIプロポーザルのタイトルを追加します。 短く説明してください

提案：ScrollViewer

概要

tl：dr; 柔軟でありながら使いやすいXAMLのスクロールおよびズーム制御を提供します。これは、Win10のダウンレベルリリースを対象とする場合でも利用できます。

ScrollViewerコントロールは、アプリケーションとコントロール（プラットフォームと非プラットフォームの両方）にとって基本的なスクロールが非常に重要であるため、どのUIでも重要な役割を果たします。 このコントロールは、デフォルトのポリシーとUX（たとえば、意識的なスクロールバー、フォーカス/キーボードの相互作用、アクセシビリティ、デフォルトのスクロールアニメーションなど）とともに、パンとズームの機能を提供します。 また、日常のアプリシナリオを簡単にすることから、スクロールベースのコントロールの主要コンポーネントになり、非常に高度なユースケースにサービスを提供できるように、十分な柔軟性が必要です。 現在の制御では、このレベルの柔軟性は提供されません。

理論的根拠

コアプラットフォームのパブリックAPIに階層化された方法で、ScrollViewerコントロールをリポジトリに導入することは、次のような重要な足がかりになります。

1. より多くのコントロールをリポジトリに持ち上げることができます（俊敏性の向上）。
2. 開発者に、低レベルのプラットフォーム機能の柔軟性と高レベルのフレームワークサービス（アクセシビリティなど）の利点を組み合わせた使いやすいコントロールを提供します。
3. XAMLの新しいスクロール関連機能を有効にして、以前のバージョンのWin10でライトアップします。

既存のコントロールは、 DirectManipulation APIに基づいてWin8で作成されました

既存の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 | 2つ以上の領域をちらつきやジャンクのないスクロールで同期できます（テキスト差分シナリオなど）。 || できた|
| 23 | 入力によるビューの変更に合わせてアニメーションカーブをカスタマイズできます（つまり、重力ウェルなどの指を下に向ける動作を定義します）。 || できた|
| 24 | 上または下へのスクロールジェスチャをサポートします。 || できた|
| 25 | オーバーパンを無効にすることができます。 || できた|
| 26 | UIElementのManipulationModeプロパティに基づいて、ScrollViewer内のコンテンツを選択的に操作できます。 || できた|
| 27 | 慣性をオフにしたり、慣性から跳ね返ったりすることができます。 || できた|
| 28 | コンテンツのクリッピングを無効にすることができます（つまり、 CanContentRenderOutsideBounds ）。 || できた|
| 29 | ビュー変更の終了時に完了理由を判別できます。 || できた|

用語

• _Overpan_は、ユーザーがコンテンツのサイズを超えてパンまたはズームしようとし、弾性/ラバーバンド効果が発生した場合です。
• _Railing_は、最初のジェスチャの方向に基づいて、スクローラーが動きを「優先」軸に自動的にロックする場合です。
• _Chaining_は、別の内部にネストされたスクロール可能なサーフェスがあり、内側のスクロール動作がその範囲に達すると、外側のサーフェスで続行するようにプロモートされる場合です。
• _スナップポイント_は、慣性スクロールの終了時にビューポートが
• _スクロールアンカー_は、表示されているコンテンツの相対位置を維持するためにビューポートが自動的にシフトする場所です。 レイアウトによるコンテンツの位置やサイズの突然の変化による影響をユーザーが防ぐことができます（つまり、ユーザーが記事を読んでいて、しばらくすると、記事の上部にある画像/広告が最終的に読み込まれるため、すべてがジャンプダウンします） 。 スクロールアンカーは、可変サイズのコンテンツを処理する場合のUI仮想化に必要です。
• _Gravity wells_は、ユーザーがコンテンツを操作している間（つまり、ユーザーの指が下にあるとき）のスクロール動作に影響を与えるスクロール可能なコンテンツ内の場所です。 たとえば、重力ウェルを使用して、ユーザーがアクティブにパンまたはズームすると、動きが遅くなったり速くなったりするように見えるスクロールの知覚摩擦を変更できます。

使用例

序文

デフォルトでは、コンテンツのサイズがビューポートよりも大きい場合、ScrollViewerはコンテンツのパンをサポートします。 コンテンツのサイズは、XAMLのレイアウトシステムによって決定されます。

ここでの例は、現在のScrollViewerと新しいScrollViewerの主なAPIの違いを強調することを目的としています。

垂直スクロール（違いなし）

コンテンツの幅は、ビューポートと同じになるように自動的に制限されます。 高さには制約がありません。 ビューポートの高さを超える場合、ユーザーはさまざまな入力モダリティを介してパンできます。

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

水平スクロール

これは、以前はHorizo​​ntalScrollBarVisibilityを変更する必要があった既存のScrollViewerからの意図的な逸脱です。 それは多くの開発者を混乱させました。

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

水平方向のみのスクロールは、 _ContentOrientation_プロパティを設定することで有効になります。 レイアウト中にコンテンツに使用される制約を決定します。 値Horizo​​ntalは、コンテンツが水平方向に制約されておらず（無限のサイズが許可されている）、ビューポートに一致するように垂直方向に制約されていることを意味します。 同様に、Vertical（デフォルト）は、垂直方向に制約がなく、水平方向に制約があることを意味します。

大きな画像をスクロールする

_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>

プログラマティックスクロールのアニメーションをカスタマイズする

開発者は、スライダーの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（つまり、キーボードとゲームパッド）で処理されないUIスレッドバインド入力のデフォルトサポート
• ゲームパッドのデフォルトのフォーカス移動（ページアップ/ダウン、トリガーに応じて自動的にフォーカスを設定）
• ユーザーのシステム設定のデフォルト認識（たとえば、Windowsでスクロールバーを自動的に非表示にする）
• （将来）スナップポイントの簡単な構成オプション
• （将来）より多くのマウスパンモードのサポート（例：開く/閉じる手でコンテンツをクリックアンドドラッグ、マウスホイールを介したマウスパン/「コンパス」カーソルを表示する中央ボタンクリック）

どちらを使用しますか？

アプリと多くのコントロール作成者のデフォルトの選択は、ScrollViewerを使用することです。 使いやすさが向上し、プラットフォームと一貫性のあるデフォルトのUXが提供されます。 Scrollerは、デフォルトのUX /ポリシーが必要ない場合に適しています。たとえば、改良されたFlipViewコントロールや、クロムのないスクロール面を作成します。

ScrollViewerのみのAPI

Horizo​​ntalScrollBarVisibility / VerticalScrollBarVisibility

水平スクロールバーと垂直スクロールバーの両方のデフォルト値は_Auto_です。 コンテンツがビューポートよりも広い/高いかどうかに基づいて、自動的に表示または非表示になります。

'Disabled'オプションは、新しいScrollViewerで使用可能な列挙型オプションには存在しません。 代わりに、水平方向または垂直方向にパンするユーザーインタラクションに応答するようにコントロールを構成することは、_Horizo​​ntalScrollMode_および_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

Horizo​​ntalScrollController / VerticalScrollController

Scrollerは、その_Horizo​​ntalScrollController_および_VerticalScrollController_を_IScrollController_インターフェイスを実装するタイプに設定することにより、スクロールを制御するインタラクティブな「ウィジェット」に接続できます。 ScrollBarsは、そのようなウィジェットのよく知られた例です。 ScrollViewerは、そのScrollerに2つのそのようなウィジェットを提供します。 たとえば、開発者は、UIスレッドに依存しない入力のためにComposition.Visualに依存するカスタムIScrollController実装を作成できます。

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

ScrollViewer / Scrollerのダウンレベルの制限

フレームワークには、Windows 10 April 2018 Updateの時点で、カスタムスクロールコントロールを構築するために必要なすべてのフックが公開されている必要があります。 以前のリリースを対象とする場合、制限がある可能性があります。
| リリース| 制限| 理由|
|：-：|：-|：-：|
| Windows 10 Fall Creators Update（ビルド16299）以前| フォーカスを受け取ったときに要素が自動的に表示されることはありません。 | UIElementのBringIntoViewRequestedイベントは利用できません|
| | コントロールはEffectiveViewportChangedイベントに参加できません。 システムでレンダリングされたフォーカス四角形は、ビューポートの境界にクリップされません。 | UIElementのRegisterAsScrollPortは利用できません|

提案されたAPI

ScrollViewer

`` `C＃
パブリッククラスMicrosoft.UI.Xaml.Controls.ScrollViewer：コントロール
{{
ScrollViewer（）;

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

/ *

• レイアウト中心のプロパティ
  * /
  //デフォルト値：null
  UIElement Content {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 Horizo​​ntalScrollMode {get; 設定; };

// 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（
  ダブルhorizo​​ntalOffset、
  ダブルverticalOffset）;

// 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実装に転送されます
  * /
  void RegisterAnchorCandidate（UIElement element）;
  void UnregisterAnchorCandidate（UIElement element）;

/ *

• イベント
  * /
  // Horizo​​ntalOffset、VerticalOffset、ZoomFactorのいずれかが発生するたびに発生します
  //依存関係プロパティが変更されました。
  イベントTypedEventHandlerViewChanged;

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

/ *

• 依存関係のプロパティ
  * /
  static DependencyProperty ContentProperty {get; };
  static DependencyProperty ContentOrientationProperty {get; };
  static DependencyProperty ComputedHorizo​​ntalScrollBarVisibilityProperty {get; };
  static DependencyProperty ComputedVerticalScrollBarVisibilityProperty {get; };
  static DependencyProperty Horizo​​ntalScrollBarVisibilityProperty {get; };
  static 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プロパティ（または別の名前のプロパティ）を使用すると、作業がより複雑または簡単になりますか？
• ScrollViewerが厳密にスクロールに関するものになるように、ズーム関連のAPIを派生コントロール（ZoomViewerなど）に分離する必要がありますか？