ItemsRepeaterScrollHost Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Assistance pour coordonner l’interaction entre ItemsRepeater et ScrollViewer. Utilisez ItemsRepeaterScrollHost si votre application s’exécute sur des versions de Windows antérieures Windows 10 1809 (build 17763). Si votre application s’exécute uniquement sur les versions de Windows 1809 ou ultérieures, il n’est pas nécessaire d’utiliser ce contrôle.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

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

Héritage

FrameworkElement

ItemsRepeaterScrollHost

Attributs

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez ItemsRepeater.

Les applications WinUI 3 Gallery et WinUI 2 Gallery incluent des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 3 et WinUI 2.

Si elles sont déjà installées, ouvrez-les en cliquant sur les liens suivants : WinUI 3 Gallery ou WinUI 2 Gallery.

Si elles ne sont pas installées, vous pouvez télécharger WinUI 3 Gallery et WinUI 2 Gallery à partir du Microsoft Store.

Vous pouvez également obtenir le code source des deux applications à partir de GitHub (utilisez la branche main pour WinUI 3 et la branche winui2 pour WinUI 2).

Cet exemple montre une liste déroulante de personnes.

<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

Remarques

ItemsRepeaterScrollHost est une classe d’assistance que vous pouvez utiliser pour encapsuler un ScrollViewer et fournir des fonctionnalités de nouvelles API sur les versions antérieures de Windows 10.

À compter de Windows 10, version 1809 (SDK 17763), ScrollViewer a des propriétés qui coordonnent l’interaction entre un ItemsRepeater et le ScrollViewer. Si votre application cible des versions de Windows 10 antérieures à la version 1809 (SDK 17763), encapsulez votre ScrollViewer dans un ItemsRepeaterScrollHost pour fournir les fonctionnalités de ces API. Les propriétés sur ItemsRepeaterScrollHost répliquent les mêmes fonctionnalités et le même comportement que ceux nommés comme ceux trouvés sur ScrollViewer.

Si la version cible minimale de votre application est Windows 10, version 1809 (SDK 17763) ou ultérieure, il n’est pas nécessaire d’utiliser ce contrôle.

Constructeurs

ItemsRepeaterScrollHost()

Initialise une nouvelle instance de la classe ItemsRepeaterScrollHost . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

CurrentAnchor	Élément d’ancrage actuellement choisi à utiliser pour l’ancrage de défilement. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HorizontalAnchorRatio	Détermine la position horizontale du point d’ancrage de ScrollViewer par rapport à la fenêtre d’affichage. Par défaut, ScrollViewer sélectionne un élément comme CurrentAnchor en identifiant l’élément dans sa fenêtre d’affichage la plus proche du point d’ancrage. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ScrollViewer	Obtient ou définit ScrollViewer à héberger. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
VerticalAnchorRatio	Détermine la position verticale du point d’ancrage de ScrollViewer par rapport à la fenêtre d’affichage. Par défaut, ScrollViewer sélectionne un élément comme CurrentAnchor en identifiant l’élément dans sa fenêtre d’affichage la plus proche du point d’ancrage. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).