1. /**
2. * The RecycleBin facilitates reuse of views across layouts. The RecycleBin
3. * has two levels of storage: ActiveViews and ScrapViews. ActiveViews are
4. * those views which were onscreen at the start of a layout. By
5. * construction, they are displaying current information. At the end of
6. * layout, all views in ActiveViews are demoted to ScrapViews. ScrapViews
7. * are old views that could potentially be used by the adapter to avoid
8. * allocating views unnecessarily.
9. *
10. * @see android.widget.AbsListView#setRecyclerListener(android.widget.AbsListView.RecyclerListener)
11. * @see android.widget.AbsListView.RecyclerListener
12. */
13. class RecycleBin {
14. private RecyclerListener mRecyclerListener;
15. /**
16. * The position of the first view stored in mActiveViews.
17. */
18. private int mFirstActivePosition;
19. /**
20. * Views that were on screen at the start of layout. This array is
21. * populated at the start of layout, and at the end of layout all view
22. * in mActiveViews are moved to mScrapViews. Views in mActiveViews
23. * represent a contiguous range of Views, with position of the first
24. * view store in mFirstActivePosition.
25. */
26. private View[] mActiveViews = new View[0];
27. /**
28. * Unsorted views that can be used by the adapter as a convert view.
29. */
30. private ArrayList<View>[] mScrapViews;
31. private int mViewTypeCount;
32. private ArrayList<View> mCurrentScrap;
33. /**
34. * Fill ActiveViews with all of the children of the AbsListView.
35. *
36. * @param childCount
37. *            The minimum number of views mActiveViews should hold
38. * @param firstActivePosition
39. *            The position of the first view that will be stored in
40. *            mActiveViews
41. */
42. void fillActiveViews(int childCount, int firstActivePosition) {
43. if (mActiveViews.length < childCount) {
44. mActiveViews = new View[childCount];
45. }
46. mFirstActivePosition = firstActivePosition;
47. final View[] activeViews = mActiveViews;
48. for (int i = 0; i < childCount; i++) {
49. View child = getChildAt(i);
50. AbsListView.LayoutParams lp = (AbsListView.LayoutParams) child.getLayoutParams();
51. // Don't put header or footer views into the scrap heap
52. if (lp != null && lp.viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
53. // Note: We do place AdapterView.ITEM_VIEW_TYPE_IGNORE in
54. // active views.
55. // However, we will NOT place them into scrap views.
56. activeViews[i] = child;
57. }
58. }
59. }
60. /**
61. * Get the view corresponding to the specified position. The view will
62. * be removed from mActiveViews if it is found.
63. *
64. * @param position
65. *            The position to look up in mActiveViews
66. * @return The view if it is found, null otherwise
67. */
68. View getActiveView(int position) {
69. int index = position - mFirstActivePosition;
70. final View[] activeViews = mActiveViews;
71. if (index >= 0 && index < activeViews.length) {
72. final View match = activeViews[index];
73. activeViews[index] = null;
74. return match;
75. }
76. return null;
77. }
78. /**
79. * Put a view into the ScapViews list. These views are unordered.
80. *
81. * @param scrap
82. *            The view to add
83. */
84. void addScrapView(View scrap) {
85. AbsListView.LayoutParams lp = (AbsListView.LayoutParams) scrap.getLayoutParams();
86. if (lp == null) {
87. return;
88. }
89. // Don't put header or footer views or views that should be ignored
90. // into the scrap heap
91. int viewType = lp.viewType;
92. if (!shouldRecycleViewType(viewType)) {
93. if (viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
94. removeDetachedView(scrap, false);
95. }
96. return;
97. }
98. if (mViewTypeCount == 1) {
99. dispatchFinishTemporaryDetach(scrap);
100. mCurrentScrap.add(scrap);
101. } else {
102. dispatchFinishTemporaryDetach(scrap);
103. mScrapViews[viewType].add(scrap);
104. }
105. if (mRecyclerListener != null) {
106. mRecyclerListener.onMovedToScrapHeap(scrap);
107. }
108. }
109. /**
110. * @return A view from the ScrapViews collection. These are unordered.
111. */
112. View getScrapView(int position) {
113. ArrayList<View> scrapViews;
114. if (mViewTypeCount == 1) {
115. scrapViews = mCurrentScrap;
116. int size = scrapViews.size();
117. if (size > 0) {
118. return scrapViews.remove(size - 1);
119. } else {
120. return null;
121. }
122. } else {
123. int whichScrap = mAdapter.getItemViewType(position);
124. if (whichScrap >= 0 && whichScrap < mScrapViews.length) {
125. scrapViews = mScrapViews[whichScrap];
126. int size = scrapViews.size();
127. if (size > 0) {
128. return scrapViews.remove(size - 1);
129. }
130. }
131. }
132. return null;
133. }
134. public void setViewTypeCount(int viewTypeCount) {
135. if (viewTypeCount < 1) {
136. throw new IllegalArgumentException("Can't have a viewTypeCount < 1");
137. }
138. // noinspection unchecked
139. ArrayList<View>[] scrapViews = new ArrayList[viewTypeCount];
140. for (int i = 0; i < viewTypeCount; i++) {
141. scrapViews[i] = new ArrayList<View>();
142. }
143. mViewTypeCount = viewTypeCount;
144. mCurrentScrap = scrapViews[0];
145. mScrapViews = scrapViews;
146. }
147. }

不管怎么说，ListView即使再特殊最终还是继承自View的，因此它的执行流程还将会按照View的规则来执行，对于这方面不太熟悉的朋友可以参考我之前写的 Android视图绘制流程完全解析，带你一步步深入了解View(二) 。

View的执行流程无非就分为三步，onMeasure()用于测量View的大小，onLayout()用于确定View的布局，onDraw()用于将View绘制到界面上。而在ListView当中，onMeasure()并没有什么特殊的地方，因为它终归是一个View，占用的空间最多并且通常也就是整个屏幕。onDraw()在ListView当中也没有什么意义，因为ListView本身并不负责绘制，而是由ListView当中的子元素来进行绘制的。那么ListView大部分的神奇功能其实都是在onLayout()方法中进行的了，因此我们本篇文章也是主要分析的这个方法里的内容。

1. /**
2. * Subclasses should NOT override this method but {@link #layoutChildren()}
3. * instead.
4. */
5. @Override
6. protected void onLayout(boolean changed, int l, int t, int r, int b) {
7. super.onLayout(changed, l, t, r, b);
8. mInLayout = true;
9. if (changed) {
10. int childCount = getChildCount();
11. for (int i = 0; i < childCount; i++) {
12. getChildAt(i).forceLayout();
13. }
14. mRecycler.markChildrenDirty();
15. }
16. layoutChildren();
17. mInLayout = false;
18. }

1. @Override
2. protected void layoutChildren() {
3. final boolean blockLayoutRequests = mBlockLayoutRequests;
4. if (!blockLayoutRequests) {
5. mBlockLayoutRequests = true;
6. } else {
7. return;
8. }
9. try {
10. super.layoutChildren();
11. invalidate();
12. if (mAdapter == null) {
13. resetList();
14. invokeOnItemScrollListener();
15. return;
16. }
17. int childrenTop = mListPadding.top;
18. int childrenBottom = getBottom() - getTop() - mListPadding.bottom;
19. int childCount = getChildCount();
20. int index = 0;
21. int delta = 0;
22. View sel;
23. View oldSel = null;
24. View oldFirst = null;
25. View newSel = null;
26. View focusLayoutRestoreView = null;
27. // Remember stuff we will need down below
28. switch (mLayoutMode) {
29. case LAYOUT_SET_SELECTION:
30. index = mNextSelectedPosition - mFirstPosition;
31. if (index >= 0 && index < childCount) {
32. newSel = getChildAt(index);
33. }
34. break;
35. case LAYOUT_FORCE_TOP:
36. case LAYOUT_FORCE_BOTTOM:
37. case LAYOUT_SPECIFIC:
38. case LAYOUT_SYNC:
39. break;
40. case LAYOUT_MOVE_SELECTION:
41. default:
42. // Remember the previously selected view
43. index = mSelectedPosition - mFirstPosition;
44. if (index >= 0 && index < childCount) {
45. oldSel = getChildAt(index);
46. }
47. // Remember the previous first child
48. oldFirst = getChildAt(0);
49. if (mNextSelectedPosition >= 0) {
50. delta = mNextSelectedPosition - mSelectedPosition;
51. }
52. // Caution: newSel might be null
53. newSel = getChildAt(index + delta);
54. }
55. boolean dataChanged = mDataChanged;
56. if (dataChanged) {
57. handleDataChanged();
58. }
59. // Handle the empty set by removing all views that are visible
60. // and calling it a day
61. if (mItemCount == 0) {
62. resetList();
63. invokeOnItemScrollListener();
64. return;
65. } else if (mItemCount != mAdapter.getCount()) {
66. throw new IllegalStateException("The content of the adapter has changed but "
67. + "ListView did not receive a notification. Make sure the content of "
68. + "your adapter is not modified from a background thread, but only "
69. + "from the UI thread. [in ListView(" + getId() + ", " + getClass()
70. + ") with Adapter(" + mAdapter.getClass() + ")]");
71. }
72. setSelectedPositionInt(mNextSelectedPosition);
73. // Pull all children into the RecycleBin.
74. // These views will be reused if possible
75. final int firstPosition = mFirstPosition;
76. final RecycleBin recycleBin = mRecycler;
77. // reset the focus restoration
78. View focusLayoutRestoreDirectChild = null;
79. // Don't put header or footer views into the Recycler. Those are
80. // already cached in mHeaderViews;
81. if (dataChanged) {
82. for (int i = 0; i < childCount; i++) {
83. recycleBin.addScrapView(getChildAt(i));
84. if (ViewDebug.TRACE_RECYCLER) {
85. ViewDebug.trace(getChildAt(i),
86. ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, index, i);
87. }
88. }
89. } else {
90. recycleBin.fillActiveViews(childCount, firstPosition);
91. }
92. // take focus back to us temporarily to avoid the eventual
93. // call to clear focus when removing the focused child below
94. // from messing things up when ViewRoot assigns focus back
95. // to someone else
96. final View focusedChild = getFocusedChild();
97. if (focusedChild != null) {
98. // TODO: in some cases focusedChild.getParent() == null
99. // we can remember the focused view to restore after relayout if the
100. // data hasn't changed, or if the focused position is a header or footer
101. if (!dataChanged || isDirectChildHeaderOrFooter(focusedChild)) {
102. focusLayoutRestoreDirectChild = focusedChild;
103. // remember the specific view that had focus
104. focusLayoutRestoreView = findFocus();
105. if (focusLayoutRestoreView != null) {
106. // tell it we are going to mess with it
107. focusLayoutRestoreView.onStartTemporaryDetach();
108. }
109. }
110. requestFocus();
111. }
112. // Clear out old views
113. detachAllViewsFromParent();
114. switch (mLayoutMode) {
115. case LAYOUT_SET_SELECTION:
116. if (newSel != null) {
117. sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
118. } else {
119. sel = fillFromMiddle(childrenTop, childrenBottom);
120. }
121. break;
122. case LAYOUT_SYNC:
123. sel = fillSpecific(mSyncPosition, mSpecificTop);
124. break;
125. case LAYOUT_FORCE_BOTTOM:
126. sel = fillUp(mItemCount - 1, childrenBottom);
127. adjustViewsUpOrDown();
128. break;
129. case LAYOUT_FORCE_TOP:
130. mFirstPosition = 0;
131. sel = fillFromTop(childrenTop);
132. adjustViewsUpOrDown();
133. break;
134. case LAYOUT_SPECIFIC:
135. sel = fillSpecific(reconcileSelectedPosition(), mSpecificTop);
136. break;
137. case LAYOUT_MOVE_SELECTION:
138. sel = moveSelection(oldSel, newSel, delta, childrenTop, childrenBottom);
139. break;
140. default:
141. if (childCount == 0) {
142. if (!mStackFromBottom) {
143. final int position = lookForSelectablePosition(0, true);
144. setSelectedPositionInt(position);
145. sel = fillFromTop(childrenTop);
146. } else {
147. final int position = lookForSelectablePosition(mItemCount - 1, false);
148. setSelectedPositionInt(position);
149. sel = fillUp(mItemCount - 1, childrenBottom);
150. }
151. } else {
152. if (mSelectedPosition >= 0 && mSelectedPosition < mItemCount) {
153. sel = fillSpecific(mSelectedPosition,
154. oldSel == null ? childrenTop : oldSel.getTop());
155. } else if (mFirstPosition < mItemCount) {
156. sel = fillSpecific(mFirstPosition,
157. oldFirst == null ? childrenTop : oldFirst.getTop());
158. } else {
159. sel = fillSpecific(0, childrenTop);
160. }
161. }
162. break;
163. }
164. // Flush any cached views that did not get reused above
165. recycleBin.scrapActiveViews();
166. if (sel != null) {
167. // the current selected item should get focus if items
168. // are focusable
169. if (mItemsCanFocus && hasFocus() && !sel.hasFocus()) {
170. final boolean focusWasTaken = (sel == focusLayoutRestoreDirectChild &&
171. focusLayoutRestoreView.requestFocus()) || sel.requestFocus();
172. if (!focusWasTaken) {
173. // selected item didn't take focus, fine, but still want
174. // to make sure something else outside of the selected view
175. // has focus
176. final View focused = getFocusedChild();
177. if (focused != null) {
178. focused.clearFocus();
179. }
180. positionSelector(sel);
181. } else {
182. sel.setSelected(false);
183. mSelectorRect.setEmpty();
184. }
185. } else {
186. positionSelector(sel);
187. }
188. mSelectedTop = sel.getTop();
189. } else {
190. if (mTouchMode > TOUCH_MODE_DOWN && mTouchMode < TOUCH_MODE_SCROLL) {
191. View child = getChildAt(mMotionPosition - mFirstPosition);
192. if (child != null) positionSelector(child);
193. } else {
194. mSelectedTop = 0;
195. mSelectorRect.setEmpty();
196. }
197. // even if there is not selected position, we may need to restore
198. // focus (i.e. something focusable in touch mode)
199. if (hasFocus() && focusLayoutRestoreView != null) {
200. focusLayoutRestoreView.requestFocus();
201. }
202. }
203. // tell focus view we are done mucking with it, if it is still in
204. // our view hierarchy.
205. if (focusLayoutRestoreView != null
206. && focusLayoutRestoreView.getWindowToken() != null) {
207. focusLayoutRestoreView.onFinishTemporaryDetach();
208. }
209. mLayoutMode = LAYOUT_NORMAL;
210. mDataChanged = false;
211. mNeedSync = false;
212. setNextSelectedPositionInt(mSelectedPosition);
213. updateScrollIndicators();
214. if (mItemCount > 0) {
215. checkSelectionChanged();
216. }
217. invokeOnItemScrollListener();
218. } finally {
219. if (!blockLayoutRequests) {
220. mBlockLayoutRequests = false;
221. }
222. }
223. }

1. /**
2. * Fills the list from top to bottom, starting with mFirstPosition
3. *
4. * @param nextTop The location where the top of the first item should be
5. *        drawn
6. *
7. * @return The view that is currently selected
8. */
9. private View fillFromTop(int nextTop) {
10. mFirstPosition = Math.min(mFirstPosition, mSelectedPosition);
11. mFirstPosition = Math.min(mFirstPosition, mItemCount - 1);
12. if (mFirstPosition < 0) {
13. mFirstPosition = 0;
14. }
15. return fillDown(mFirstPosition, nextTop);
16. }

1. /**
2. * Fills the list from pos down to the end of the list view.
3. *
4. * @param pos The first position to put in the list
5. *
6. * @param nextTop The location where the top of the item associated with pos
7. *        should be drawn
8. *
9. * @return The view that is currently selected, if it happens to be in the
10. *         range that we draw.
11. */
12. private View fillDown(int pos, int nextTop) {
13. View selectedView = null;
14. int end = (getBottom() - getTop()) - mListPadding.bottom;
15. while (nextTop < end && pos < mItemCount) {
16. // is this the selected item?
17. boolean selected = pos == mSelectedPosition;
18. View child = makeAndAddView(pos, nextTop, true, mListPadding.left, selected);
19. nextTop = child.getBottom() + mDividerHeight;
20. if (selected) {
21. selectedView = child;
22. }
23. pos++;
24. }
25. return selectedView;
26. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Get a view and have it show the data associated with the specified
3. * position. This is called when we have already discovered that the view is
4. * not available for reuse in the recycle bin. The only choices left are
5. * converting an old view or making a new one.
6. *
7. * @param position
8. *            The position to display
9. * @param isScrap
10. *            Array of at least 1 boolean, the first entry will become true
11. *            if the returned view was taken from the scrap heap, false if
12. *            otherwise.
13. *
14. * @return A view displaying the data associated with the specified position
15. */
16. View obtainView(int position, boolean[] isScrap) {
17. isScrap[0] = false;
18. View scrapView;
19. scrapView = mRecycler.getScrapView(position);
20. View child;
21. if (scrapView != null) {
22. child = mAdapter.getView(position, scrapView, this);
23. if (child != scrapView) {
24. mRecycler.addScrapView(scrapView);
25. if (mCacheColorHint != 0) {
26. child.setDrawingCacheBackgroundColor(mCacheColorHint);
27. }
28. } else {
29. isScrap[0] = true;
30. dispatchFinishTemporaryDetach(child);
31. }
32. } else {
33. child = mAdapter.getView(position, null, this);
34. if (mCacheColorHint != 0) {
35. child.setDrawingCacheBackgroundColor(mCacheColorHint);
36. }
37. }
38. return child;
39. }

1. @Override
2. public View getView(int position, View convertView, ViewGroup parent) {
3. Fruit fruit = getItem(position);
4. View view;
5. if (convertView == null) {
6. view = LayoutInflater.from(getContext()).inflate(resourceId, null);
7. } else {
8. view = convertView;
9. }
10. ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);
11. TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);
12. fruitImage.setImageResource(fruit.getImageId());
13. fruitName.setText(fruit.getName());
14. return view;
15. }

1. /**
2. * Add a view as a child and make sure it is measured (if necessary) and
3. * positioned properly.
4. *
5. * @param child The view to add
6. * @param position The position of this child
7. * @param y The y position relative to which this view will be positioned
8. * @param flowDown If true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @param recycled Has this view been pulled from the recycle bin? If so it
13. *        does not need to be remeasured.
14. */
15. private void setupChild(View child, int position, int y, boolean flowDown, int childrenLeft,
16. boolean selected, boolean recycled) {
17. final boolean isSelected = selected && shouldShowSelector();
18. final boolean updateChildSelected = isSelected != child.isSelected();
19. final int mode = mTouchMode;
20. final boolean isPressed = mode > TOUCH_MODE_DOWN && mode < TOUCH_MODE_SCROLL &&
21. mMotionPosition == position;
22. final boolean updateChildPressed = isPressed != child.isPressed();
23. final boolean needToMeasure = !recycled || updateChildSelected || child.isLayoutRequested();
24. // Respect layout params that are already in the view. Otherwise make some up...
25. // noinspection unchecked
26. AbsListView.LayoutParams p = (AbsListView.LayoutParams) child.getLayoutParams();
27. if (p == null) {
28. p = new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
29. ViewGroup.LayoutParams.WRAP_CONTENT, 0);
30. }
31. p.viewType = mAdapter.getItemViewType(position);
32. if ((recycled && !p.forceAdd) || (p.recycledHeaderFooter &&
33. p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER)) {
34. attachViewToParent(child, flowDown ? -1 : 0, p);
35. } else {
36. p.forceAdd = false;
37. if (p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
38. p.recycledHeaderFooter = true;
39. }
40. addViewInLayout(child, flowDown ? -1 : 0, p, true);
41. }
42. if (updateChildSelected) {
43. child.setSelected(isSelected);
44. }
45. if (updateChildPressed) {
46. child.setPressed(isPressed);
47. }
48. if (needToMeasure) {
49. int childWidthSpec = ViewGroup.getChildMeasureSpec(mWidthMeasureSpec,
50. mListPadding.left + mListPadding.right, p.width);
51. int lpHeight = p.height;
52. int childHeightSpec;
53. if (lpHeight > 0) {
54. childHeightSpec = MeasureSpec.makeMeasureSpec(lpHeight, MeasureSpec.EXACTLY);
55. } else {
56. childHeightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED);
57. }
58. child.measure(childWidthSpec, childHeightSpec);
59. } else {
60. cleanupLayoutState(child);
61. }
62. final int w = child.getMeasuredWidth();
63. final int h = child.getMeasuredHeight();
64. final int childTop = flowDown ? y : y - h;
65. if (needToMeasure) {
66. final int childRight = childrenLeft + w;
67. final int childBottom = childTop + h;
68. child.layout(childrenLeft, childTop, childRight, childBottom);
69. } else {
70. child.offsetLeftAndRight(childrenLeft - child.getLeft());
71. child.offsetTopAndBottom(childTop - child.getTop());
72. }
73. if (mCachingStarted && !child.isDrawingCacheEnabled()) {
74. child.setDrawingCacheEnabled(true);
75. }
76. }

1. @Override
2. protected void layoutChildren() {
3. final boolean blockLayoutRequests = mBlockLayoutRequests;
4. if (!blockLayoutRequests) {
5. mBlockLayoutRequests = true;
6. } else {
7. return;
8. }
9. try {
10. super.layoutChildren();
11. invalidate();
12. if (mAdapter == null) {
13. resetList();
14. invokeOnItemScrollListener();
15. return;
16. }
17. int childrenTop = mListPadding.top;
18. int childrenBottom = getBottom() - getTop() - mListPadding.bottom;
19. int childCount = getChildCount();
20. int index = 0;
21. int delta = 0;
22. View sel;
23. View oldSel = null;
24. View oldFirst = null;
25. View newSel = null;
26. View focusLayoutRestoreView = null;
27. // Remember stuff we will need down below
28. switch (mLayoutMode) {
29. case LAYOUT_SET_SELECTION:
30. index = mNextSelectedPosition - mFirstPosition;
31. if (index >= 0 && index < childCount) {
32. newSel = getChildAt(index);
33. }
34. break;
35. case LAYOUT_FORCE_TOP:
36. case LAYOUT_FORCE_BOTTOM:
37. case LAYOUT_SPECIFIC:
38. case LAYOUT_SYNC:
39. break;
40. case LAYOUT_MOVE_SELECTION:
41. default:
42. // Remember the previously selected view
43. index = mSelectedPosition - mFirstPosition;
44. if (index >= 0 && index < childCount) {
45. oldSel = getChildAt(index);
46. }
47. // Remember the previous first child
48. oldFirst = getChildAt(0);
49. if (mNextSelectedPosition >= 0) {
50. delta = mNextSelectedPosition - mSelectedPosition;
51. }
52. // Caution: newSel might be null
53. newSel = getChildAt(index + delta);
54. }
55. boolean dataChanged = mDataChanged;
56. if (dataChanged) {
57. handleDataChanged();
58. }
59. // Handle the empty set by removing all views that are visible
60. // and calling it a day
61. if (mItemCount == 0) {
62. resetList();
63. invokeOnItemScrollListener();
64. return;
65. } else if (mItemCount != mAdapter.getCount()) {
66. throw new IllegalStateException("The content of the adapter has changed but "
67. + "ListView did not receive a notification. Make sure the content of "
68. + "your adapter is not modified from a background thread, but only "
69. + "from the UI thread. [in ListView(" + getId() + ", " + getClass()
70. + ") with Adapter(" + mAdapter.getClass() + ")]");
71. }
72. setSelectedPositionInt(mNextSelectedPosition);
73. // Pull all children into the RecycleBin.
74. // These views will be reused if possible
75. final int firstPosition = mFirstPosition;
76. final RecycleBin recycleBin = mRecycler;
77. // reset the focus restoration
78. View focusLayoutRestoreDirectChild = null;
79. // Don't put header or footer views into the Recycler. Those are
80. // already cached in mHeaderViews;
81. if (dataChanged) {
82. for (int i = 0; i < childCount; i++) {
83. recycleBin.addScrapView(getChildAt(i));
84. if (ViewDebug.TRACE_RECYCLER) {
85. ViewDebug.trace(getChildAt(i),
86. ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, index, i);
87. }
88. }
89. } else {
90. recycleBin.fillActiveViews(childCount, firstPosition);
91. }
92. // take focus back to us temporarily to avoid the eventual
93. // call to clear focus when removing the focused child below
94. // from messing things up when ViewRoot assigns focus back
95. // to someone else
96. final View focusedChild = getFocusedChild();
97. if (focusedChild != null) {
98. // TODO: in some cases focusedChild.getParent() == null
99. // we can remember the focused view to restore after relayout if the
100. // data hasn't changed, or if the focused position is a header or footer
101. if (!dataChanged || isDirectChildHeaderOrFooter(focusedChild)) {
102. focusLayoutRestoreDirectChild = focusedChild;
103. // remember the specific view that had focus
104. focusLayoutRestoreView = findFocus();
105. if (focusLayoutRestoreView != null) {
106. // tell it we are going to mess with it
107. focusLayoutRestoreView.onStartTemporaryDetach();
108. }
109. }
110. requestFocus();
111. }
112. // Clear out old views
113. detachAllViewsFromParent();
114. switch (mLayoutMode) {
115. case LAYOUT_SET_SELECTION:
116. if (newSel != null) {
117. sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
118. } else {
119. sel = fillFromMiddle(childrenTop, childrenBottom);
120. }
121. break;
122. case LAYOUT_SYNC:
123. sel = fillSpecific(mSyncPosition, mSpecificTop);
124. break;
125. case LAYOUT_FORCE_BOTTOM:
126. sel = fillUp(mItemCount - 1, childrenBottom);
127. adjustViewsUpOrDown();
128. break;
129. case LAYOUT_FORCE_TOP:
130. mFirstPosition = 0;
131. sel = fillFromTop(childrenTop);
132. adjustViewsUpOrDown();
133. break;
134. case LAYOUT_SPECIFIC:
135. sel = fillSpecific(reconcileSelectedPosition(), mSpecificTop);
136. break;
137. case LAYOUT_MOVE_SELECTION:
138. sel = moveSelection(oldSel, newSel, delta, childrenTop, childrenBottom);
139. break;
140. default:
141. if (childCount == 0) {
142. if (!mStackFromBottom) {
143. final int position = lookForSelectablePosition(0, true);
144. setSelectedPositionInt(position);
145. sel = fillFromTop(childrenTop);
146. } else {
147. final int position = lookForSelectablePosition(mItemCount - 1, false);
148. setSelectedPositionInt(position);
149. sel = fillUp(mItemCount - 1, childrenBottom);
150. }
151. } else {
152. if (mSelectedPosition >= 0 && mSelectedPosition < mItemCount) {
153. sel = fillSpecific(mSelectedPosition,
154. oldSel == null ? childrenTop : oldSel.getTop());
155. } else if (mFirstPosition < mItemCount) {
156. sel = fillSpecific(mFirstPosition,
157. oldFirst == null ? childrenTop : oldFirst.getTop());
158. } else {
159. sel = fillSpecific(0, childrenTop);
160. }
161. }
162. break;
163. }
164. // Flush any cached views that did not get reused above
165. recycleBin.scrapActiveViews();
166. if (sel != null) {
167. // the current selected item should get focus if items
168. // are focusable
169. if (mItemsCanFocus && hasFocus() && !sel.hasFocus()) {
170. final boolean focusWasTaken = (sel == focusLayoutRestoreDirectChild &&
171. focusLayoutRestoreView.requestFocus()) || sel.requestFocus();
172. if (!focusWasTaken) {
173. // selected item didn't take focus, fine, but still want
174. // to make sure something else outside of the selected view
175. // has focus
176. final View focused = getFocusedChild();
177. if (focused != null) {
178. focused.clearFocus();
179. }
180. positionSelector(sel);
181. } else {
182. sel.setSelected(false);
183. mSelectorRect.setEmpty();
184. }
185. } else {
186. positionSelector(sel);
187. }
188. mSelectedTop = sel.getTop();
189. } else {
190. if (mTouchMode > TOUCH_MODE_DOWN && mTouchMode < TOUCH_MODE_SCROLL) {
191. View child = getChildAt(mMotionPosition - mFirstPosition);
192. if (child != null) positionSelector(child);
193. } else {
194. mSelectedTop = 0;
195. mSelectorRect.setEmpty();
196. }
197. // even if there is not selected position, we may need to restore
198. // focus (i.e. something focusable in touch mode)
199. if (hasFocus() && focusLayoutRestoreView != null) {
200. focusLayoutRestoreView.requestFocus();
201. }
202. }
203. // tell focus view we are done mucking with it, if it is still in
204. // our view hierarchy.
205. if (focusLayoutRestoreView != null
206. && focusLayoutRestoreView.getWindowToken() != null) {
207. focusLayoutRestoreView.onFinishTemporaryDetach();
208. }
209. mLayoutMode = LAYOUT_NORMAL;
210. mDataChanged = false;
211. mNeedSync = false;
212. setNextSelectedPositionInt(mSelectedPosition);
213. updateScrollIndicators();
214. if (mItemCount > 0) {
215. checkSelectionChanged();
216. }
217. invokeOnItemScrollListener();
218. } finally {
219. if (!blockLayoutRequests) {
220. mBlockLayoutRequests = false;
221. }
222. }
223. }

1. /**
2. * Put a specific item at a specific location on the screen and then build
3. * up and down from there.
4. *
5. * @param position The reference view to use as the starting point
6. * @param top Pixel offset from the top of this view to the top of the
7. *        reference view.
8. *
9. * @return The selected view, or null if the selected view is outside the
10. *         visible area.
11. */
12. private View fillSpecific(int position, int top) {
13. boolean tempIsSelected = position == mSelectedPosition;
14. View temp = makeAndAddView(position, top, true, mListPadding.left, tempIsSelected);
15. // Possibly changed again in fillUp if we add rows above this one.
16. mFirstPosition = position;
17. View above;
18. View below;
19. final int dividerHeight = mDividerHeight;
20. if (!mStackFromBottom) {
21. above = fillUp(position - 1, temp.getTop() - dividerHeight);
22. // This will correct for the top of the first view not touching the top of the list
23. adjustViewsUpOrDown();
24. below = fillDown(position + 1, temp.getBottom() + dividerHeight);
25. int childCount = getChildCount();
26. if (childCount > 0) {
27. correctTooHigh(childCount);
28. }
29. } else {
30. below = fillDown(position + 1, temp.getBottom() + dividerHeight);
31. // This will correct for the bottom of the last view not touching the bottom of the list
32. adjustViewsUpOrDown();
33. above = fillUp(position - 1, temp.getTop() - dividerHeight);
34. int childCount = getChildCount();
35. if (childCount > 0) {
36. correctTooLow(childCount);
37. }
38. }
39. if (tempIsSelected) {
40. return temp;
41. } else if (above != null) {
42. return above;
43. } else {
44. return below;
45. }
46. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Add a view as a child and make sure it is measured (if necessary) and
3. * positioned properly.
4. *
5. * @param child The view to add
6. * @param position The position of this child
7. * @param y The y position relative to which this view will be positioned
8. * @param flowDown If true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @param recycled Has this view been pulled from the recycle bin? If so it
13. *        does not need to be remeasured.
14. */
15. private void setupChild(View child, int position, int y, boolean flowDown, int childrenLeft,
16. boolean selected, boolean recycled) {
17. final boolean isSelected = selected && shouldShowSelector();
18. final boolean updateChildSelected = isSelected != child.isSelected();
19. final int mode = mTouchMode;
20. final boolean isPressed = mode > TOUCH_MODE_DOWN && mode < TOUCH_MODE_SCROLL &&
21. mMotionPosition == position;
22. final boolean updateChildPressed = isPressed != child.isPressed();
23. final boolean needToMeasure = !recycled || updateChildSelected || child.isLayoutRequested();
24. // Respect layout params that are already in the view. Otherwise make some up...
25. // noinspection unchecked
26. AbsListView.LayoutParams p = (AbsListView.LayoutParams) child.getLayoutParams();
27. if (p == null) {
28. p = new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
29. ViewGroup.LayoutParams.WRAP_CONTENT, 0);
30. }
31. p.viewType = mAdapter.getItemViewType(position);
32. if ((recycled && !p.forceAdd) || (p.recycledHeaderFooter &&
33. p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER)) {
34. attachViewToParent(child, flowDown ? -1 : 0, p);
35. } else {
36. p.forceAdd = false;
37. if (p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
38. p.recycledHeaderFooter = true;
39. }
40. addViewInLayout(child, flowDown ? -1 : 0, p, true);
41. }
42. if (updateChildSelected) {
43. child.setSelected(isSelected);
44. }
45. if (updateChildPressed) {
46. child.setPressed(isPressed);
47. }
48. if (needToMeasure) {
49. int childWidthSpec = ViewGroup.getChildMeasureSpec(mWidthMeasureSpec,
50. mListPadding.left + mListPadding.right, p.width);
51. int lpHeight = p.height;
52. int childHeightSpec;
53. if (lpHeight > 0) {
54. childHeightSpec = MeasureSpec.makeMeasureSpec(lpHeight, MeasureSpec.EXACTLY);
55. } else {
56. childHeightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED);
57. }
58. child.measure(childWidthSpec, childHeightSpec);
59. } else {
60. cleanupLayoutState(child);
61. }
62. final int w = child.getMeasuredWidth();
63. final int h = child.getMeasuredHeight();
64. final int childTop = flowDown ? y : y - h;
65. if (needToMeasure) {
66. final int childRight = childrenLeft + w;
67. final int childBottom = childTop + h;
68. child.layout(childrenLeft, childTop, childRight, childBottom);
69. } else {
70. child.offsetLeftAndRight(childrenLeft - child.getLeft());
71. child.offsetTopAndBottom(childTop - child.getTop());
72. }
73. if (mCachingStarted && !child.isDrawingCacheEnabled()) {
74. child.setDrawingCacheEnabled(true);
75. }
76. }

1. @Override
2. public boolean onTouchEvent(MotionEvent ev) {
3. if (!isEnabled()) {
4. // A disabled view that is clickable still consumes the touch
5. // events, it just doesn't respond to them.
6. return isClickable() || isLongClickable();
7. }
8. final int action = ev.getAction();
9. View v;
10. int deltaY;
11. if (mVelocityTracker == null) {
12. mVelocityTracker = VelocityTracker.obtain();
13. }
14. mVelocityTracker.addMovement(ev);
15. switch (action & MotionEvent.ACTION_MASK) {
16. case MotionEvent.ACTION_DOWN: {
17. mActivePointerId = ev.getPointerId(0);
18. final int x = (int) ev.getX();
19. final int y = (int) ev.getY();
20. int motionPosition = pointToPosition(x, y);
21. if (!mDataChanged) {
22. if ((mTouchMode != TOUCH_MODE_FLING) && (motionPosition >= 0)
23. && (getAdapter().isEnabled(motionPosition))) {
24. // User clicked on an actual view (and was not stopping a
25. // fling). It might be a
26. // click or a scroll. Assume it is a click until proven
27. // otherwise
28. mTouchMode = TOUCH_MODE_DOWN;
29. // FIXME Debounce
30. if (mPendingCheckForTap == null) {
31. mPendingCheckForTap = new CheckForTap();
32. }
33. postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
34. } else {
35. if (ev.getEdgeFlags() != 0 && motionPosition < 0) {
36. // If we couldn't find a view to click on, but the down
37. // event was touching
38. // the edge, we will bail out and try again. This allows
39. // the edge correcting
40. // code in ViewRoot to try to find a nearby view to
41. // select
42. return false;
43. }
44. if (mTouchMode == TOUCH_MODE_FLING) {
45. // Stopped a fling. It is a scroll.
46. createScrollingCache();
47. mTouchMode = TOUCH_MODE_SCROLL;
48. mMotionCorrection = 0;
49. motionPosition = findMotionRow(y);
50. reportScrollStateChange(OnScrollListener.SCROLL_STATE_TOUCH_SCROLL);
51. }
52. }
53. }
54. if (motionPosition >= 0) {
55. // Remember where the motion event started
56. v = getChildAt(motionPosition - mFirstPosition);
57. mMotionViewOriginalTop = v.getTop();
58. }
59. mMotionX = x;
60. mMotionY = y;
61. mMotionPosition = motionPosition;
62. mLastY = Integer.MIN_VALUE;
63. break;
64. }
65. case MotionEvent.ACTION_MOVE: {
66. final int pointerIndex = ev.findPointerIndex(mActivePointerId);
67. final int y = (int) ev.getY(pointerIndex);
68. deltaY = y - mMotionY;
69. switch (mTouchMode) {
70. case TOUCH_MODE_DOWN:
71. case TOUCH_MODE_TAP:
72. case TOUCH_MODE_DONE_WAITING:
73. // Check if we have moved far enough that it looks more like a
74. // scroll than a tap
75. startScrollIfNeeded(deltaY);
76. break;
77. case TOUCH_MODE_SCROLL:
78. if (PROFILE_SCROLLING) {
79. if (!mScrollProfilingStarted) {
80. Debug.startMethodTracing("AbsListViewScroll");
81. mScrollProfilingStarted = true;
82. }
83. }
84. if (y != mLastY) {
85. deltaY -= mMotionCorrection;
86. int incrementalDeltaY = mLastY != Integer.MIN_VALUE ? y - mLastY : deltaY;
87. // No need to do all this work if we're not going to move
88. // anyway
89. boolean atEdge = false;
90. if (incrementalDeltaY != 0) {
91. atEdge = trackMotionScroll(deltaY, incrementalDeltaY);
92. }
93. // Check to see if we have bumped into the scroll limit
94. if (atEdge && getChildCount() > 0) {
95. // Treat this like we're starting a new scroll from the
96. // current
97. // position. This will let the user start scrolling back
98. // into
99. // content immediately rather than needing to scroll
100. // back to the
101. // point where they hit the limit first.
102. int motionPosition = findMotionRow(y);
103. if (motionPosition >= 0) {
104. final View motionView = getChildAt(motionPosition - mFirstPosition);
105. mMotionViewOriginalTop = motionView.getTop();
106. }
107. mMotionY = y;
108. mMotionPosition = motionPosition;
109. invalidate();
110. }
111. mLastY = y;
112. }
113. break;
114. }
115. break;
116. }
117. case MotionEvent.ACTION_UP: {
118. switch (mTouchMode) {
119. case TOUCH_MODE_DOWN:
120. case TOUCH_MODE_TAP:
121. case TOUCH_MODE_DONE_WAITING:
122. final int motionPosition = mMotionPosition;
123. final View child = getChildAt(motionPosition - mFirstPosition);
124. if (child != null && !child.hasFocusable()) {
125. if (mTouchMode != TOUCH_MODE_DOWN) {
126. child.setPressed(false);
127. }
128. if (mPerformClick == null) {
129. mPerformClick = new PerformClick();
130. }
131. final AbsListView.PerformClick performClick = mPerformClick;
132. performClick.mChild = child;
133. performClick.mClickMotionPosition = motionPosition;
134. performClick.rememberWindowAttachCount();
135. mResurrectToPosition = motionPosition;
136. if (mTouchMode == TOUCH_MODE_DOWN || mTouchMode == TOUCH_MODE_TAP) {
137. final Handler handler = getHandler();
138. if (handler != null) {
139. handler.removeCallbacks(mTouchMode == TOUCH_MODE_DOWN ? mPendingCheckForTap
140. : mPendingCheckForLongPress);
141. }
142. mLayoutMode = LAYOUT_NORMAL;
143. if (!mDataChanged && mAdapter.isEnabled(motionPosition)) {
144. mTouchMode = TOUCH_MODE_TAP;
145. setSelectedPositionInt(mMotionPosition);
146. layoutChildren();
147. child.setPressed(true);
148. positionSelector(child);
149. setPressed(true);
150. if (mSelector != null) {
151. Drawable d = mSelector.getCurrent();
152. if (d != null && d instanceof TransitionDrawable) {
153. ((TransitionDrawable) d).resetTransition();
154. }
155. }
156. postDelayed(new Runnable() {
157. public void run() {
158. child.setPressed(false);
159. setPressed(false);
160. if (!mDataChanged) {
161. post(performClick);
162. }
163. mTouchMode = TOUCH_MODE_REST;
164. }
165. }, ViewConfiguration.getPressedStateDuration());
166. } else {
167. mTouchMode = TOUCH_MODE_REST;
168. }
169. return true;
170. } else if (!mDataChanged && mAdapter.isEnabled(motionPosition)) {
171. post(performClick);
172. }
173. }
174. mTouchMode = TOUCH_MODE_REST;
175. break;
176. case TOUCH_MODE_SCROLL:
177. final int childCount = getChildCount();
178. if (childCount > 0) {
179. if (mFirstPosition == 0
180. && getChildAt(0).getTop() >= mListPadding.top
181. && mFirstPosition + childCount < mItemCount
182. && getChildAt(childCount - 1).getBottom() <= getHeight()
183. - mListPadding.bottom) {
184. mTouchMode = TOUCH_MODE_REST;
185. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
186. } else {
187. final VelocityTracker velocityTracker = mVelocityTracker;
188. velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
189. final int initialVelocity = (int) velocityTracker
190. .getYVelocity(mActivePointerId);
191. if (Math.abs(initialVelocity) > mMinimumVelocity) {
192. if (mFlingRunnable == null) {
193. mFlingRunnable = new FlingRunnable();
194. }
195. reportScrollStateChange(OnScrollListener.SCROLL_STATE_FLING);
196. mFlingRunnable.start(-initialVelocity);
197. } else {
198. mTouchMode = TOUCH_MODE_REST;
199. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
200. }
201. }
202. } else {
203. mTouchMode = TOUCH_MODE_REST;
204. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
205. }
206. break;
207. }
208. setPressed(false);
209. // Need to redraw since we probably aren't drawing the selector
210. // anymore
211. invalidate();
212. final Handler handler = getHandler();
213. if (handler != null) {
214. handler.removeCallbacks(mPendingCheckForLongPress);
215. }
216. if (mVelocityTracker != null) {
217. mVelocityTracker.recycle();
218. mVelocityTracker = null;
219. }
220. mActivePointerId = INVALID_POINTER;
221. if (PROFILE_SCROLLING) {
222. if (mScrollProfilingStarted) {
223. Debug.stopMethodTracing();
224. mScrollProfilingStarted = false;
225. }
226. }
227. break;
228. }
229. case MotionEvent.ACTION_CANCEL: {
230. mTouchMode = TOUCH_MODE_REST;
231. setPressed(false);
232. View motionView = this.getChildAt(mMotionPosition - mFirstPosition);
233. if (motionView != null) {
234. motionView.setPressed(false);
235. }
236. clearScrollingCache();
237. final Handler handler = getHandler();
238. if (handler != null) {
239. handler.removeCallbacks(mPendingCheckForLongPress);
240. }
241. if (mVelocityTracker != null) {
242. mVelocityTracker.recycle();
243. mVelocityTracker = null;
244. }
245. mActivePointerId = INVALID_POINTER;
246. break;
247. }
248. case MotionEvent.ACTION_POINTER_UP: {
249. onSecondaryPointerUp(ev);
250. final int x = mMotionX;
251. final int y = mMotionY;
252. final int motionPosition = pointToPosition(x, y);
253. if (motionPosition >= 0) {
254. // Remember where the motion event started
255. v = getChildAt(motionPosition - mFirstPosition);
256. mMotionViewOriginalTop = v.getTop();
257. mMotionPosition = motionPosition;
258. }
259. mLastY = y;
260. break;
261. }
262. }
263. return true;
264. }

1. boolean trackMotionScroll(int deltaY, int incrementalDeltaY) {
2. final int childCount = getChildCount();
3. if (childCount == 0) {
4. return true;
5. }
6. final int firstTop = getChildAt(0).getTop();
7. final int lastBottom = getChildAt(childCount - 1).getBottom();
8. final Rect listPadding = mListPadding;
9. final int spaceAbove = listPadding.top - firstTop;
10. final int end = getHeight() - listPadding.bottom;
11. final int spaceBelow = lastBottom - end;
12. final int height = getHeight() - getPaddingBottom() - getPaddingTop();
13. if (deltaY < 0) {
14. deltaY = Math.max(-(height - 1), deltaY);
15. } else {
16. deltaY = Math.min(height - 1, deltaY);
17. }
18. if (incrementalDeltaY < 0) {
19. incrementalDeltaY = Math.max(-(height - 1), incrementalDeltaY);
20. } else {
21. incrementalDeltaY = Math.min(height - 1, incrementalDeltaY);
22. }
23. final int firstPosition = mFirstPosition;
24. if (firstPosition == 0 && firstTop >= listPadding.top && deltaY >= 0) {
25. // Don't need to move views down if the top of the first position
26. // is already visible
27. return true;
28. }
29. if (firstPosition + childCount == mItemCount && lastBottom <= end && deltaY <= 0) {
30. // Don't need to move views up if the bottom of the last position
31. // is already visible
32. return true;
33. }
34. final boolean down = incrementalDeltaY < 0;
35. final boolean inTouchMode = isInTouchMode();
36. if (inTouchMode) {
37. hideSelector();
38. }
39. final int headerViewsCount = getHeaderViewsCount();
40. final int footerViewsStart = mItemCount - getFooterViewsCount();
41. int start = 0;
42. int count = 0;
43. if (down) {
44. final int top = listPadding.top - incrementalDeltaY;
45. for (int i = 0; i < childCount; i++) {
46. final View child = getChildAt(i);
47. if (child.getBottom() >= top) {
48. break;
49. } else {
50. count++;
51. int position = firstPosition + i;
52. if (position >= headerViewsCount && position < footerViewsStart) {
53. mRecycler.addScrapView(child);
54. }
55. }
56. }
57. } else {
58. final int bottom = getHeight() - listPadding.bottom - incrementalDeltaY;
59. for (int i = childCount - 1; i >= 0; i--) {
60. final View child = getChildAt(i);
61. if (child.getTop() <= bottom) {
62. break;
63. } else {
64. start = i;
65. count++;
66. int position = firstPosition + i;
67. if (position >= headerViewsCount && position < footerViewsStart) {
68. mRecycler.addScrapView(child);
69. }
70. }
71. }
72. }
73. mMotionViewNewTop = mMotionViewOriginalTop + deltaY;
74. mBlockLayoutRequests = true;
75. if (count > 0) {
76. detachViewsFromParent(start, count);
77. }
78. offsetChildrenTopAndBottom(incrementalDeltaY);
79. if (down) {
80. mFirstPosition += count;
81. }
82. invalidate();
83. final int absIncrementalDeltaY = Math.abs(incrementalDeltaY);
84. if (spaceAbove < absIncrementalDeltaY || spaceBelow < absIncrementalDeltaY) {
85. fillGap(down);
86. }
87. if (!inTouchMode && mSelectedPosition != INVALID_POSITION) {
88. final int childIndex = mSelectedPosition - mFirstPosition;
89. if (childIndex >= 0 && childIndex < getChildCount()) {
90. positionSelector(getChildAt(childIndex));
91. }
92. }
93. mBlockLayoutRequests = false;
94. invokeOnItemScrollListener();
95. awakenScrollBars();
96. return false;
97. }

1. /**
2. * Fills the gap left open by a touch-scroll. During a touch scroll,
3. * children that remain on screen are shifted and the other ones are
4. * discarded. The role of this method is to fill the gap thus created by
5. * performing a partial layout in the empty space.
6. *
7. * @param down
8. *            true if the scroll is going down, false if it is going up
9. */
10. abstract void fillGap(boolean down);

1. void fillGap(boolean down) {
2. final int count = getChildCount();
3. if (down) {
4. final int startOffset = count > 0 ? getChildAt(count - 1).getBottom() + mDividerHeight :
5. getListPaddingTop();
6. fillDown(mFirstPosition + count, startOffset);
7. correctTooHigh(getChildCount());
8. } else {
9. final int startOffset = count > 0 ? getChildAt(0).getTop() - mDividerHeight :
10. getHeight() - getListPaddingBottom();
11. fillUp(mFirstPosition - 1, startOffset);
12. correctTooLow(getChildCount());
13. }
14. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Get a view and have it show the data associated with the specified
3. * position. This is called when we have already discovered that the view is
4. * not available for reuse in the recycle bin. The only choices left are
5. * converting an old view or making a new one.
6. *
7. * @param position
8. *            The position to display
9. * @param isScrap
10. *            Array of at least 1 boolean, the first entry will become true
11. *            if the returned view was taken from the scrap heap, false if
12. *            otherwise.
13. *
14. * @return A view displaying the data associated with the specified position
15. */
16. View obtainView(int position, boolean[] isScrap) {
17. isScrap[0] = false;
18. View scrapView;
19. scrapView = mRecycler.getScrapView(position);
20. View child;
21. if (scrapView != null) {
22. child = mAdapter.getView(position, scrapView, this);
23. if (child != scrapView) {
24. mRecycler.addScrapView(scrapView);
25. if (mCacheColorHint != 0) {
26. child.setDrawingCacheBackgroundColor(mCacheColorHint);
27. }
28. } else {
29. isScrap[0] = true;
30. dispatchFinishTemporaryDetach(child);
31. }
32. } else {
33. child = mAdapter.getView(position, null, this);
34. if (mCacheColorHint != 0) {
35. child.setDrawingCacheBackgroundColor(mCacheColorHint);
36. }
37. }
38. return child;
39. }

1. /**
2. * The RecycleBin facilitates reuse of views across layouts. The RecycleBin
3. * has two levels of storage: ActiveViews and ScrapViews. ActiveViews are
4. * those views which were onscreen at the start of a layout. By
5. * construction, they are displaying current information. At the end of
6. * layout, all views in ActiveViews are demoted to ScrapViews. ScrapViews
7. * are old views that could potentially be used by the adapter to avoid
8. * allocating views unnecessarily.
9. *
10. * @see android.widget.AbsListView#setRecyclerListener(android.widget.AbsListView.RecyclerListener)
11. * @see android.widget.AbsListView.RecyclerListener
12. */
13. class RecycleBin {
14. private RecyclerListener mRecyclerListener;
15. /**
16. * The position of the first view stored in mActiveViews.
17. */
18. private int mFirstActivePosition;
19. /**
20. * Views that were on screen at the start of layout. This array is
21. * populated at the start of layout, and at the end of layout all view
22. * in mActiveViews are moved to mScrapViews. Views in mActiveViews
23. * represent a contiguous range of Views, with position of the first
24. * view store in mFirstActivePosition.
25. */
26. private View[] mActiveViews = new View[0];
27. /**
28. * Unsorted views that can be used by the adapter as a convert view.
29. */
30. private ArrayList<View>[] mScrapViews;
31. private int mViewTypeCount;
32. private ArrayList<View> mCurrentScrap;
33. /**
34. * Fill ActiveViews with all of the children of the AbsListView.
35. *
36. * @param childCount
37. *            The minimum number of views mActiveViews should hold
38. * @param firstActivePosition
39. *            The position of the first view that will be stored in
40. *            mActiveViews
41. */
42. void fillActiveViews(int childCount, int firstActivePosition) {
43. if (mActiveViews.length < childCount) {
44. mActiveViews = new View[childCount];
45. }
46. mFirstActivePosition = firstActivePosition;
47. final View[] activeViews = mActiveViews;
48. for (int i = 0; i < childCount; i++) {
49. View child = getChildAt(i);
50. AbsListView.LayoutParams lp = (AbsListView.LayoutParams) child.getLayoutParams();
51. // Don't put header or footer views into the scrap heap
52. if (lp != null && lp.viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
53. // Note: We do place AdapterView.ITEM_VIEW_TYPE_IGNORE in
54. // active views.
55. // However, we will NOT place them into scrap views.
56. activeViews[i] = child;
57. }
58. }
59. }
60. /**
61. * Get the view corresponding to the specified position. The view will
62. * be removed from mActiveViews if it is found.
63. *
64. * @param position
65. *            The position to look up in mActiveViews
66. * @return The view if it is found, null otherwise
67. */
68. View getActiveView(int position) {
69. int index = position - mFirstActivePosition;
70. final View[] activeViews = mActiveViews;
71. if (index >= 0 && index < activeViews.length) {
72. final View match = activeViews[index];
73. activeViews[index] = null;
74. return match;
75. }
76. return null;
77. }
78. /**
79. * Put a view into the ScapViews list. These views are unordered.
80. *
81. * @param scrap
82. *            The view to add
83. */
84. void addScrapView(View scrap) {
85. AbsListView.LayoutParams lp = (AbsListView.LayoutParams) scrap.getLayoutParams();
86. if (lp == null) {
87. return;
88. }
89. // Don't put header or footer views or views that should be ignored
90. // into the scrap heap
91. int viewType = lp.viewType;
92. if (!shouldRecycleViewType(viewType)) {
93. if (viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
94. removeDetachedView(scrap, false);
95. }
96. return;
97. }
98. if (mViewTypeCount == 1) {
99. dispatchFinishTemporaryDetach(scrap);
100. mCurrentScrap.add(scrap);
101. } else {
102. dispatchFinishTemporaryDetach(scrap);
103. mScrapViews[viewType].add(scrap);
104. }
105. if (mRecyclerListener != null) {
106. mRecyclerListener.onMovedToScrapHeap(scrap);
107. }
108. }
109. /**
110. * @return A view from the ScrapViews collection. These are unordered.
111. */
112. View getScrapView(int position) {
113. ArrayList<View> scrapViews;
114. if (mViewTypeCount == 1) {
115. scrapViews = mCurrentScrap;
116. int size = scrapViews.size();
117. if (size > 0) {
118. return scrapViews.remove(size - 1);
119. } else {
120. return null;
121. }
122. } else {
123. int whichScrap = mAdapter.getItemViewType(position);
124. if (whichScrap >= 0 && whichScrap < mScrapViews.length) {
125. scrapViews = mScrapViews[whichScrap];
126. int size = scrapViews.size();
127. if (size > 0) {
128. return scrapViews.remove(size - 1);
129. }
130. }
131. }
132. return null;
133. }
134. public void setViewTypeCount(int viewTypeCount) {
135. if (viewTypeCount < 1) {
136. throw new IllegalArgumentException("Can't have a viewTypeCount < 1");
137. }
138. // noinspection unchecked
139. ArrayList<View>[] scrapViews = new ArrayList[viewTypeCount];
140. for (int i = 0; i < viewTypeCount; i++) {
141. scrapViews[i] = new ArrayList<View>();
142. }
143. mViewTypeCount = viewTypeCount;
144. mCurrentScrap = scrapViews[0];
145. mScrapViews = scrapViews;
146. }
147. }

不管怎么说，ListView即使再特殊最终还是继承自View的，因此它的执行流程还将会按照View的规则来执行，对于这方面不太熟悉的朋友可以参考我之前写的 Android视图绘制流程完全解析，带你一步步深入了解View(二) 。

View的执行流程无非就分为三步，onMeasure()用于测量View的大小，onLayout()用于确定View的布局，onDraw()用于将View绘制到界面上。而在ListView当中，onMeasure()并没有什么特殊的地方，因为它终归是一个View，占用的空间最多并且通常也就是整个屏幕。onDraw()在ListView当中也没有什么意义，因为ListView本身并不负责绘制，而是由ListView当中的子元素来进行绘制的。那么ListView大部分的神奇功能其实都是在onLayout()方法中进行的了，因此我们本篇文章也是主要分析的这个方法里的内容。

1. /**
2. * Subclasses should NOT override this method but {@link #layoutChildren()}
3. * instead.
4. */
5. @Override
6. protected void onLayout(boolean changed, int l, int t, int r, int b) {
7. super.onLayout(changed, l, t, r, b);
8. mInLayout = true;
9. if (changed) {
10. int childCount = getChildCount();
11. for (int i = 0; i < childCount; i++) {
12. getChildAt(i).forceLayout();
13. }
14. mRecycler.markChildrenDirty();
15. }
16. layoutChildren();
17. mInLayout = false;
18. }

1. @Override
2. protected void layoutChildren() {
3. final boolean blockLayoutRequests = mBlockLayoutRequests;
4. if (!blockLayoutRequests) {
5. mBlockLayoutRequests = true;
6. } else {
7. return;
8. }
9. try {
10. super.layoutChildren();
11. invalidate();
12. if (mAdapter == null) {
13. resetList();
14. invokeOnItemScrollListener();
15. return;
16. }
17. int childrenTop = mListPadding.top;
18. int childrenBottom = getBottom() - getTop() - mListPadding.bottom;
19. int childCount = getChildCount();
20. int index = 0;
21. int delta = 0;
22. View sel;
23. View oldSel = null;
24. View oldFirst = null;
25. View newSel = null;
26. View focusLayoutRestoreView = null;
27. // Remember stuff we will need down below
28. switch (mLayoutMode) {
29. case LAYOUT_SET_SELECTION:
30. index = mNextSelectedPosition - mFirstPosition;
31. if (index >= 0 && index < childCount) {
32. newSel = getChildAt(index);
33. }
34. break;
35. case LAYOUT_FORCE_TOP:
36. case LAYOUT_FORCE_BOTTOM:
37. case LAYOUT_SPECIFIC:
38. case LAYOUT_SYNC:
39. break;
40. case LAYOUT_MOVE_SELECTION:
41. default:
42. // Remember the previously selected view
43. index = mSelectedPosition - mFirstPosition;
44. if (index >= 0 && index < childCount) {
45. oldSel = getChildAt(index);
46. }
47. // Remember the previous first child
48. oldFirst = getChildAt(0);
49. if (mNextSelectedPosition >= 0) {
50. delta = mNextSelectedPosition - mSelectedPosition;
51. }
52. // Caution: newSel might be null
53. newSel = getChildAt(index + delta);
54. }
55. boolean dataChanged = mDataChanged;
56. if (dataChanged) {
57. handleDataChanged();
58. }
59. // Handle the empty set by removing all views that are visible
60. // and calling it a day
61. if (mItemCount == 0) {
62. resetList();
63. invokeOnItemScrollListener();
64. return;
65. } else if (mItemCount != mAdapter.getCount()) {
66. throw new IllegalStateException("The content of the adapter has changed but "
67. + "ListView did not receive a notification. Make sure the content of "
68. + "your adapter is not modified from a background thread, but only "
69. + "from the UI thread. [in ListView(" + getId() + ", " + getClass()
70. + ") with Adapter(" + mAdapter.getClass() + ")]");
71. }
72. setSelectedPositionInt(mNextSelectedPosition);
73. // Pull all children into the RecycleBin.
74. // These views will be reused if possible
75. final int firstPosition = mFirstPosition;
76. final RecycleBin recycleBin = mRecycler;
77. // reset the focus restoration
78. View focusLayoutRestoreDirectChild = null;
79. // Don't put header or footer views into the Recycler. Those are
80. // already cached in mHeaderViews;
81. if (dataChanged) {
82. for (int i = 0; i < childCount; i++) {
83. recycleBin.addScrapView(getChildAt(i));
84. if (ViewDebug.TRACE_RECYCLER) {
85. ViewDebug.trace(getChildAt(i),
86. ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, index, i);
87. }
88. }
89. } else {
90. recycleBin.fillActiveViews(childCount, firstPosition);
91. }
92. // take focus back to us temporarily to avoid the eventual
93. // call to clear focus when removing the focused child below
94. // from messing things up when ViewRoot assigns focus back
95. // to someone else
96. final View focusedChild = getFocusedChild();
97. if (focusedChild != null) {
98. // TODO: in some cases focusedChild.getParent() == null
99. // we can remember the focused view to restore after relayout if the
100. // data hasn't changed, or if the focused position is a header or footer
101. if (!dataChanged || isDirectChildHeaderOrFooter(focusedChild)) {
102. focusLayoutRestoreDirectChild = focusedChild;
103. // remember the specific view that had focus
104. focusLayoutRestoreView = findFocus();
105. if (focusLayoutRestoreView != null) {
106. // tell it we are going to mess with it
107. focusLayoutRestoreView.onStartTemporaryDetach();
108. }
109. }
110. requestFocus();
111. }
112. // Clear out old views
113. detachAllViewsFromParent();
114. switch (mLayoutMode) {
115. case LAYOUT_SET_SELECTION:
116. if (newSel != null) {
117. sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
118. } else {
119. sel = fillFromMiddle(childrenTop, childrenBottom);
120. }
121. break;
122. case LAYOUT_SYNC:
123. sel = fillSpecific(mSyncPosition, mSpecificTop);
124. break;
125. case LAYOUT_FORCE_BOTTOM:
126. sel = fillUp(mItemCount - 1, childrenBottom);
127. adjustViewsUpOrDown();
128. break;
129. case LAYOUT_FORCE_TOP:
130. mFirstPosition = 0;
131. sel = fillFromTop(childrenTop);
132. adjustViewsUpOrDown();
133. break;
134. case LAYOUT_SPECIFIC:
135. sel = fillSpecific(reconcileSelectedPosition(), mSpecificTop);
136. break;
137. case LAYOUT_MOVE_SELECTION:
138. sel = moveSelection(oldSel, newSel, delta, childrenTop, childrenBottom);
139. break;
140. default:
141. if (childCount == 0) {
142. if (!mStackFromBottom) {
143. final int position = lookForSelectablePosition(0, true);
144. setSelectedPositionInt(position);
145. sel = fillFromTop(childrenTop);
146. } else {
147. final int position = lookForSelectablePosition(mItemCount - 1, false);
148. setSelectedPositionInt(position);
149. sel = fillUp(mItemCount - 1, childrenBottom);
150. }
151. } else {
152. if (mSelectedPosition >= 0 && mSelectedPosition < mItemCount) {
153. sel = fillSpecific(mSelectedPosition,
154. oldSel == null ? childrenTop : oldSel.getTop());
155. } else if (mFirstPosition < mItemCount) {
156. sel = fillSpecific(mFirstPosition,
157. oldFirst == null ? childrenTop : oldFirst.getTop());
158. } else {
159. sel = fillSpecific(0, childrenTop);
160. }
161. }
162. break;
163. }
164. // Flush any cached views that did not get reused above
165. recycleBin.scrapActiveViews();
166. if (sel != null) {
167. // the current selected item should get focus if items
168. // are focusable
169. if (mItemsCanFocus && hasFocus() && !sel.hasFocus()) {
170. final boolean focusWasTaken = (sel == focusLayoutRestoreDirectChild &&
171. focusLayoutRestoreView.requestFocus()) || sel.requestFocus();
172. if (!focusWasTaken) {
173. // selected item didn't take focus, fine, but still want
174. // to make sure something else outside of the selected view
175. // has focus
176. final View focused = getFocusedChild();
177. if (focused != null) {
178. focused.clearFocus();
179. }
180. positionSelector(sel);
181. } else {
182. sel.setSelected(false);
183. mSelectorRect.setEmpty();
184. }
185. } else {
186. positionSelector(sel);
187. }
188. mSelectedTop = sel.getTop();
189. } else {
190. if (mTouchMode > TOUCH_MODE_DOWN && mTouchMode < TOUCH_MODE_SCROLL) {
191. View child = getChildAt(mMotionPosition - mFirstPosition);
192. if (child != null) positionSelector(child);
193. } else {
194. mSelectedTop = 0;
195. mSelectorRect.setEmpty();
196. }
197. // even if there is not selected position, we may need to restore
198. // focus (i.e. something focusable in touch mode)
199. if (hasFocus() && focusLayoutRestoreView != null) {
200. focusLayoutRestoreView.requestFocus();
201. }
202. }
203. // tell focus view we are done mucking with it, if it is still in
204. // our view hierarchy.
205. if (focusLayoutRestoreView != null
206. && focusLayoutRestoreView.getWindowToken() != null) {
207. focusLayoutRestoreView.onFinishTemporaryDetach();
208. }
209. mLayoutMode = LAYOUT_NORMAL;
210. mDataChanged = false;
211. mNeedSync = false;
212. setNextSelectedPositionInt(mSelectedPosition);
213. updateScrollIndicators();
214. if (mItemCount > 0) {
215. checkSelectionChanged();
216. }
217. invokeOnItemScrollListener();
218. } finally {
219. if (!blockLayoutRequests) {
220. mBlockLayoutRequests = false;
221. }
222. }
223. }

1. /**
2. * Fills the list from top to bottom, starting with mFirstPosition
3. *
4. * @param nextTop The location where the top of the first item should be
5. *        drawn
6. *
7. * @return The view that is currently selected
8. */
9. private View fillFromTop(int nextTop) {
10. mFirstPosition = Math.min(mFirstPosition, mSelectedPosition);
11. mFirstPosition = Math.min(mFirstPosition, mItemCount - 1);
12. if (mFirstPosition < 0) {
13. mFirstPosition = 0;
14. }
15. return fillDown(mFirstPosition, nextTop);
16. }

1. /**
2. * Fills the list from pos down to the end of the list view.
3. *
4. * @param pos The first position to put in the list
5. *
6. * @param nextTop The location where the top of the item associated with pos
7. *        should be drawn
8. *
9. * @return The view that is currently selected, if it happens to be in the
10. *         range that we draw.
11. */
12. private View fillDown(int pos, int nextTop) {
13. View selectedView = null;
14. int end = (getBottom() - getTop()) - mListPadding.bottom;
15. while (nextTop < end && pos < mItemCount) {
16. // is this the selected item?
17. boolean selected = pos == mSelectedPosition;
18. View child = makeAndAddView(pos, nextTop, true, mListPadding.left, selected);
19. nextTop = child.getBottom() + mDividerHeight;
20. if (selected) {
21. selectedView = child;
22. }
23. pos++;
24. }
25. return selectedView;
26. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Get a view and have it show the data associated with the specified
3. * position. This is called when we have already discovered that the view is
4. * not available for reuse in the recycle bin. The only choices left are
5. * converting an old view or making a new one.
6. *
7. * @param position
8. *            The position to display
9. * @param isScrap
10. *            Array of at least 1 boolean, the first entry will become true
11. *            if the returned view was taken from the scrap heap, false if
12. *            otherwise.
13. *
14. * @return A view displaying the data associated with the specified position
15. */
16. View obtainView(int position, boolean[] isScrap) {
17. isScrap[0] = false;
18. View scrapView;
19. scrapView = mRecycler.getScrapView(position);
20. View child;
21. if (scrapView != null) {
22. child = mAdapter.getView(position, scrapView, this);
23. if (child != scrapView) {
24. mRecycler.addScrapView(scrapView);
25. if (mCacheColorHint != 0) {
26. child.setDrawingCacheBackgroundColor(mCacheColorHint);
27. }
28. } else {
29. isScrap[0] = true;
30. dispatchFinishTemporaryDetach(child);
31. }
32. } else {
33. child = mAdapter.getView(position, null, this);
34. if (mCacheColorHint != 0) {
35. child.setDrawingCacheBackgroundColor(mCacheColorHint);
36. }
37. }
38. return child;
39. }

1. @Override
2. public View getView(int position, View convertView, ViewGroup parent) {
3. Fruit fruit = getItem(position);
4. View view;
5. if (convertView == null) {
6. view = LayoutInflater.from(getContext()).inflate(resourceId, null);
7. } else {
8. view = convertView;
9. }
10. ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);
11. TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);
12. fruitImage.setImageResource(fruit.getImageId());
13. fruitName.setText(fruit.getName());
14. return view;
15. }

1. /**
2. * Add a view as a child and make sure it is measured (if necessary) and
3. * positioned properly.
4. *
5. * @param child The view to add
6. * @param position The position of this child
7. * @param y The y position relative to which this view will be positioned
8. * @param flowDown If true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @param recycled Has this view been pulled from the recycle bin? If so it
13. *        does not need to be remeasured.
14. */
15. private void setupChild(View child, int position, int y, boolean flowDown, int childrenLeft,
16. boolean selected, boolean recycled) {
17. final boolean isSelected = selected && shouldShowSelector();
18. final boolean updateChildSelected = isSelected != child.isSelected();
19. final int mode = mTouchMode;
20. final boolean isPressed = mode > TOUCH_MODE_DOWN && mode < TOUCH_MODE_SCROLL &&
21. mMotionPosition == position;
22. final boolean updateChildPressed = isPressed != child.isPressed();
23. final boolean needToMeasure = !recycled || updateChildSelected || child.isLayoutRequested();
24. // Respect layout params that are already in the view. Otherwise make some up...
25. // noinspection unchecked
26. AbsListView.LayoutParams p = (AbsListView.LayoutParams) child.getLayoutParams();
27. if (p == null) {
28. p = new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
29. ViewGroup.LayoutParams.WRAP_CONTENT, 0);
30. }
31. p.viewType = mAdapter.getItemViewType(position);
32. if ((recycled && !p.forceAdd) || (p.recycledHeaderFooter &&
33. p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER)) {
34. attachViewToParent(child, flowDown ? -1 : 0, p);
35. } else {
36. p.forceAdd = false;
37. if (p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
38. p.recycledHeaderFooter = true;
39. }
40. addViewInLayout(child, flowDown ? -1 : 0, p, true);
41. }
42. if (updateChildSelected) {
43. child.setSelected(isSelected);
44. }
45. if (updateChildPressed) {
46. child.setPressed(isPressed);
47. }
48. if (needToMeasure) {
49. int childWidthSpec = ViewGroup.getChildMeasureSpec(mWidthMeasureSpec,
50. mListPadding.left + mListPadding.right, p.width);
51. int lpHeight = p.height;
52. int childHeightSpec;
53. if (lpHeight > 0) {
54. childHeightSpec = MeasureSpec.makeMeasureSpec(lpHeight, MeasureSpec.EXACTLY);
55. } else {
56. childHeightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED);
57. }
58. child.measure(childWidthSpec, childHeightSpec);
59. } else {
60. cleanupLayoutState(child);
61. }
62. final int w = child.getMeasuredWidth();
63. final int h = child.getMeasuredHeight();
64. final int childTop = flowDown ? y : y - h;
65. if (needToMeasure) {
66. final int childRight = childrenLeft + w;
67. final int childBottom = childTop + h;
68. child.layout(childrenLeft, childTop, childRight, childBottom);
69. } else {
70. child.offsetLeftAndRight(childrenLeft - child.getLeft());
71. child.offsetTopAndBottom(childTop - child.getTop());
72. }
73. if (mCachingStarted && !child.isDrawingCacheEnabled()) {
74. child.setDrawingCacheEnabled(true);
75. }
76. }

1. @Override
2. protected void layoutChildren() {
3. final boolean blockLayoutRequests = mBlockLayoutRequests;
4. if (!blockLayoutRequests) {
5. mBlockLayoutRequests = true;
6. } else {
7. return;
8. }
9. try {
10. super.layoutChildren();
11. invalidate();
12. if (mAdapter == null) {
13. resetList();
14. invokeOnItemScrollListener();
15. return;
16. }
17. int childrenTop = mListPadding.top;
18. int childrenBottom = getBottom() - getTop() - mListPadding.bottom;
19. int childCount = getChildCount();
20. int index = 0;
21. int delta = 0;
22. View sel;
23. View oldSel = null;
24. View oldFirst = null;
25. View newSel = null;
26. View focusLayoutRestoreView = null;
27. // Remember stuff we will need down below
28. switch (mLayoutMode) {
29. case LAYOUT_SET_SELECTION:
30. index = mNextSelectedPosition - mFirstPosition;
31. if (index >= 0 && index < childCount) {
32. newSel = getChildAt(index);
33. }
34. break;
35. case LAYOUT_FORCE_TOP:
36. case LAYOUT_FORCE_BOTTOM:
37. case LAYOUT_SPECIFIC:
38. case LAYOUT_SYNC:
39. break;
40. case LAYOUT_MOVE_SELECTION:
41. default:
42. // Remember the previously selected view
43. index = mSelectedPosition - mFirstPosition;
44. if (index >= 0 && index < childCount) {
45. oldSel = getChildAt(index);
46. }
47. // Remember the previous first child
48. oldFirst = getChildAt(0);
49. if (mNextSelectedPosition >= 0) {
50. delta = mNextSelectedPosition - mSelectedPosition;
51. }
52. // Caution: newSel might be null
53. newSel = getChildAt(index + delta);
54. }
55. boolean dataChanged = mDataChanged;
56. if (dataChanged) {
57. handleDataChanged();
58. }
59. // Handle the empty set by removing all views that are visible
60. // and calling it a day
61. if (mItemCount == 0) {
62. resetList();
63. invokeOnItemScrollListener();
64. return;
65. } else if (mItemCount != mAdapter.getCount()) {
66. throw new IllegalStateException("The content of the adapter has changed but "
67. + "ListView did not receive a notification. Make sure the content of "
68. + "your adapter is not modified from a background thread, but only "
69. + "from the UI thread. [in ListView(" + getId() + ", " + getClass()
70. + ") with Adapter(" + mAdapter.getClass() + ")]");
71. }
72. setSelectedPositionInt(mNextSelectedPosition);
73. // Pull all children into the RecycleBin.
74. // These views will be reused if possible
75. final int firstPosition = mFirstPosition;
76. final RecycleBin recycleBin = mRecycler;
77. // reset the focus restoration
78. View focusLayoutRestoreDirectChild = null;
79. // Don't put header or footer views into the Recycler. Those are
80. // already cached in mHeaderViews;
81. if (dataChanged) {
82. for (int i = 0; i < childCount; i++) {
83. recycleBin.addScrapView(getChildAt(i));
84. if (ViewDebug.TRACE_RECYCLER) {
85. ViewDebug.trace(getChildAt(i),
86. ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, index, i);
87. }
88. }
89. } else {
90. recycleBin.fillActiveViews(childCount, firstPosition);
91. }
92. // take focus back to us temporarily to avoid the eventual
93. // call to clear focus when removing the focused child below
94. // from messing things up when ViewRoot assigns focus back
95. // to someone else
96. final View focusedChild = getFocusedChild();
97. if (focusedChild != null) {
98. // TODO: in some cases focusedChild.getParent() == null
99. // we can remember the focused view to restore after relayout if the
100. // data hasn't changed, or if the focused position is a header or footer
101. if (!dataChanged || isDirectChildHeaderOrFooter(focusedChild)) {
102. focusLayoutRestoreDirectChild = focusedChild;
103. // remember the specific view that had focus
104. focusLayoutRestoreView = findFocus();
105. if (focusLayoutRestoreView != null) {
106. // tell it we are going to mess with it
107. focusLayoutRestoreView.onStartTemporaryDetach();
108. }
109. }
110. requestFocus();
111. }
112. // Clear out old views
113. detachAllViewsFromParent();
114. switch (mLayoutMode) {
115. case LAYOUT_SET_SELECTION:
116. if (newSel != null) {
117. sel = fillFromSelection(newSel.getTop(), childrenTop, childrenBottom);
118. } else {
119. sel = fillFromMiddle(childrenTop, childrenBottom);
120. }
121. break;
122. case LAYOUT_SYNC:
123. sel = fillSpecific(mSyncPosition, mSpecificTop);
124. break;
125. case LAYOUT_FORCE_BOTTOM:
126. sel = fillUp(mItemCount - 1, childrenBottom);
127. adjustViewsUpOrDown();
128. break;
129. case LAYOUT_FORCE_TOP:
130. mFirstPosition = 0;
131. sel = fillFromTop(childrenTop);
132. adjustViewsUpOrDown();
133. break;
134. case LAYOUT_SPECIFIC:
135. sel = fillSpecific(reconcileSelectedPosition(), mSpecificTop);
136. break;
137. case LAYOUT_MOVE_SELECTION:
138. sel = moveSelection(oldSel, newSel, delta, childrenTop, childrenBottom);
139. break;
140. default:
141. if (childCount == 0) {
142. if (!mStackFromBottom) {
143. final int position = lookForSelectablePosition(0, true);
144. setSelectedPositionInt(position);
145. sel = fillFromTop(childrenTop);
146. } else {
147. final int position = lookForSelectablePosition(mItemCount - 1, false);
148. setSelectedPositionInt(position);
149. sel = fillUp(mItemCount - 1, childrenBottom);
150. }
151. } else {
152. if (mSelectedPosition >= 0 && mSelectedPosition < mItemCount) {
153. sel = fillSpecific(mSelectedPosition,
154. oldSel == null ? childrenTop : oldSel.getTop());
155. } else if (mFirstPosition < mItemCount) {
156. sel = fillSpecific(mFirstPosition,
157. oldFirst == null ? childrenTop : oldFirst.getTop());
158. } else {
159. sel = fillSpecific(0, childrenTop);
160. }
161. }
162. break;
163. }
164. // Flush any cached views that did not get reused above
165. recycleBin.scrapActiveViews();
166. if (sel != null) {
167. // the current selected item should get focus if items
168. // are focusable
169. if (mItemsCanFocus && hasFocus() && !sel.hasFocus()) {
170. final boolean focusWasTaken = (sel == focusLayoutRestoreDirectChild &&
171. focusLayoutRestoreView.requestFocus()) || sel.requestFocus();
172. if (!focusWasTaken) {
173. // selected item didn't take focus, fine, but still want
174. // to make sure something else outside of the selected view
175. // has focus
176. final View focused = getFocusedChild();
177. if (focused != null) {
178. focused.clearFocus();
179. }
180. positionSelector(sel);
181. } else {
182. sel.setSelected(false);
183. mSelectorRect.setEmpty();
184. }
185. } else {
186. positionSelector(sel);
187. }
188. mSelectedTop = sel.getTop();
189. } else {
190. if (mTouchMode > TOUCH_MODE_DOWN && mTouchMode < TOUCH_MODE_SCROLL) {
191. View child = getChildAt(mMotionPosition - mFirstPosition);
192. if (child != null) positionSelector(child);
193. } else {
194. mSelectedTop = 0;
195. mSelectorRect.setEmpty();
196. }
197. // even if there is not selected position, we may need to restore
198. // focus (i.e. something focusable in touch mode)
199. if (hasFocus() && focusLayoutRestoreView != null) {
200. focusLayoutRestoreView.requestFocus();
201. }
202. }
203. // tell focus view we are done mucking with it, if it is still in
204. // our view hierarchy.
205. if (focusLayoutRestoreView != null
206. && focusLayoutRestoreView.getWindowToken() != null) {
207. focusLayoutRestoreView.onFinishTemporaryDetach();
208. }
209. mLayoutMode = LAYOUT_NORMAL;
210. mDataChanged = false;
211. mNeedSync = false;
212. setNextSelectedPositionInt(mSelectedPosition);
213. updateScrollIndicators();
214. if (mItemCount > 0) {
215. checkSelectionChanged();
216. }
217. invokeOnItemScrollListener();
218. } finally {
219. if (!blockLayoutRequests) {
220. mBlockLayoutRequests = false;
221. }
222. }
223. }

1. /**
2. * Put a specific item at a specific location on the screen and then build
3. * up and down from there.
4. *
5. * @param position The reference view to use as the starting point
6. * @param top Pixel offset from the top of this view to the top of the
7. *        reference view.
8. *
9. * @return The selected view, or null if the selected view is outside the
10. *         visible area.
11. */
12. private View fillSpecific(int position, int top) {
13. boolean tempIsSelected = position == mSelectedPosition;
14. View temp = makeAndAddView(position, top, true, mListPadding.left, tempIsSelected);
15. // Possibly changed again in fillUp if we add rows above this one.
16. mFirstPosition = position;
17. View above;
18. View below;
19. final int dividerHeight = mDividerHeight;
20. if (!mStackFromBottom) {
21. above = fillUp(position - 1, temp.getTop() - dividerHeight);
22. // This will correct for the top of the first view not touching the top of the list
23. adjustViewsUpOrDown();
24. below = fillDown(position + 1, temp.getBottom() + dividerHeight);
25. int childCount = getChildCount();
26. if (childCount > 0) {
27. correctTooHigh(childCount);
28. }
29. } else {
30. below = fillDown(position + 1, temp.getBottom() + dividerHeight);
31. // This will correct for the bottom of the last view not touching the bottom of the list
32. adjustViewsUpOrDown();
33. above = fillUp(position - 1, temp.getTop() - dividerHeight);
34. int childCount = getChildCount();
35. if (childCount > 0) {
36. correctTooLow(childCount);
37. }
38. }
39. if (tempIsSelected) {
40. return temp;
41. } else if (above != null) {
42. return above;
43. } else {
44. return below;
45. }
46. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Add a view as a child and make sure it is measured (if necessary) and
3. * positioned properly.
4. *
5. * @param child The view to add
6. * @param position The position of this child
7. * @param y The y position relative to which this view will be positioned
8. * @param flowDown If true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @param recycled Has this view been pulled from the recycle bin? If so it
13. *        does not need to be remeasured.
14. */
15. private void setupChild(View child, int position, int y, boolean flowDown, int childrenLeft,
16. boolean selected, boolean recycled) {
17. final boolean isSelected = selected && shouldShowSelector();
18. final boolean updateChildSelected = isSelected != child.isSelected();
19. final int mode = mTouchMode;
20. final boolean isPressed = mode > TOUCH_MODE_DOWN && mode < TOUCH_MODE_SCROLL &&
21. mMotionPosition == position;
22. final boolean updateChildPressed = isPressed != child.isPressed();
23. final boolean needToMeasure = !recycled || updateChildSelected || child.isLayoutRequested();
24. // Respect layout params that are already in the view. Otherwise make some up...
25. // noinspection unchecked
26. AbsListView.LayoutParams p = (AbsListView.LayoutParams) child.getLayoutParams();
27. if (p == null) {
28. p = new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
29. ViewGroup.LayoutParams.WRAP_CONTENT, 0);
30. }
31. p.viewType = mAdapter.getItemViewType(position);
32. if ((recycled && !p.forceAdd) || (p.recycledHeaderFooter &&
33. p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER)) {
34. attachViewToParent(child, flowDown ? -1 : 0, p);
35. } else {
36. p.forceAdd = false;
37. if (p.viewType == AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER) {
38. p.recycledHeaderFooter = true;
39. }
40. addViewInLayout(child, flowDown ? -1 : 0, p, true);
41. }
42. if (updateChildSelected) {
43. child.setSelected(isSelected);
44. }
45. if (updateChildPressed) {
46. child.setPressed(isPressed);
47. }
48. if (needToMeasure) {
49. int childWidthSpec = ViewGroup.getChildMeasureSpec(mWidthMeasureSpec,
50. mListPadding.left + mListPadding.right, p.width);
51. int lpHeight = p.height;
52. int childHeightSpec;
53. if (lpHeight > 0) {
54. childHeightSpec = MeasureSpec.makeMeasureSpec(lpHeight, MeasureSpec.EXACTLY);
55. } else {
56. childHeightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED);
57. }
58. child.measure(childWidthSpec, childHeightSpec);
59. } else {
60. cleanupLayoutState(child);
61. }
62. final int w = child.getMeasuredWidth();
63. final int h = child.getMeasuredHeight();
64. final int childTop = flowDown ? y : y - h;
65. if (needToMeasure) {
66. final int childRight = childrenLeft + w;
67. final int childBottom = childTop + h;
68. child.layout(childrenLeft, childTop, childRight, childBottom);
69. } else {
70. child.offsetLeftAndRight(childrenLeft - child.getLeft());
71. child.offsetTopAndBottom(childTop - child.getTop());
72. }
73. if (mCachingStarted && !child.isDrawingCacheEnabled()) {
74. child.setDrawingCacheEnabled(true);
75. }
76. }

1. @Override
2. public boolean onTouchEvent(MotionEvent ev) {
3. if (!isEnabled()) {
4. // A disabled view that is clickable still consumes the touch
5. // events, it just doesn't respond to them.
6. return isClickable() || isLongClickable();
7. }
8. final int action = ev.getAction();
9. View v;
10. int deltaY;
11. if (mVelocityTracker == null) {
12. mVelocityTracker = VelocityTracker.obtain();
13. }
14. mVelocityTracker.addMovement(ev);
15. switch (action & MotionEvent.ACTION_MASK) {
16. case MotionEvent.ACTION_DOWN: {
17. mActivePointerId = ev.getPointerId(0);
18. final int x = (int) ev.getX();
19. final int y = (int) ev.getY();
20. int motionPosition = pointToPosition(x, y);
21. if (!mDataChanged) {
22. if ((mTouchMode != TOUCH_MODE_FLING) && (motionPosition >= 0)
23. && (getAdapter().isEnabled(motionPosition))) {
24. // User clicked on an actual view (and was not stopping a
25. // fling). It might be a
26. // click or a scroll. Assume it is a click until proven
27. // otherwise
28. mTouchMode = TOUCH_MODE_DOWN;
29. // FIXME Debounce
30. if (mPendingCheckForTap == null) {
31. mPendingCheckForTap = new CheckForTap();
32. }
33. postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
34. } else {
35. if (ev.getEdgeFlags() != 0 && motionPosition < 0) {
36. // If we couldn't find a view to click on, but the down
37. // event was touching
38. // the edge, we will bail out and try again. This allows
39. // the edge correcting
40. // code in ViewRoot to try to find a nearby view to
41. // select
42. return false;
43. }
44. if (mTouchMode == TOUCH_MODE_FLING) {
45. // Stopped a fling. It is a scroll.
46. createScrollingCache();
47. mTouchMode = TOUCH_MODE_SCROLL;
48. mMotionCorrection = 0;
49. motionPosition = findMotionRow(y);
50. reportScrollStateChange(OnScrollListener.SCROLL_STATE_TOUCH_SCROLL);
51. }
52. }
53. }
54. if (motionPosition >= 0) {
55. // Remember where the motion event started
56. v = getChildAt(motionPosition - mFirstPosition);
57. mMotionViewOriginalTop = v.getTop();
58. }
59. mMotionX = x;
60. mMotionY = y;
61. mMotionPosition = motionPosition;
62. mLastY = Integer.MIN_VALUE;
63. break;
64. }
65. case MotionEvent.ACTION_MOVE: {
66. final int pointerIndex = ev.findPointerIndex(mActivePointerId);
67. final int y = (int) ev.getY(pointerIndex);
68. deltaY = y - mMotionY;
69. switch (mTouchMode) {
70. case TOUCH_MODE_DOWN:
71. case TOUCH_MODE_TAP:
72. case TOUCH_MODE_DONE_WAITING:
73. // Check if we have moved far enough that it looks more like a
74. // scroll than a tap
75. startScrollIfNeeded(deltaY);
76. break;
77. case TOUCH_MODE_SCROLL:
78. if (PROFILE_SCROLLING) {
79. if (!mScrollProfilingStarted) {
80. Debug.startMethodTracing("AbsListViewScroll");
81. mScrollProfilingStarted = true;
82. }
83. }
84. if (y != mLastY) {
85. deltaY -= mMotionCorrection;
86. int incrementalDeltaY = mLastY != Integer.MIN_VALUE ? y - mLastY : deltaY;
87. // No need to do all this work if we're not going to move
88. // anyway
89. boolean atEdge = false;
90. if (incrementalDeltaY != 0) {
91. atEdge = trackMotionScroll(deltaY, incrementalDeltaY);
92. }
93. // Check to see if we have bumped into the scroll limit
94. if (atEdge && getChildCount() > 0) {
95. // Treat this like we're starting a new scroll from the
96. // current
97. // position. This will let the user start scrolling back
98. // into
99. // content immediately rather than needing to scroll
100. // back to the
101. // point where they hit the limit first.
102. int motionPosition = findMotionRow(y);
103. if (motionPosition >= 0) {
104. final View motionView = getChildAt(motionPosition - mFirstPosition);
105. mMotionViewOriginalTop = motionView.getTop();
106. }
107. mMotionY = y;
108. mMotionPosition = motionPosition;
109. invalidate();
110. }
111. mLastY = y;
112. }
113. break;
114. }
115. break;
116. }
117. case MotionEvent.ACTION_UP: {
118. switch (mTouchMode) {
119. case TOUCH_MODE_DOWN:
120. case TOUCH_MODE_TAP:
121. case TOUCH_MODE_DONE_WAITING:
122. final int motionPosition = mMotionPosition;
123. final View child = getChildAt(motionPosition - mFirstPosition);
124. if (child != null && !child.hasFocusable()) {
125. if (mTouchMode != TOUCH_MODE_DOWN) {
126. child.setPressed(false);
127. }
128. if (mPerformClick == null) {
129. mPerformClick = new PerformClick();
130. }
131. final AbsListView.PerformClick performClick = mPerformClick;
132. performClick.mChild = child;
133. performClick.mClickMotionPosition = motionPosition;
134. performClick.rememberWindowAttachCount();
135. mResurrectToPosition = motionPosition;
136. if (mTouchMode == TOUCH_MODE_DOWN || mTouchMode == TOUCH_MODE_TAP) {
137. final Handler handler = getHandler();
138. if (handler != null) {
139. handler.removeCallbacks(mTouchMode == TOUCH_MODE_DOWN ? mPendingCheckForTap
140. : mPendingCheckForLongPress);
141. }
142. mLayoutMode = LAYOUT_NORMAL;
143. if (!mDataChanged && mAdapter.isEnabled(motionPosition)) {
144. mTouchMode = TOUCH_MODE_TAP;
145. setSelectedPositionInt(mMotionPosition);
146. layoutChildren();
147. child.setPressed(true);
148. positionSelector(child);
149. setPressed(true);
150. if (mSelector != null) {
151. Drawable d = mSelector.getCurrent();
152. if (d != null && d instanceof TransitionDrawable) {
153. ((TransitionDrawable) d).resetTransition();
154. }
155. }
156. postDelayed(new Runnable() {
157. public void run() {
158. child.setPressed(false);
159. setPressed(false);
160. if (!mDataChanged) {
161. post(performClick);
162. }
163. mTouchMode = TOUCH_MODE_REST;
164. }
165. }, ViewConfiguration.getPressedStateDuration());
166. } else {
167. mTouchMode = TOUCH_MODE_REST;
168. }
169. return true;
170. } else if (!mDataChanged && mAdapter.isEnabled(motionPosition)) {
171. post(performClick);
172. }
173. }
174. mTouchMode = TOUCH_MODE_REST;
175. break;
176. case TOUCH_MODE_SCROLL:
177. final int childCount = getChildCount();
178. if (childCount > 0) {
179. if (mFirstPosition == 0
180. && getChildAt(0).getTop() >= mListPadding.top
181. && mFirstPosition + childCount < mItemCount
182. && getChildAt(childCount - 1).getBottom() <= getHeight()
183. - mListPadding.bottom) {
184. mTouchMode = TOUCH_MODE_REST;
185. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
186. } else {
187. final VelocityTracker velocityTracker = mVelocityTracker;
188. velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
189. final int initialVelocity = (int) velocityTracker
190. .getYVelocity(mActivePointerId);
191. if (Math.abs(initialVelocity) > mMinimumVelocity) {
192. if (mFlingRunnable == null) {
193. mFlingRunnable = new FlingRunnable();
194. }
195. reportScrollStateChange(OnScrollListener.SCROLL_STATE_FLING);
196. mFlingRunnable.start(-initialVelocity);
197. } else {
198. mTouchMode = TOUCH_MODE_REST;
199. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
200. }
201. }
202. } else {
203. mTouchMode = TOUCH_MODE_REST;
204. reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
205. }
206. break;
207. }
208. setPressed(false);
209. // Need to redraw since we probably aren't drawing the selector
210. // anymore
211. invalidate();
212. final Handler handler = getHandler();
213. if (handler != null) {
214. handler.removeCallbacks(mPendingCheckForLongPress);
215. }
216. if (mVelocityTracker != null) {
217. mVelocityTracker.recycle();
218. mVelocityTracker = null;
219. }
220. mActivePointerId = INVALID_POINTER;
221. if (PROFILE_SCROLLING) {
222. if (mScrollProfilingStarted) {
223. Debug.stopMethodTracing();
224. mScrollProfilingStarted = false;
225. }
226. }
227. break;
228. }
229. case MotionEvent.ACTION_CANCEL: {
230. mTouchMode = TOUCH_MODE_REST;
231. setPressed(false);
232. View motionView = this.getChildAt(mMotionPosition - mFirstPosition);
233. if (motionView != null) {
234. motionView.setPressed(false);
235. }
236. clearScrollingCache();
237. final Handler handler = getHandler();
238. if (handler != null) {
239. handler.removeCallbacks(mPendingCheckForLongPress);
240. }
241. if (mVelocityTracker != null) {
242. mVelocityTracker.recycle();
243. mVelocityTracker = null;
244. }
245. mActivePointerId = INVALID_POINTER;
246. break;
247. }
248. case MotionEvent.ACTION_POINTER_UP: {
249. onSecondaryPointerUp(ev);
250. final int x = mMotionX;
251. final int y = mMotionY;
252. final int motionPosition = pointToPosition(x, y);
253. if (motionPosition >= 0) {
254. // Remember where the motion event started
255. v = getChildAt(motionPosition - mFirstPosition);
256. mMotionViewOriginalTop = v.getTop();
257. mMotionPosition = motionPosition;
258. }
259. mLastY = y;
260. break;
261. }
262. }
263. return true;
264. }

1. boolean trackMotionScroll(int deltaY, int incrementalDeltaY) {
2. final int childCount = getChildCount();
3. if (childCount == 0) {
4. return true;
5. }
6. final int firstTop = getChildAt(0).getTop();
7. final int lastBottom = getChildAt(childCount - 1).getBottom();
8. final Rect listPadding = mListPadding;
9. final int spaceAbove = listPadding.top - firstTop;
10. final int end = getHeight() - listPadding.bottom;
11. final int spaceBelow = lastBottom - end;
12. final int height = getHeight() - getPaddingBottom() - getPaddingTop();
13. if (deltaY < 0) {
14. deltaY = Math.max(-(height - 1), deltaY);
15. } else {
16. deltaY = Math.min(height - 1, deltaY);
17. }
18. if (incrementalDeltaY < 0) {
19. incrementalDeltaY = Math.max(-(height - 1), incrementalDeltaY);
20. } else {
21. incrementalDeltaY = Math.min(height - 1, incrementalDeltaY);
22. }
23. final int firstPosition = mFirstPosition;
24. if (firstPosition == 0 && firstTop >= listPadding.top && deltaY >= 0) {
25. // Don't need to move views down if the top of the first position
26. // is already visible
27. return true;
28. }
29. if (firstPosition + childCount == mItemCount && lastBottom <= end && deltaY <= 0) {
30. // Don't need to move views up if the bottom of the last position
31. // is already visible
32. return true;
33. }
34. final boolean down = incrementalDeltaY < 0;
35. final boolean inTouchMode = isInTouchMode();
36. if (inTouchMode) {
37. hideSelector();
38. }
39. final int headerViewsCount = getHeaderViewsCount();
40. final int footerViewsStart = mItemCount - getFooterViewsCount();
41. int start = 0;
42. int count = 0;
43. if (down) {
44. final int top = listPadding.top - incrementalDeltaY;
45. for (int i = 0; i < childCount; i++) {
46. final View child = getChildAt(i);
47. if (child.getBottom() >= top) {
48. break;
49. } else {
50. count++;
51. int position = firstPosition + i;
52. if (position >= headerViewsCount && position < footerViewsStart) {
53. mRecycler.addScrapView(child);
54. }
55. }
56. }
57. } else {
58. final int bottom = getHeight() - listPadding.bottom - incrementalDeltaY;
59. for (int i = childCount - 1; i >= 0; i--) {
60. final View child = getChildAt(i);
61. if (child.getTop() <= bottom) {
62. break;
63. } else {
64. start = i;
65. count++;
66. int position = firstPosition + i;
67. if (position >= headerViewsCount && position < footerViewsStart) {
68. mRecycler.addScrapView(child);
69. }
70. }
71. }
72. }
73. mMotionViewNewTop = mMotionViewOriginalTop + deltaY;
74. mBlockLayoutRequests = true;
75. if (count > 0) {
76. detachViewsFromParent(start, count);
77. }
78. offsetChildrenTopAndBottom(incrementalDeltaY);
79. if (down) {
80. mFirstPosition += count;
81. }
82. invalidate();
83. final int absIncrementalDeltaY = Math.abs(incrementalDeltaY);
84. if (spaceAbove < absIncrementalDeltaY || spaceBelow < absIncrementalDeltaY) {
85. fillGap(down);
86. }
87. if (!inTouchMode && mSelectedPosition != INVALID_POSITION) {
88. final int childIndex = mSelectedPosition - mFirstPosition;
89. if (childIndex >= 0 && childIndex < getChildCount()) {
90. positionSelector(getChildAt(childIndex));
91. }
92. }
93. mBlockLayoutRequests = false;
94. invokeOnItemScrollListener();
95. awakenScrollBars();
96. return false;
97. }

1. /**
2. * Fills the gap left open by a touch-scroll. During a touch scroll,
3. * children that remain on screen are shifted and the other ones are
4. * discarded. The role of this method is to fill the gap thus created by
5. * performing a partial layout in the empty space.
6. *
7. * @param down
8. *            true if the scroll is going down, false if it is going up
9. */
10. abstract void fillGap(boolean down);

1. void fillGap(boolean down) {
2. final int count = getChildCount();
3. if (down) {
4. final int startOffset = count > 0 ? getChildAt(count - 1).getBottom() + mDividerHeight :
5. getListPaddingTop();
6. fillDown(mFirstPosition + count, startOffset);
7. correctTooHigh(getChildCount());
8. } else {
9. final int startOffset = count > 0 ? getChildAt(0).getTop() - mDividerHeight :
10. getHeight() - getListPaddingBottom();
11. fillUp(mFirstPosition - 1, startOffset);
12. correctTooLow(getChildCount());
13. }
14. }

1. /**
2. * Obtain the view and add it to our list of children. The view can be made
3. * fresh, converted from an unused view, or used as is if it was in the
4. * recycle bin.
5. *
6. * @param position Logical position in the list
7. * @param y Top or bottom edge of the view to add
8. * @param flow If flow is true, align top edge to y. If false, align bottom
9. *        edge to y.
10. * @param childrenLeft Left edge where children should be positioned
11. * @param selected Is this position selected?
12. * @return View that was added
13. */
14. private View makeAndAddView(int position, int y, boolean flow, int childrenLeft,
15. boolean selected) {
16. View child;
17. if (!mDataChanged) {
18. // Try to use an exsiting view for this position
19. child = mRecycler.getActiveView(position);
20. if (child != null) {
21. // Found it -- we're using an existing child
22. // This just needs to be positioned
23. setupChild(child, position, y, flow, childrenLeft, selected, true);
24. return child;
25. }
26. }
27. // Make a new view for this position, or convert an unused view if possible
28. child = obtainView(position, mIsScrap);
29. // This needs to be positioned and measured
30. setupChild(child, position, y, flow, childrenLeft, selected, mIsScrap[0]);
31. return child;
32. }

1. /**
2. * Get a view and have it show the data associated with the specified
3. * position. This is called when we have already discovered that the view is
4. * not available for reuse in the recycle bin. The only choices left are
5. * converting an old view or making a new one.
6. *
7. * @param position
8. *            The position to display
9. * @param isScrap
10. *            Array of at least 1 boolean, the first entry will become true
11. *            if the returned view was taken from the scrap heap, false if
12. *            otherwise.
13. *
14. * @return A view displaying the data associated with the specified position
15. */
16. View obtainView(int position, boolean[] isScrap) {
17. isScrap[0] = false;
18. View scrapView;
19. scrapView = mRecycler.getScrapView(position);
20. View child;
21. if (scrapView != null) {
22. child = mAdapter.getView(position, scrapView, this);
23. if (child != scrapView) {
24. mRecycler.addScrapView(scrapView);
25. if (mCacheColorHint != 0) {
26. child.setDrawingCacheBackgroundColor(mCacheColorHint);
27. }
28. } else {
29. isScrap[0] = true;
30. dispatchFinishTemporaryDetach(child);
31. }
32. } else {
33. child = mAdapter.getView(position, null, this);
34. if (mCacheColorHint != 0) {
35. child.setDrawingCacheBackgroundColor(mCacheColorHint);
36. }
37. }
38. return child;
39. }

1. @Override
2. public View getView(int position, View convertView, ViewGroup parent) {
3. Fruit fruit = getItem(position);
4. View view;
5. if (convertView == null) {
6. view = LayoutInflater.from(getContext()).inflate(resourceId, null);
7. } else {
8. view = convertView;
9. }
10. ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);
11. TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);
12. fruitImage.setImageResource(fruit.getImageId());
13. fruitName.setText(fruit.getName());
14. return view;
15. }

1. @Override
2. public View getView(int position, View convertView, ViewGroup parent) {
3. Fruit fruit = getItem(position);
4. View view;
5. if (convertView == null) {
6. view = LayoutInflater.from(getContext()).inflate(resourceId, null);
7. } else {
8. view = convertView;
9. }
10. ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);
11. TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);
12. fruitImage.setImageResource(fruit.getImageId());
13. fruitName.setText(fruit.getName());
14. return view;
15. }