ItemsRepeaterScrollHost Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ein Hilfsprogramm zum Koordinieren der Interaktion zwischen ItemsRepeater und ScrollViewer. Verwenden Sie die ItemsRepeaterScrollHost, wenn Ihre App auf Versionen von Windows vor Windows 10 1809 (Build 17763) ausgeführt wird. Wenn Ihre App nur auf Versionen von Windows 1809 oder höher ausgeführt wird, muss dieses Steuerelement nicht verwendet werden.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).

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

Vererbung

FrameworkElement

ItemsRepeaterScrollHost

Attribute

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter ItemsRepeater.

Die WinUI 3-Katalog- und WinUI 2-Katalog-Apps umfassen interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.

Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.

Wenn sie nicht installiert sind, können Sie den WinUI 3-Katalog und den WinUI 2-Katalog aus dem Microsoft Store herunterladen.

Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).

In diesem Beispiel wird eine bildlaufbare Liste von Personen angezeigt.

<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

Hinweise

ItemsRepeaterScrollHost ist eine Hilfsklasse, mit der Sie einen ScrollViewer umschließen und funktionen neuer APIs in früheren Versionen von Windows 10 bereitstellen können.

Ab Windows 10, Version 1809 (SDK 17763) verfügt ScrollViewer über Eigenschaften, die die Interaktion zwischen einem ItemsRepeater und dem ScrollViewer koordinieren. Wenn Ihre App auf Versionen von Windows 10 vor Version 1809 (SDK 17763) ausgerichtet ist, schließen Sie Ihren ScrollViewer in einem ItemsRepeaterScrollHost um, um die Funktionalität dieser APIs bereitzustellen. Die Eigenschaften auf ItemsRepeaterScrollHost replizieren die gleichen Funktionen und Verhaltensweisen wie die ähnlich benannten, die auf ScrollViewer gefunden wurden.

Wenn die Mindestzielversion Ihrer App Windows 10, Version 1809 (SDK 17763) oder höher ist, muss dieses Steuerelement nicht verwendet werden.

Konstruktoren

ItemsRepeaterScrollHost()

Initialisiert eine neue Instanz der ItemsRepeaterScrollHost-Klasse . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).

Eigenschaften

CurrentAnchor	Das derzeit ausgewählte Ankerelement, das zum Scrollen verwendet werden soll. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).
HorizontalAnchorRatio	Bestimmt die horizontale Position des ScrollViewer-Ankerpunkts im Hinblick auf den Viewport. Standardmäßig wählt der ScrollViewer ein Element als " CurrentAnchor " aus, indem er das Element in seinem Viewport identifiziert, der dem Ankerpunkt am nächsten ist. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).
ScrollViewer	Ruft den ScrollViewer-Wert ab oder legt diesen fest, um den Host zu hosten. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).
VerticalAnchorRatio	Bestimmt die vertikale Position des ScrollViewer-Ankerpunkts im Hinblick auf den Viewport. Standardmäßig wählt der ScrollViewer ein Element als " CurrentAnchor " aus, indem er das Element in seinem Viewport identifiziert, der dem Ankerpunkt am nächsten ist. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe die Windows App SDK Namespaces).