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
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.Activatable(1)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class ItemsRepeaterScrollHost final : FrameworkElement
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.Activatable(1)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
public sealed class ItemsRepeaterScrollHost : 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
属性
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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名前空間を参照してください)。

適用対象