ListViewPersistenceHelper 类

定义

命名空间:

Windows.UI.Xaml.Controls

表示用于保存和检索 ListView 的相对滚动位置的帮助程序类。

public ref class ListViewPersistenceHelper sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ListViewPersistenceHelper final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ListViewPersistenceHelper

Public NotInheritable Class ListViewPersistenceHelper

继承

Object Platform::Object IInspectable ListViewPersistenceHelper

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

有关完整实现，请参阅 ListView 和 GridView 示例存储库中的 [还原滚动位置示例]。https://github.com/microsoft/Windows-universal-samples/blob/main/Samples/XamlListView/cs/Scenario5_RestoreScrollPosition.xaml.cs)

注解

如果 ItemsStackPanel.ItemsUpdatingScrollMode 属性设置为 KeepItemsInView，ListViewPersistenceHelper 将尝试使用第一个可见项的键还原滚动位置。 如果 ItemsUpdatingScrollMode 为 KeepLastItemInView，它将尝试使用最后一个可见项的键还原滚动位置。

方法

GetRelativeScrollPosition(ListViewBase, ListViewItemToKeyHandler)	检索 ListView 的相对滚动位置。
SetRelativeScrollPositionAsync(ListViewBase, String, ListViewKeyToItemHandler)	开始异步操作以设置 ListView 的相对滚动位置。