WindowsPhone下拉刷新控件 - PullRefreshListBox（一）

前言

 

前几天做一个类似微博的项目，想用下Android和Iphone里的下拉刷新控件，WP7里肯定不会有这种控件，只能自己去试着写一写，正好，前几篇文章讲完，讲的是关于自定义控件的，因此，将自己写的WP7下的自定义下拉刷新控件拿出来分析下，作为前几篇文章的总结。如果您觉得不错，请顶一下，要源码的朋友，下面回复跟上邮箱，作者在第一时间发送给你。

 

成果图：

说明：Demo中是用了上下两个的下拉刷新控件，上面的数字下拉刷新控件是将ListBoxItem静态绑定上的，下面的控件通过绑定机制绑定到对象上去的。

图一，二是点击不同的项，都可以得到项索引或项内容。

图三，是当用户下拉列表时，上方显示下拉刷新动画效果和提示文字。

图四，是下拉时，下拉事件打印出的字符串，说明可以回调用户事件方法。

 
 

图一 ListBoxItem静态数据绑定，点击效果

 

 

图二 动态对象数据绑定，点击效果

 

 

图三，下拉时，下拉动画及提示显示效果

 
 

图四，下拉时，下拉事件回调输出

 

本控件主要实现了以下功能：

支持动画效果的下拉刷新
支持动态绑定数据源
支持静态ListBoxItem绑定
支持ListBox自定义ItemTemplate模板
思路分析：

 

基本功能：  

如果想让该控件支持下拉刷新列表，那么就意味在列表的最上部要添加一个Control，在用户没有下拉列表时，该Control不显示，当用户下拉列表到一定的距离时，该Control显示出来，并且有动画效果。

解决Control选择问题
解决用户操作及距离计算问题
动画效果添加
复杂功能：

我们还要让我们的下拉刷新控件支持ListBoxItem的自定义，否则只能显示单一的方式，因此，还要考虑和使用自定义模板的问题，除此之后，还有最重要的一个，当用户下瓣列表时，必需要有一个事件处理，用来回调用户定义方法来刷新数据。

解决ListBoxItem模板自定义问题
解决刷新事件处理问题
为解决上述两部分，本博文分为两节分别介绍，内容不可能太详细，适合有一定基础的朋友，让我们开始吧。

控件类型选择

要实现下拉列表刷新功能，那么控件里必然要有显示数据的列表，根据前面文章 WindowsPhone自定义控件详解（一）/kf/201202/119289.html里分析可知，ListBox列表控件是继承自ItemsControl，那么，我们就的控件肯定也是继承自ItemsControl或ListBox了，但是继承ListBox，通过自定义其Template，不太合适，因为那样无法保证刷新显示区效果，所以我选择继承ItemsControl。

结构如下：

PullRefreshListBox.cs：

[csharp] view plaincopyprint?public class PullRefreshListBox:ItemsControl{ 
 
    public PullRefreshListBox() 
        { 
            this.DefaultStyleKey = typeof(PullRefreshListBox); 
        } 
 
    DependencyProperty SelectedItem{}; 
    DependencyProperty SelectedIndex{}; 
    DependencyProperty RefreshText{}; 
 
    public override void OnApplyTemplate() 
        { 
        ... 
    } 
} 
public class PullRefreshListBox:ItemsControl{

 public PullRefreshListBox()
        {
            this.DefaultStyleKey = typeof(PullRefreshListBox);
        }

 DependencyProperty SelectedItem{};
 DependencyProperty SelectedIndex{};
 DependencyProperty RefreshText{};

  public override void OnApplyTemplate()
        {
  ...
 }
}

其中，加了三个依赖属性：SelectedItem， SelectedIndex， RefreshText，分别表示，当前列表中选择的Item项， 索引值，下拉刷新显示文字。

在OnApplyTemplate里，得到对应的样式文件里的元素引用。

样式模板：

样式模板里主要用来定义下拉刷新控件里的布局，根据前面文章 WindowsPhone自定义控件详解（二）/kf/201202/119313.html中基础可知，修改控件的布局应该是对其Template属性进行自定义。

而在下拉列表上部，要有一个用来装动画图片，以及显示的”正在刷新“等文字的下拉刷新效果区域，我用下图来表示我的布局。

 

 

下拉显示容器和列表显示容器我放到了一个Grid里，上面的下拉容器中又分为左和右 两部分，我用横向布局StackPanel来放置，另外，由于下拉显示容器在默认下是不显示的，设置其隐藏属性，当其显示 时应该在列表容器上面，所以注意它们的顺序。

PullDownPanel：下拉容器StackPanel

RefreshImage：动画图片Image

RefreshTextBlock：提示文字TextBlock

列表容器：ScrollViewer

列表项：ItemsPresenter

对应的样式文件里，结构如下：

Generic.xaml

[html] view plaincopyprint?<Style TargetType="local:PullRefreshListBox"> 
    <Setter Property="Template"> 
    <Setter.Value> 
            <ControlTemplate TargetType="local:PullRefreshListBox"> 
                <Grid> 
                    <ScrollViewer x:Name="ScrollViewer" 
                        <ItemsPresenter x:Name="ItemsPresenter"/> 
                    </ScrollViewer> 
                    <StackPanel x:Name="PullDownPanel" Visibility="Collapsed"  
                        <Image x:Name="RefreshImage" Width="32" Height="32"  
                               Source="/PullRefreshListBox;component/Images/sync.png"> 
                        </Image> 
                        <TextBlock x:Name="RefreshTextBlock" Text="{TemplateBinding RefreshText}"></TextBlock> 
                    </StackPanel> 
                </Grid> 
            </ControlTemplate> 
    </Setter.Value> 
    </Setter> 
</Style> 
    <Style TargetType="local:PullRefreshListBox">
        <Setter Property="Template">
        <Setter.Value>
                <ControlTemplate TargetType="local:PullRefreshListBox">
                    <Grid>
                        <ScrollViewer x:Name="ScrollViewer"
                            <ItemsPresenter x:Name="ItemsPresenter"/>
                        </ScrollViewer>
                        <StackPanel x:Name="PullDownPanel" Visibility="Collapsed"
                            <Image x:Name="RefreshImage" Width="32" Height="32"
                                   Source="/PullRefreshListBox;component/Images/sync.png">
                            </Image>
                            <TextBlock x:Name="RefreshTextBlock" Text="{TemplateBinding RefreshText}"></TextBlock>
                        </StackPanel>
                    </Grid>
                </ControlTemplate>
        </Setter.Value>
        </Setter>
    </Style>
 

样式文件里定义了元素，所以在代码文件PullRefreshListBox.cs中的OnApplyTemplate方法里添加如下代码，用来得到这些元素的引用：

[csharp] view plaincopyprint?// PullDown Panel Container  
PullDownPanel = this.GetTemplateChild("PullDownPanel") as StackPanel; 
RefreshTextBlock = this.GetTemplateChild("RefreshTextBlock") as TextBlock; 
 
// The List ScrollViewer  
ScrollViewer = this.GetTemplateChild("ScrollViewer") as ScrollViewer; 
 
// The List Data items display Presenter  
_ItemsContainer = this.GetTemplateChild(ItemsPresenterName) as ItemsPresenter; 
            // PullDown Panel Container
            PullDownPanel = this.GetTemplateChild("PullDownPanel") as StackPanel;
            RefreshTextBlock = this.GetTemplateChild("RefreshTextBlock") as TextBlock;

            // The List ScrollViewer
            ScrollViewer = this.GetTemplateChild("ScrollViewer") as ScrollViewer;

            // The List Data items display Presenter
            _ItemsContainer = this.GetTemplateChild(ItemsPresenterName) as ItemsPresenter;
 
到了这里，基本结构已经搭完了，还没有剧情，具体的剧情，下篇分解。

 摘自 mr_raptor的专栏