Android之联系人PinnedHeaderListView使用(转)

2022-04-15 01:05:21

Android联系人中联系人列表页的ListView做得用户体验非常好的，于是想把它从源码中提取出来，以便日后使用。写了一个简单的例子，一方面算是给自己备忘，另一方面跟大家分享一下。

好了，先来看看效果图：

Android之联系人PinnedHeaderListView使用(转)


向上挤压的动画

Android之联系人PinnedHeaderListView使用(转)



选择右边的导航栏

Android之联系人PinnedHeaderListView使用(转)



好了，废话不多说，直接上代码

 PinnedHeaderListView.java

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
package com.example.pinnedheaderlistviewdemo.view; 
   
import android.content.Context; 
import android.graphics.Canvas; 
import android.util.AttributeSet; 
import android.view.View; 
import android.widget.ListAdapter; 
import android.widget.ListView; 
   
/**
 * A ListView that maintains a header pinned at the top of the list. The
 * pinned header can be pushed up and dissolved as needed.
 */ 
public class PinnedHeaderListView extends ListView { 
   
    /**
     * Adapter interface.  The list adapter must implement this interface.
     */ 
    public interface PinnedHeaderAdapter { 
   
        /**
         * Pinned header state: don‘t show the header.
         */ 
        public static final int PINNED_HEADER_GONE = 0; 
   
        /**
         * Pinned header state: show the header at the top of the list.
         */ 
        public static final int PINNED_HEADER_VISIBLE = 1; 
   
        /**
         * Pinned header state: show the header. If the header extends beyond
         * the bottom of the first shown element, push it up and clip.
         */ 
        public static final int PINNED_HEADER_PUSHED_UP = 2; 
   
        /**
         * Computes the desired state of the pinned header for the given
         * position of the first visible list item. Allowed return values are
         * {@link #PINNED_HEADER_GONE}, {@link #PINNED_HEADER_VISIBLE} or
         * {@link #PINNED_HEADER_PUSHED_UP}.
         */ 
        int getPinnedHeaderState(int position); 
   
        /**
         * Configures the pinned header view to match the first visible list item.
         *
         * @param header pinned header view.
         * @param position position of the first visible list item.
         * @param alpha fading of the header view, between 0 and 255.
         */ 
        void configurePinnedHeader(View header, int position, int alpha); 
    } 
   
    private static final int MAX_ALPHA = 255; 
   
    private PinnedHeaderAdapter mAdapter; 
    private View mHeaderView; 
    private boolean mHeaderViewVisible; 
   
    private int mHeaderViewWidth; 
   
    private int mHeaderViewHeight; 
   
    public PinnedHeaderListView(Context context) { 
        super(context); 
    } 
   
    public PinnedHeaderListView(Context context, AttributeSet attrs) { 
        super(context, attrs); 
    } 
   
    public PinnedHeaderListView(Context context, AttributeSet attrs, int defStyle) { 
        super(context, attrs, defStyle); 
    } 
   
    public void setPinnedHeaderView(View view) { 
        mHeaderView = view; 
   
        // Disable vertical fading when the pinned header is present 
        // TODO change ListView to allow separate measures for top and bottom fading edge; 
        // in this particular case we would like to disable the top, but not the bottom edge. 
        if (mHeaderView != null) { 
            setFadingEdgeLength(0); 
        } 
        requestLayout(); 
    } 
   
    @Override 
    public void setAdapter(ListAdapter adapter) { 
        super.setAdapter(adapter); 
        mAdapter = (PinnedHeaderAdapter)adapter; 
    } 
   
    @Override 
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
        super.onMeasure(widthMeasureSpec, heightMeasureSpec); 
        if (mHeaderView != null) { 
            measureChild(mHeaderView, widthMeasureSpec, heightMeasureSpec); 
            mHeaderViewWidth = mHeaderView.getMeasuredWidth(); 
            mHeaderViewHeight = mHeaderView.getMeasuredHeight(); 
        } 
    } 
   
    @Override 
    protected void onLayout(boolean changed, int left, int top, int right, int bottom) { 
        super.onLayout(changed, left, top, right, bottom); 
        if (mHeaderView != null) { 
            mHeaderView.layout(0, 0, mHeaderViewWidth, mHeaderViewHeight); 
            configureHeaderView(getFirstVisiblePosition()); 
        } 
    } 
   
    public void configureHeaderView(int position) { 
        if (mHeaderView == null) { 
            return; 
        } 
   
        int state = mAdapter.getPinnedHeaderState(position); 
        switch (state) { 
            case PinnedHeaderAdapter.PINNED_HEADER_GONE: { 
                mHeaderViewVisible = false; 
                break; 
            } 
   
            case PinnedHeaderAdapter.PINNED_HEADER_VISIBLE: { 
                mAdapter.configurePinnedHeader(mHeaderView, position, MAX_ALPHA); 
                if (mHeaderView.getTop() != 0) { 
                    mHeaderView.layout(0, 0, mHeaderViewWidth, mHeaderViewHeight); 
                } 
                mHeaderViewVisible = true; 
                break; 
            } 
   
            case PinnedHeaderAdapter.PINNED_HEADER_PUSHED_UP: { 
                View firstView = getChildAt(0); 
                int bottom = firstView.getBottom(); 
                int itemHeight = firstView.getHeight(); 
                int headerHeight = mHeaderView.getHeight(); 
                int y; 
                int alpha; 
                if (bottom < headerHeight) { 
                    y = (bottom - headerHeight); 
                    alpha = MAX_ALPHA * (headerHeight + y) / headerHeight; 
                } else { 
                    y = 0; 
                    alpha = MAX_ALPHA; 
                } 
                mAdapter.configurePinnedHeader(mHeaderView, position, alpha); 
                if (mHeaderView.getTop() != y) { 
                    mHeaderView.layout(0, y, mHeaderViewWidth, mHeaderViewHeight + y); 
                } 
                mHeaderViewVisible = true; 
                break; 
            } 
        } 
    } 
   
    @Override 
    protected void dispatchDraw(Canvas canvas) { 
        super.dispatchDraw(canvas); 
        if (mHeaderViewVisible) { 
            drawChild(canvas, mHeaderView, getDrawingTime()); 
        } 
    } 
} 

 MySectionIndexer.java

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
package com.example.pinnedheaderlistviewdemo; 
   
import java.util.Arrays; 
   
import android.util.Log; 
import android.widget.SectionIndexer; 
   
public class MySectionIndexer implements SectionIndexer{ 
    private final String[] mSections;// 
    private final int[] mPositions; 
    private final int mCount; 
       
    /**
     * @param sections
     * @param counts
     */ 
    public MySectionIndexer(String[] sections, int[] counts) { 
        if (sections == null || counts == null) { 
            throw new NullPointerException(); 
        } 
        if (sections.length != counts.length) { 
            throw new IllegalArgumentException( 
                    "The sections and counts arrays must have the same length"); 
        } 
        this.mSections = sections; 
        mPositions = new int[counts.length]; 
        int position = 0; 
        for (int i = 0; i < counts.length; i++) { 
            if(mSections[i] == null) { 
                mSections[i] = ""; 
            } else { 
                mSections[i] = mSections[i].trim();  
            } 
               
            mPositions[i] = position; 
            position += counts[i]; 
               
            Log.i("MySectionIndexer", "counts["+i+"]:"+counts[i]); 
        } 
        mCount = position; 
    } 
       
    @Override 
    public Object[] getSections() { 
        // TODO Auto-generated method stub 
        return mSections; 
    } 
   
    @Override 
    public int getPositionForSection(int section) { 
        //change by lcq 2012-10-12 section > mSections.length以为>=  
        if (section < 0 || section >= mSections.length) { 
            return -1; 
        } 
        return mPositions[section]; 
    } 
   
    @Override 
    public int getSectionForPosition(int position) { 
        if (position < 0 || position >= mCount) { 
            return -1; 
        } 
        //注意这个方法的返回值，它就是index<0时，返回-index-2的原因 
        //解释Arrays.binarySearch，如果搜索结果在数组中，刚返回它在数组中的索引，如果不在，刚返回第一个比它大的索引的负数-1 
        //如果没弄明白，请自己想查看api 
        int index = Arrays.binarySearch(mPositions, position); 
        return index >= 0 ? index : -index - 2; //当index小于0时，返回-index-2， 
           
    } 
   
} 

 CityListAdapter.java

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
package com.example.pinnedheaderlistviewdemo.adapter; 
   
import java.util.List; 
   
import android.content.Context; 
import android.view.LayoutInflater; 
import android.view.View; 
import android.view.ViewGroup; 
import android.widget.AbsListView; 
import android.widget.AbsListView.OnScrollListener; 
import android.widget.BaseAdapter; 
import android.widget.TextView; 
   
import com.example.pinnedheaderlistviewdemo.City; 
import com.example.pinnedheaderlistviewdemo.MySectionIndexer; 
import com.example.pinnedheaderlistviewdemo.R; 
import com.example.pinnedheaderlistviewdemo.view.PinnedHeaderListView; 
import com.example.pinnedheaderlistviewdemo.view.PinnedHeaderListView.PinnedHeaderAdapter; 
   
public class CityListAdapter extends BaseAdapter implements 
        PinnedHeaderAdapter, OnScrollListener { 
    private List<City> mList; 
    private MySectionIndexer mIndexer; 
    private Context mContext; 
    private int mLocationPosition = -1; 
    private LayoutInflater mInflater; 
   
    public CityListAdapter(List<City> mList, MySectionIndexer mIndexer, 
            Context mContext) { 
        this.mList = mList; 
        this.mIndexer = mIndexer; 
        this.mContext = mContext; 
        mInflater = LayoutInflater.from(mContext); 
    } 
   
    @Override 
    public int getCount() { 
        // TODO Auto-generated method stub 
        return mList == null ? 0 : mList.size(); 
    } 
   
    @Override 
    public Object getItem(int position) { 
        // TODO Auto-generated method stub 
        return mList.get(position); 
    } 
   
    @Override 
    public long getItemId(int position) { 
        // TODO Auto-generated method stub 
        return position; 
    } 
   
    @Override 
    public View getView(int position, View convertView, ViewGroup parent) { 
        View view; 
        ViewHolder holder; 
        if (convertView == null) { 
            view = mInflater.inflate(R.layout.select_city_item, null); 
   
            holder = new ViewHolder(); 
            holder.group_title = (TextView) view.findViewById(R.id.group_title); 
            holder.city_name = (TextView) view.findViewById(R.id.city_name); 
   
            view.setTag(holder); 
        } else { 
            view = convertView; 
            holder = (ViewHolder) view.getTag(); 
        } 
           
        City city = mList.get(position); 
           
        int section = mIndexer.getSectionForPosition(position); 
        if (mIndexer.getPositionForSection(section) == position) { 
            holder.group_title.setVisibility(View.VISIBLE); 
            holder.group_title.setText(city.getSortKey()); 
        } else { 
            holder.group_title.setVisibility(View.GONE); 
        } 
           
        holder.city_name.setText(city.getName()); 
   
        return view; 
    } 
   
    public static class ViewHolder { 
        public TextView group_title; 
        public TextView city_name; 
    } 
   
    @Override 
    public int getPinnedHeaderState(int position) { 
        int realPosition = position; 
        if (realPosition < 0 
                || (mLocationPosition != -1 && mLocationPosition == realPosition)) { 
            return PINNED_HEADER_GONE; 
        } 
        mLocationPosition = -1; 
        int section = mIndexer.getSectionForPosition(realPosition); 
        int nextSectionPosition = mIndexer.getPositionForSection(section + 1); 
        if (nextSectionPosition != -1 
                && realPosition == nextSectionPosition - 1) { 
            return PINNED_HEADER_PUSHED_UP; 
        } 
        return PINNED_HEADER_VISIBLE; 
    } 
   
    @Override 
    public void configurePinnedHeader(View header, int position, int alpha) { 
        // TODO Auto-generated method stub 
        int realPosition = position; 
        int section = mIndexer.getSectionForPosition(realPosition); 
        String title = (String) mIndexer.getSections()[section]; 
        ((TextView) header.findViewById(R.id.group_title)).setText(title); 
    } 
   
    @Override 
    public void onScrollStateChanged(AbsListView view, int scrollState) { 
        // TODO Auto-generated method stub 
   
    } 
   
    @Override 
    public void onScroll(AbsListView view, int firstVisibleItem, 
            int visibleItemCount, int totalItemCount) { 
        // TODO Auto-generated method stub 
        if (view instanceof PinnedHeaderListView) { 
            ((PinnedHeaderListView) view).configureHeaderView(firstVisibleItem); 
        } 
   
    } 
} 

 select_city_item.xml

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:orientation="vertical" > 
   
    <TextView 
        android:id="@+id/group_title" 
        android:layout_width="fill_parent" 
        android:layout_height="wrap_content" 
        android:background="@color/gray" 
        android:gravity="left|center" 
        android:paddingBottom="5.0dip" 
        android:paddingLeft="@dimen/selectcity_group_item_padding" 
        android:paddingRight="@dimen/selectcity_group_item_padding" 
        android:paddingTop="5.0dip" 
        android:text="S" 
        android:textColor="@color/white" 
        android:textStyle="bold" /> 
   
    <TextView 
        android:id="@+id/city_name" 
        android:layout_width="fill_parent" 
        android:layout_height="wrap_content" 
        android:gravity="center_vertical" 
        android:minHeight="40.0dip" 
        android:paddingLeft="@dimen/selectcity_group_item_padding" 
        android:text="深圳" 
        android:textColor="@color/black" 
        android:textSize="15sp" /> 
   
</LinearLayout> 

 主界面布局文件 activity_main.xml

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    xmlns:tools="http://schemas.android.com/tools" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    tools:context=".MainActivity" > 
   
    <com.example.pinnedheaderlistviewdemo.view.PinnedHeaderListView 
        android:id="@+id/mListView" 
        android:layout_width="fill_parent" 
        android:layout_height="fill_parent" 
        android:cacheColorHint="@android:color/transparent" 
        android:footerDividersEnabled="false" 
        android:headerDividersEnabled="false" /> 
   
    <com.example.pinnedheaderlistviewdemo.view.BladeView 
        android:id="@+id/mLetterListView" 
        android:layout_width="30dp" 
        android:layout_height="fill_parent" 
        android:layout_alignParentRight="true" 
        android:background="#00000000" /> 
   
</RelativeLayout> 

 MainActivity.java

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
package com.example.pinnedheaderlistviewdemo; 
   
import java.io.File; 
import java.io.FileOutputStream; 
import java.io.InputStream; 
import java.util.ArrayList; 
import java.util.Collections; 
import java.util.Comparator; 
import java.util.List; 
   
import android.app.Activity; 
import android.os.Bundle; 
import android.os.Environment; 
import android.os.Handler; 
import android.util.Log; 
import android.view.LayoutInflater; 
   
import com.example.pinnedheaderlistviewdemo.adapter.CityListAdapter; 
import com.example.pinnedheaderlistviewdemo.db.CityDao; 
import com.example.pinnedheaderlistviewdemo.db.DBHelper; 
import com.example.pinnedheaderlistviewdemo.view.BladeView; 
import com.example.pinnedheaderlistviewdemo.view.BladeView.OnItemClickListener; 
import com.example.pinnedheaderlistviewdemo.view.PinnedHeaderListView; 
   
public class MainActivity extends Activity { 
       
    private static final int COPY_DB_SUCCESS = 10; 
    private static final int COPY_DB_FAILED = 11; 
    protected static final int QUERY_CITY_FINISH = 12; 
    private MySectionIndexer mIndexer; 
       
    private List<City> cityList = new ArrayList<City>(); 
    public static String APP_DIR = Environment.getExternalStorageDirectory().getAbsolutePath() + "/test/"; 
    private Handler handler = new Handler(){ 
   
        public void handleMessage(android.os.Message msg) { 
            switch (msg.what) { 
            case QUERY_CITY_FINISH: 
                   
                if(mAdapter==null){ 
                       
                    mIndexer = new MySectionIndexer(sections, counts); 
                       
                    mAdapter = new CityListAdapter(cityList, mIndexer, getApplicationContext()); 
                    mListView.setAdapter(mAdapter); 
                       
                    mListView.setOnScrollListener(mAdapter); 
                       
                    //設置頂部固定頭部 
                    mListView.setPinnedHeaderView(LayoutInflater.from(getApplicationContext()).inflate(   
                            R.layout.list_group_item, mListView, false));   
                       
                }else if(mAdapter!=null){ 
                    mAdapter.notifyDataSetChanged(); 
                } 
                   
                break; 
   
            case COPY_DB_SUCCESS: 
                requestData(); 
                break; 
            default: 
                break; 
            } 
        }; 
    }; 
    private DBHelper helper; 
   
    private CityListAdapter mAdapter; 
    private static final String ALL_CHARACTER = "#ABCDEFGHIJKLMNOPQRSTUVWXYZ" ; 
    protected static final String TAG = null; 
       
    private String[] sections = { "#", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", 
            "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", 
            "Y", "Z" }; 
    private int[] counts; 
    private PinnedHeaderListView mListView; 
       
    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main); 
           
        helper = new DBHelper(); 
           
        copyDBFile(); 
        findView(); 
    } 
   
    private void copyDBFile() { 
           
        File file = new File(APP_DIR+"/city.db"); 
        if(file.exists()){ 
            requestData(); 
               
        }else{  //拷贝文件 
            Runnable task = new Runnable() { 
                   
                @Override 
                public void run() { 
                       
                    copyAssetsFile2SDCard("city.db"); 
                } 
            }; 
               
            new Thread(task).start(); 
        } 
    } 
       
    /**
     * 拷贝资产目录下的文件到 手机
     */ 
    private void copyAssetsFile2SDCard(String fileName) { 
           
        File desDir = new File(APP_DIR); 
        if (!desDir.exists()) { 
            desDir.mkdirs(); 
        } 
   
        // 拷贝文件 
        File file = new File(APP_DIR + fileName); 
        if (file.exists()) { 
            file.delete(); 
        } 
   
        try { 
            InputStream in = getAssets().open(fileName); 
   
            FileOutputStream fos = new FileOutputStream(file); 
   
            int len = -1; 
            byte[] buf = new byte[1024]; 
            while ((len = in.read(buf)) > 0) { 
                fos.write(buf, 0, len); 
            } 
   
            fos.flush(); 
            fos.close(); 
               
            handler.sendEmptyMessage(COPY_DB_SUCCESS); 
        } catch (Exception e) { 
            e.printStackTrace(); 
            handler.sendEmptyMessage(COPY_DB_FAILED); 
        } 
    } 
   
    private void requestData() { 
           
        Runnable task = new Runnable() { 
               
            @Override 
            public void run() { 
                CityDao dao = new CityDao(helper); 
                   
                List<City> hot = dao.getHotCities();  //热门城市 
                List<City> all = dao.getAllCities();  //全部城市 
                   
                if(all!=null){ 
                       
                    Collections.sort(all, new MyComparator());  //排序 
                       
                    cityList.addAll(hot); 
                    cityList.addAll(all); 
                       
                    //初始化每个字母有多少个item 
                    counts = new int[sections.length]; 
                       
                    counts[0] = hot.size(); //热门城市 个数 
                       
                    for(City city : all){   //计算全部城市 
                           
                        String firstCharacter = city.getSortKey(); 
                        int index = ALL_CHARACTER.indexOf(firstCharacter); 
                        counts[index]++; 
                    } 
                       
                    handler.sendEmptyMessage(QUERY_CITY_FINISH); 
                } 
            } 
        }; 
           
        new Thread(task).start(); 
    } 
       
    public class MyComparator implements Comparator<City> { 
   
        @Override 
        public int compare(City c1, City c2) { 
   
            return c1.getSortKey().compareTo(c2.getSortKey()); 
        } 
   
    } 
   
    private void findView() { 
           
        mListView = (PinnedHeaderListView) findViewById(R.id.mListView); 
        BladeView mLetterListView = (BladeView) findViewById(R.id.mLetterListView); 
           
        mLetterListView.setOnItemClickListener(new OnItemClickListener() { 
               
            @Override 
            public void onItemClick(String s) { 
                if(s!=null){ 
                       
                    int section = ALL_CHARACTER.indexOf(s); 
                       
                    int position = mIndexer.getPositionForSection(section); 
                       
                    Log.i(TAG, "s:"+s+",section:"+section+",position:"+position); 
                       
                    if(position!=-1){ 
                        mListView.setSelection(position); 
                    }else{ 
                           
                    } 
                } 
                   
            } 
        }); 
    } 
   
} 

 

OK，就这么多了，另附工程源码下载地址：http://download.csdn.net/detail/fx_sky/5995355

Android之联系人PinnedHeaderListView使用(转)

上一篇：一些 android 项目


下一篇：Android语音合成与语音识别