ItemsRepeaterScrollHost Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Helper per coordinare l'interazione tra ItemsRepeater e ScrollViewer. Usa ItemsRepeaterScrollHost se l'app verrà eseguita nelle versioni di Windows precedenti Windows 10 1809 (Build 17763). Se l'app verrà eseguita solo nelle versioni di Windows 1809 o successive, non è necessario usare questo controllo.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di 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

Ereditarietà

FrameworkElement

ItemsRepeaterScrollHost

Attributi

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi ItemsRepeater.

Le app WinUI 3 Gallery e WinUI 2 Gallery includono esempi interattivi della maggior parte dei controlli WinUI 3 e WinUI 2, funzionalità e funzionalità.

Se è già installato, aprirli facendo clic sui collegamenti seguenti: Raccolta WinUI 3 o Raccolta WinUI 2.

Se non sono installati, è possibile scaricare la raccolta di WinUI 3 e la raccolta winUI 2 da Microsoft Store.

È anche possibile ottenere il codice sorgente per GitHub (usare il ramo principale per WinUI 3 e il ramo winui2 per WinUI 2).

Questo esempio mostra un elenco scorrevole di persone.

<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

Commenti

ItemsRepeaterScrollHost è una classe helper che è possibile usare per eseguire il wrapping di un controllo ScrollViewer e fornire funzionalità delle nuove API nelle versioni precedenti di Windows 10.

A partire da Windows 10, versione 1809 (SDK 17763), ScrollViewer ha proprietà che coordinano l'interazione tra ItemsRepeater e ScrollViewer. Se l'app è destinata a versioni di Windows 10 precedenti alla versione 1809 (SDK 17763), eseguire il wrapping di ScrollViewer in itemsRepeaterScrollHost per fornire la funzionalità di queste API. Le proprietà in ItemsRepeaterScrollHost replicano le stesse funzionalità e comportamento delle proprietà simili a quelle trovate in ScrollViewer.

Se la versione minima di destinazione dell'app è Windows 10, versione 1809 (SDK 17763) o versione successiva, non è necessario usare questo controllo.

Costruttori

ItemsRepeaterScrollHost()

Inizializza una nuova istanza della classe ItemsRepeaterScrollHost . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Proprietà

CurrentAnchor	Elemento di ancoraggio attualmente scelto da utilizzare per l'ancoraggio dello scorrimento. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
HorizontalAnchorRatio	Determina la posizione orizzontale del punto di ancoraggio di ScrollViewer rispetto al riquadro di visualizzazione. Per impostazione predefinita, ScrollViewer seleziona un elemento come CurrentAnchor identificando l'elemento nel riquadro di visualizzazione più vicino al punto di ancoraggio. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ScrollViewer	Ottiene o imposta ScrollViewer da ospitare. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
VerticalAnchorRatio	Determina la posizione verticale del punto di ancoraggio di ScrollViewer rispetto al riquadro di visualizzazione. Per impostazione predefinita, ScrollViewer seleziona un elemento come CurrentAnchor identificando l'elemento nel riquadro di visualizzazione più vicino al punto di ancoraggio. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).