ItemsRepeaterScrollHost クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

ItemsRepeater と ScrollViewer の間の相互作用を調整するヘルパー。 アプリが 1809 (ビルド 17763) より前Windows 10バージョンの Windows で実行される場合は、ItemsRepeaterScrollHost を使用します。 アプリが Windows 1809 以降のバージョンでのみ実行される場合は、このコントロールを使用する必要はありません。

このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。

public ref class ItemsRepeaterScrollHost sealed : FrameworkElement

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ItemsRepeaterScrollHost final : FrameworkElement

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public sealed class ItemsRepeaterScrollHost : FrameworkElement

Public NotInheritable Class ItemsRepeaterScrollHost
Inherits FrameworkElement

継承

FrameworkElement

ItemsRepeaterScrollHost

属性

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、 ItemsRepeater を参照してください。

WinUI 3 ギャラリー アプリと WinUI 2 ギャラリー アプリには、ほとんどの WinUI 3 および WinUI 2 コントロールと機能の対話型の例が含まれています。

既にインストールされている場合は、WinUI 3 ギャラリーまたは WinUI 2 ギャラリーのリンクをクリックして開きます。

インストールされていない場合は、Microsoft Store から WinUI 3 ギャラリーと WinUI 2 ギャラリーをダウンロードできます。

GitHub から両方のソース コードを取得することもできます (WinUI 3 の場合は main ブランチ、WinUI 2 の場合は winui2 ブランチを使用します)。

この例では、スクロール可能なユーザーの一覧を示します。

<Page
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls">

    <muxc:ItemsRepeaterScrollHost>
        <ScrollViewer>
            <muxc:ItemsRepeater ItemsSource='{x:Bind PeopleCollection}' />
        </ScrollViewer>
    </muxc:ItemsRepeaterScrollHost> 

</Page

注釈

ItemsRepeaterScrollHost は、ScrollViewer をラップし、以前のバージョンのWindows 10で新しい API の機能を提供するために使用できるヘルパー クラスです。

Windows 10 Version 1809 (SDK 17763) 以降、ScrollViewer には ItemsRepeater と ScrollViewer の間の相互作用を調整するプロパティがあります。 アプリがバージョン 1809 (SDK 17763) より前のバージョンのWindows 10を対象とする場合は、ScrollViewer を ItemsRepeaterScrollHost にラップして、これらの API の機能を提供します。 ItemsRepeaterScrollHost のプロパティは、 ScrollViewer で見つかった同じ名前の機能と動作をレプリケートします。

アプリの最小ターゲット バージョンがWindows 10 Version 1809 (SDK 17763) 以降の場合は、このコントロールを使用する必要はありません。

コンストラクター

ItemsRepeaterScrollHost()

ItemsRepeaterScrollHost クラスの新しいインスタンスを初期化します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。

プロパティ

CurrentAnchor	スクロール アンカーに使用する現在選択されているアンカー要素。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
HorizontalAnchorRatio	ビューポートに対する ScrollViewer の アンカー ポイント の水平方向の位置を決定します。 既定では、ScrollViewer は、アンカー ポイントに最も近いビューポート内の要素を識別することで、要素を CurrentAnchor として選択します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
ScrollViewer	ホストする ScrollViewer を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
VerticalAnchorRatio	ビューポートに対する ScrollViewer の アンカー ポイント の垂直位置を決定します。 既定では、ScrollViewer は、アンカー ポイントに最も近いビューポート内の要素を識別することで、要素を CurrentAnchor として選択します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。