原文:

简介

我们最近实现了一个在UWP中使用的下拉刷新功能，以满足用户的需求，因为这是下拉刷新是一种常见的操作方式，而UWP本身并不提供这一机制。

通过下拉刷新这一机制，可以让移动端的界面设计变得更加简单，更符合广大用户的使用习惯。

 

NEW github链接：

该组件的nuget链接：

 

并且，我们实现的这一下拉刷新功能，具有以下优点：

• 支持自定义下拉头部，包括及时显示下拉进度，分辨率较高。
• 用于ListView时，支持UI虚拟化和增量加载，不影响诸如ListView.Header等属性。

 

基本使用

使用效果如图：

只需要简单的：

这是默认的效果。用户只需要订阅 RefreshInvoked 事件即可。

该事件类型为：TypedEventHandler<DependencyObject, object>，第一个参数sender为PullToRefreshBox的Content，第二个参数总是null。

 

更多设置

我们的下拉刷新控件提供更多设置可供开发者自定义其表现。

• double RefreshThreshold {get;set;} ：设置触发刷新的阈值，即有效下拉距离。
• DataTemplate TopIndicatorTemplate {get;set;} ：自定义下拉头部模板。这是一个DataTemplate，其DataContext只是一个double值，表示相对于下拉阈值的百分比（可以超过100%）。而该模板本身会决定可用的下拉大小。

 同时，我们还提供了一个PullRefreshProgressControl控件，方便开发者进行简单的头部定制。

该控件提供两个VisualState：Normal和ReleaseToRefresh，表示下拉过程中的两种状态（未到达刷新阈值，和已到达阈值）。

通过定义PullRefreshProgressControl.Template可以使用它（同样也要设定一下PullToRefreshBox.TopIndicatorTemplate，并且对PullRefreshProgressControl.Progress属性进行绑定）。

 

接下来为大家展示一下简单的定制效果：

相关代码如下：

 

如果想要更加复杂的效果，则需要完全自定义PullToRefreshBox.TopIndicatorTemplate。

 

实现原理

采用外部嵌套ScrollViewer的方式实现。同时监控ScrollViewer的大小变化，以调整Content（即PullToRefreshBox.Content）的大小。

同时在下拉发生后，通过DirectManipulationCompleted事件，确定松开手指的时刻，并将下拉头部滚出ScrollViewer的可视区域。

在ScrollViewer.ViewChanged事件中计算下拉距离，以实现分辨率较高的进度绑定。

 

已知问题

• 用于StackPanel，Canvas这类有无限大空间的控件 且不指定PullToRefreshBox的具体大小时，其大小会恒定不变，而不会随Content大小变化而变化。

 

该组件的nuget链接：

如果大家在使用中遇到了什么问题，希望能向我们反馈，以使得我们的实现变得更好。 

 

感谢  提出的意见！