关于ListView的setSelection的使用

作者: 客家小罗 | 来源:发表于2018-03-03 14:26 被阅读192次

    setSelection不起作用

    在使用ListView过程中,经常需要调用ListView的setSelection让其滚动到顶部或者底部。但是发现如果setSelection和notifyDataSetChanged结合使用的话,setSelection有时候会不起作用。比如以下代码:

    private ListView mListView;
    private Adapter mAdapter;
    ......
    private void onClick(View v) {
        //将列表滚动到列表最底部
        mListView.setSelectionTop(mAdapter.getCount() - 1);
        //其他业务代码更新了数据
        .......
        //调用notifyDataSetChanged刷新列表
        mAdapter.notifyDataSetChanged()
      }
    

    但是如果将setSelectionTop和notifySetChanged调换下位置,确能正常滚动:

    private ListView mListView;
    private Adapter mAdapter;
    ......
    private void onClick(View v) {
        //其他业务代码更新了数据
        .......
        //调用notifyDataSetChanged刷新列表
        mAdapter.notifyDataSetChanged()
        //将列表滚动到列表最底部
        mListView.setSelectionTop(mAdapter.getCount() - 1);
    }
    

    为了搞清楚这个问题,专门研究了ListView源代码,接下来结合源代码来研究下这个问题的真正原因。

    setSelection源码分析

    public void setSelection(int position) {
        setSelectionFromTop(position, 0);
    }
    

    setSelection的代码比较简单,只是对setSelectionFromTop的转调,真正的代码逻辑在setSelectionTop。

    public void setSelectionFromTop(int position, int y) {
        if (mAdapter == null) {
            return;
        }
    
        //手机基本是触摸模式,所以执行的是else分支
        if (!isInTouchMode()) {
            position = lookForSelectablePosition(position, true);
            if (position >= 0) {
                setNextSelectedPositionInt(position);
            }
        } else {
            //保持需要定位到的位置
            mResurrectToPosition = position;
        }
    
        if (position >= 0) {
            //设置布局模式,接下来我们将看到这个布局模式是怎么起作用
            mLayoutMode = LAYOUT_SPECIFIC;
            //选择的item距列表顶部的偏移
            mSpecificTop = mListPadding.top + y;
    
            //mNeedSync在调用了notifySetDataChanged后会被设置为true
            if (mNeedSync) {
                mSyncPosition = position;
                mSyncRowId = mAdapter.getItemId(position);
            }
    
            if (mPositionScroller != null) {
                mPositionScroller.stop();
            }
            
            //请求布局
            requestLayout();
        }
    }
    

    从setSelectionFromTop中可以看出,该方法的核心代码只是记录列表需要重新定位到哪个item,以及这个item距离列表顶端的偏移。那么记录下的这几个字段是在哪里使用的?接下来将进入ListView的layouChildren,我们看下mLayoutMode、mResurrectToPosition等字段是如何使得列表定位到我们想要的位置的。

    protected void layoutChildren() {
    ......
    //根据mLayoutMode对ListView的item进行布局
    switch (mLayoutMode) {
        case LAYOUT_SET_SELECTION:
            if (newSel != null) {
                sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
            } else {
                sel = fillFromMiddle(childrenTop, childrenBottom);
            }
            break;
        case LAYOUT_SYNC:
            sel = fillSpecific(mSyncPosition, mSpecificTop);
            break;
        case LAYOUT_FORCE_BOTTOM:
            sel = fillUp(mItemCount - 1, childrenBottom);
            adjustViewsUpOrDown();
            break;
        case LAYOUT_FORCE_TOP:
            mFirstPosition = 0;
            sel = fillFromTop(childrenTop);
            adjustViewsUpOrDown();
            break;
        case LAYOUT_SPECIFIC:
            //调用了setSelection后,进入这个布局模式
            sel = fillSpecific(reconcileSelectedPosition(), mSpecificTop);
            break;
        case LAYOUT_MOVE_SELECTION:
            sel = moveSelection(oldSel, newSel, delta, childrenTop, childrenBottom);
            break;
        default:
            if (childCount == 0) {
                if (!mStackFromBottom) {
                    final int position = lookForSelectablePosition(0, true);
                    setSelectedPositionInt(position);
                    sel = fillFromTop(childrenTop);
                } else {
                    final int position = lookForSelectablePosition(mItemCount - 1, false);
                    setSelectedPositionInt(position);
                    sel = fillUp(mItemCount - 1, childrenBottom);
                }
            } else {
                if (mSelectedPosition >= 0 && mSelectedPosition < mItemCount) {
                    sel = fillSpecific(mSelectedPosition,
                            oldSel == null ? childrenTop : oldSel.getTop());
                } else if (mFirstPosition < mItemCount) {
                    sel = fillSpecific(mFirstPosition,
                            oldFirst == null ? childrenTop : oldFirst.getTop());
                } else {
                    sel = fillSpecific(0, childrenTop);
                }
            }
            break;
    }
    ......
    }
    

    layoutChildren是ListView的核心方法,主要工作根据mLayoutMode是实现对子item的布局。当我们调用setSelection后,mLayoutOut的值是LAYOUT_SPECIFIC,那么通过以上代码,我们看到,ListView将通过调用fillSpecific方法填充。调用fillSpecific调用了reconcileSelectedPosition来确定定位的item位置,以及使用直接mSpecificTop来定位第一个可见item的偏移。

    int reconcileSelectedPosition() {
        //mSelectedPosition表示选中的item,由于我们并没有去选中item,所以mSelectedPostion值为-1
        int position = mSelectedPosition;
        //mSelectedPosition为-1,position值为我们在setSelection传入的值
        if (position < 0) {
            position = mResurrectToPosition;
        }
        position = Math.max(0, position);
        position = Math.min(position, mItemCount - 1);
        return position;
    }
    

    接下来fillSpecific将以mResurrectToPosition为ListView为第一个可见的item进行布局,填充满整个列表。至于fillSpecific的内部的实现,可以阅读ListView工作原理解析,本文将不再展开。
    分析完setSelection的源码实现,我们再来研究下notifyDataSetChanged。

    notifyDataSetChanged源码分析

    BaseAdapter的notifyDataSetChanged的代码如下所示。

        public void notifyDataSetChanged() {
            mDataSetObservable.notifyChanged();
        }
    

    BaseAdapter通过观察者模式,通知ListView底层数据变化,然后更新视图。ListView的基类AbsListView在onAttachedToWindow方法注册成为adapter的观察者的。

        protected void onAttachedToWindow() {
            super.onAttachedToWindow();
            ......
            if (mAdapter != null && mDataSetObserver == null) {
                mDataSetObserver = new AdapterDataSetObserver();
                mAdapter.registerDataSetObserver(mDataSetObserver);
                ......
            }
        }
    

    注册进Adater的观察者是AbsListView的内部类AdapterDataSetObserver,接下来我们来看下AdapterDataSetObserver是如何处理数据变化通知的。

        class AdapterDataSetObserver extends AdapterView<ListAdapter>.AdapterDataSetObserver {
            @Override
            public void onChanged() {
                super.onChanged();
                if (mFastScroll != null) {
                    mFastScroll.onSectionsChanged();
                }
            }
    
            @Override
            public void onInvalidated() {
                super.onInvalidated();
                if (mFastScroll != null) {
                    mFastScroll.onSectionsChanged();
                }
            }
        }
    

    AdapterDataSetObserver是从AdapterView(AbsListView的父类)的AdapterDataSetObserver派生,只是在父类的基础上添加在数据变化时了对滚动的处理,那么接下来转到AdapterDataSetObserver。

    class AdapterDataSetObserver extends DataSetObserver {
            ......
            @Override
            public void onChanged() {
                //标记数据变化,这个标记很重要,接下来在ListView的layoutChildren将看到这个标记的作用
                mDataChanged = true;
                mOldItemCount = mItemCount;
                mItemCount = getAdapter().getCount();
    
                //一般情况下hasStableIds返回false,所以不会走到if分支的代码
                if (AdapterView.this.getAdapter().hasStableIds() && mInstanceState != null
                        && mOldItemCount == 0 && mItemCount > 0) {
                    AdapterView.this.onRestoreInstanceState(mInstanceState);
                    mInstanceState = null;
                } else {
                    //记录当前列表滚动的位置,为布局后能够恢复到原来的位置
                    rememberSyncState();
                }
                checkFocus();
                requestLayout();
            }
            ......
        }
    
        void rememberSyncState() {
            if (getChildCount() > 0) {
                mNeedSync = true;
                mSyncHeight = mLayoutHeight;
                //当ListView选中了某个item时的处理,没有选中时mSelectedPosition为-1
                if (mSelectedPosition >= 0) {
                    ......
                } else {
                    // 第一个可见的item
                    View v = getChildAt(0);
                    T adapter = getAdapter();
                    //第一个可见的item的id
                    if (mFirstPosition >= 0 && mFirstPosition < adapter.getCount()) {
                        mSyncRowId = adapter.getItemId(mFirstPosition);
                    } else {
                        mSyncRowId = NO_ID;
                    }
                    //记录第一可见item的位置索引
                    mSyncPosition = mFirstPosition;
                    if (v != null) {
                        //第一个可见item的top,因为item有部分滚出列表,所以需要记录下top
                        mSpecificTop = v.getTop();
                    }
                    mSyncMode = SYNC_FIRST_POSITION;
                }
            }
        }
    

    从以上可以代码可以看出,其实调用notifyDataSetChanged,只是通知ListView数据变化,将mDataChanged设置为true,同时调用requestLayout进行布局。调用requestLayout后,会导致layoutChildren的执行。

    protected void layoutChildren() {
        ......
        boolean dataChanged = mDataChanged;
        if (dataChanged) {
            handleDataChanged();
        }
        ......
    }
    

    由于mDataChanged被设置为true,handleDataChanged将被执行。在handleDataChanged中mLayoutMode将被更改为LAYOUT_SYNC,这样接下来布局子View将走到的是LAYOUT_SYNC分支,导致我们的setSelection不起作用:

    protected void layoutChildren() {
        ......
        switch (mLayoutMode) {
            //mLayoutMode被更改为LAYOUT_SYNC,导致不会走这个代码分支,滚动到特定的Item位置
            case LAYOUT_SET_SELECTION:
                if (newSel != null) {
                    sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
                } else {
                    sel = fillFromMiddle(childrenTop, childrenBottom);
                }
                break;
            case LAYOUT_SYNC:
                //mSyncPosition是调用notifyDataSetChanged前显示的第一个Item
                sel = fillSpecific(mSyncPosition, mSpecificTop);
                break;
           ......
        }
        ......
    }
    

    相关文章

      网友评论

        本文标题:关于ListView的setSelection的使用

        本文链接:https://www.haomeiwen.com/subject/hbgpnxtx.html