ItemsRepeaterScrollHost Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
/// [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
- Vererbung
-
ItemsRepeaterScrollHost
- Attribute
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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). |