/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.tencent.widget;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;
import android.annotation.SuppressLint;
import android.annotation.TargetApi;
import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Rect;
import android.graphics.drawable.Drawable;
import android.graphics.drawable.TransitionDrawable;
import android.os.Build;
import android.os.Debug;
import android.os.Handler;
import android.os.Parcel;
import android.os.Parcelable;
import android.os.StrictMode;
import android.text.Editable;
import android.text.TextUtils;
import android.text.TextWatcher;
import android.util.AttributeSet;
import android.util.Log;
import android.util.SparseBooleanArray;
import android.view.ActionMode;
import android.view.ContextMenu.ContextMenuInfo;
import android.view.Gravity;
import android.view.HapticFeedbackConstants;
import android.view.InputDevice;
import android.view.KeyEvent;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuItem;
import android.view.MotionEvent;
import android.view.VelocityTracker;
import android.view.View;
import android.view.ViewConfiguration;
import android.view.ViewDebug;
import android.view.ViewGroup;
import android.view.ViewParent;
import android.view.ViewTreeObserver;
import android.view.accessibility.AccessibilityEvent;
import android.view.animation.AnimationUtils;
import android.view.inputmethod.BaseInputConnection;
import android.view.inputmethod.EditorInfo;
import android.view.inputmethod.InputConnection;
import android.view.inputmethod.InputConnectionWrapper;
import android.view.inputmethod.InputMethodManager;
import android.widget.Adapter;
import android.widget.EditText;
import android.widget.Filter;
import android.widget.Filterable;
import android.widget.ListAdapter;
import android.widget.PopupWindow;
import android.widget.SectionIndexer;
import com.example.expandablelistview.R;
import com.tencent.util.ReflectedMethods;
import com.tencent.util.AnimateUtils;
import com.tencent.util.LongSparseArray;
import com.tencent.util.VersionUtils;
/**
* Base class that can be used to implement virtualized lists of items. A list does not have a spatial definition here.
* For instance, subclases of this class can display the content of the list in a grid, in a carousel, as stack, etc.
*
* @attr ref android.R.styleable#AbsListView_listSelector
* @attr ref android.R.styleable#AbsListView_drawSelectorOnTop
* @attr ref android.R.styleable#AbsListView_stackFromBottom
* @attr ref android.R.styleable#AbsListView_scrollingCache
* @attr ref android.R.styleable#AbsListView_textFilterEnabled
* @attr ref android.R.styleable#AbsListView_transcriptMode
* @attr ref android.R.styleable#AbsListView_cacheColorHint
* @attr ref android.R.styleable#AbsListView_fastScrollEnabled
* @attr ref android.R.styleable#AbsListView_smoothScrollbar
* @attr ref android.R.styleable#AbsListView_choiceMode
*/
public abstract class AbsListView extends AdapterView<ListAdapter> implements TextWatcher,
ViewTreeObserver.OnGlobalLayoutListener, Filter.FilterListener, ViewTreeObserver.OnTouchModeChangeListener
/* ,RemoteViewsAdapter.RemoteAdapterConnectionCallback */
{
/**
* 超出屏幕后, 最多滑行的距离, 默认30DP
*/
private static final int OVER_FLING_DISTANCE = 30;
/**
* Disables the transcript mode.
*
* @see #setTranscriptMode(int)
*/
public static final int TRANSCRIPT_MODE_DISABLED = 0;
/**
* The list will automatically scroll to the bottom when a data set change notification is received and only if the
* last item is already visible on screen.
*
* @see #setTranscriptMode(int)
*/
public static final int TRANSCRIPT_MODE_NORMAL = 1;
/**
* The list will automatically scroll to the bottom, no matter what items are currently visible.
*
* @see #setTranscriptMode(int)
*/
public static final int TRANSCRIPT_MODE_ALWAYS_SCROLL = 2;
/**
* Indicates that we are not in the middle of a touch gesture
*/
static final int TOUCH_MODE_REST = -1;
/**
* Indicates we just received the touch event and we are waiting to see if the it is a tap or a scroll gesture.
*/
static final int TOUCH_MODE_DOWN = 0;
/**
* Indicates the touch has been recognized as a tap and we are now waiting to see if the touch is a longpress
*/
static final int TOUCH_MODE_TAP = 1;
/**
* Indicates we have waited for everything we can wait for, but the user's finger is still down
*/
static final int TOUCH_MODE_DONE_WAITING = 2;
/**
* Indicates the touch gesture is a scroll
*/
static final int TOUCH_MODE_SCROLL = 3;
/**
* Indicates the view is in the process of being flung
*/
static final int TOUCH_MODE_FLING = 4;
/**
* Indicates the touch gesture is an overscroll - a scroll beyond the beginning or end.
*/
static final int TOUCH_MODE_OVERSCROLL = 5;
/**
* Indicates the view is being flung outside of normal content bounds and will spring back.
*/
static final int TOUCH_MODE_OVERFLING = 6;
/**
* Regular layout - usually an unsolicited layout from the view system
*/
static final int LAYOUT_NORMAL = 0;
/**
* Show the first item
*/
static final int LAYOUT_FORCE_TOP = 1;
/**
* Force the selected item to be on somewhere on the screen
*/
static final int LAYOUT_SET_SELECTION = 2;
/**
* Show the last item
*/
static final int LAYOUT_FORCE_BOTTOM = 3;
/**
* Make a mSelectedItem appear in a specific location and build the rest of the views from there. The top is
* specified by mSpecificTop.
*/
static final int LAYOUT_SPECIFIC = 4;
static final int LAYOUT_SPECIFIC_BOTTOM = 100;
/**
* Layout to sync as a result of a data change. Restore mSyncPosition to have its top at mSpecificTop
*/
static final int LAYOUT_SYNC = 5;
/**
* Layout as a result of using the navigation keys
*/
static final int LAYOUT_MOVE_SELECTION = 6;
/**
* Normal list that does not indicate choices
*/
public static final int CHOICE_MODE_NONE = 0;
/**
* The list allows up to one choice
*/
public static final int CHOICE_MODE_SINGLE = 1;
/**
* The list allows multiple choices
*/
public static final int CHOICE_MODE_MULTIPLE = 2;
/**
* The list allows multiple choices in a modal selection mode
*/
public static final int CHOICE_MODE_MULTIPLE_MODAL = 3;
/**
* Controls if/how the user may choose/check items in the list
*/
int mChoiceMode = CHOICE_MODE_NONE;
/**
* Controls CHOICE_MODE_MULTIPLE_MODAL. null when inactive.
*/
ActionMode mChoiceActionMode;
/**
* Wrapper for the multiple choice mode callback; AbsListView needs to perform a few extra actions around what
* application code does.
*/
MultiChoiceModeWrapper mMultiChoiceModeCallback;
/**
* Running count of how many items are currently checked
*/
int mCheckedItemCount;
/**
* Running state of which positions are currently checked
*/
SparseBooleanArray mCheckStates;
/**
* Running state of which IDs are currently checked. If there is a value for a given key, the checked state for that
* ID is true and the value holds the last known position in the adapter for that id.
*/
LongSparseArray<Integer> mCheckedIdStates;
/**
* Controls how the next layout will happen
*/
int mLayoutMode = LAYOUT_NORMAL;
/**
* Should be used by subclasses to listen to changes in the dataset
*/
AdapterDataSetObserver mDataSetObserver;
/**
* The adapter containing the data to be displayed by this view
*/
ListAdapter mAdapter;
private boolean mEdgeEffectEnabled = false;
// /**
// * The remote adapter containing the data to be displayed by this view to be set
// */
// private RemoteViewsAdapter mRemoteAdapter;
/**
* This flag indicates the a full notify is required when the RemoteViewsAdapter connects
*/
private boolean mDeferNotifyDataSetChanged = false;
/**
* Indicates whether the list selector should be drawn on top of the children or behind
*/
boolean mDrawSelectorOnTop = false;
/**
* The drawable used to draw the selector
*/
Drawable mSelector;
/**
* The current position of the selector in the list.
*/
int mSelectorPosition = INVALID_POSITION;
/**
* Defines the selector's location and dimension at drawing time
*/
Rect mSelectorRect = new Rect();
/**
* The data set used to store unused views that should be reused during the next layout to avoid creating new ones
*/
final RecycleBin mRecycler = new RecycleBin();
/**
* The selection's left padding
*/
int mSelectionLeftPadding = 0;
/**
* The selection's top padding
*/
int mSelectionTopPadding = 0;
/**
* The selection's right padding
*/
int mSelectionRightPadding = 0;
/**
* The selection's bottom padding
*/
int mSelectionBottomPadding = 0;
/**
* This view's padding
*/
Rect mListPadding = new Rect();
/**
* Subclasses must retain their measure spec from onMeasure() into this member
*/
int mWidthMeasureSpec = 0;
/**
* The top scroll indicator
*/
View mScrollUp;
/**
* The down scroll indicator
*/
View mScrollDown;
/**
* When the view is scrolling, this flag is set to true to indicate subclasses that the drawing cache was enabled on
* the children
*/
boolean mCachingStarted;
boolean mCachingActive;
/**
* The position of the view that received the down motion event
*/
int mMotionPosition;
/**
* The offset to the top of the mMotionPosition view when the down motion event was received
*/
int mMotionViewOriginalTop;
/**
* The desired offset to the top of the mMotionPosition view after a scroll
*/
int mMotionViewNewTop;
/**
* The X value associated with the the down motion event
*/
int mMotionX;
/**
* The Y value associated with the the down motion event
*/
int mMotionY;
/**
* One of TOUCH_MODE_REST, TOUCH_MODE_DOWN, TOUCH_MODE_TAP, TOUCH_MODE_SCROLL, or TOUCH_MODE_DONE_WAITING
*/
int mTouchMode = TOUCH_MODE_REST;
/**
* Y value from on the previous motion event (if any)
*/
int mLastY;
/**
* How far the finger moved before we started scrolling
*/
int mMotionCorrection;
/**
* Determines speed during touch scrolling
*/
private VelocityTracker mVelocityTracker;
/**
* Handles one frame of a fling
*/
private FlingRunnable mFlingRunnable;
/**
* Handles scrolling between positions within the list.
*/
private PositionScroller mPositionScroller;
/**
* The offset in pixels form the top of the AdapterView to the top of the currently selected view. Used to save and
* restore state.
*/
int mSelectedTop = 0;
/**
* Indicates whether the list is stacked from the bottom edge or the top edge.
*/
boolean mStackFromBottom;
/**
* When set to true, the list automatically discards the children's bitmap cache after scrolling.
*/
boolean mScrollingCacheEnabled;
/**
* Whether or not to enable the fast scroll feature on this list
*/
boolean mFastScrollEnabled;
/**
* Optional callback to notify client when scroll position has changed
*/
private OnScrollListener mOnScrollListener;
/**
* Keeps track of our accessory window
*/
PopupWindow mPopup;
/**
* Used with type filter window
*/
EditText mTextFilter;
/**
* Indicates whether to use pixels-based or position-based scrollbar properties.
*/
private boolean mSmoothScrollbarEnabled = true;
/**
* Indicates that this view supports filtering
*/
private boolean mTextFilterEnabled;
/**
* Indicates that this view is currently displaying a filtered view of the data
*/
private boolean mFiltered;
/**
* Rectangle used for hit testing children
*/
private Rect mTouchFrame;
/**
* The position to resurrect the selected position to.
*/
int mResurrectToPosition = INVALID_POSITION;
private ContextMenuInfo mContextMenuInfo = null;
/**
* Maximum distance to record overscroll
*/
int mOverscrollMax;
/**
* Content height divided by this is the overscroll limit.
*/
static final int OVERSCROLL_LIMIT_DIVISOR = 3;
/**
* How many positions in either direction we will search to try to find a checked item with a stable ID that moved
* position across a data set change. If the item isn't found it will be unselected.
*/
private static final int CHECK_POSITION_SEARCH_DISTANCE = 20;
/**
* Used to request a layout when we changed touch mode
*/
private static final int TOUCH_MODE_UNKNOWN = -1;
private static final int TOUCH_MODE_ON = 0;
private static final int TOUCH_MODE_OFF = 1;
private int mLastTouchMode = TOUCH_MODE_UNKNOWN;
private static final boolean PROFILE_SCROLLING = false;
private boolean mScrollProfilingStarted = false;
private static final boolean PROFILE_FLINGING = false;
private boolean mFlingProfilingStarted = false;
/**
* The StrictMode "critical time span" objects to catch animation stutters. Non-null when a time-sensitive animation
* is in-flight. Must call finish() on them when done animating. These are no-ops on user builds.
*/
private Object mScrollStrictSpan = null;
private Object mFlingStrictSpan = null;
/**
* The last CheckForLongPress runnable we posted, if any
*/
private CheckForLongPress mPendingCheckForLongPress;
/**
* The last CheckForTap runnable we posted, if any
*/
private Runnable mPendingCheckForTap;
/**
* The last CheckForKeyLongPress runnable we posted, if any
*/
private CheckForKeyLongPress mPendingCheckForKeyLongPress;
/**
* Acts upon click
*/
private AbsListView.PerformClick mPerformClick;
/**
* Delayed action for touch mode.
*/
private Runnable mTouchModeReset;
/**
* This view is in transcript mode -- it shows the bottom of the list when the data changes
*/
private int mTranscriptMode;
/**
* Indicates that this list is always drawn on top of a solid, single-color, opaque background
*/
int mCacheColorHint;
/**
* The select child's view (from the adapter's getView) is enabled.
*/
private boolean mIsChildViewEnabled;
/**
* The last scroll state reported to clients through {@link OnScrollListener}.
*/
private int mLastScrollState = OnScrollListener.SCROLL_STATE_IDLE;
/**
* Helper object that renders and controls the fast scroll thumb.
*/
FastScroller mFastScroller;
private boolean mGlobalLayoutListenerAddedFilter;
private int mTouchSlop;
private float mDensityScale;
private InputConnection mDefInputConnection;
private InputConnectionWrapper mPublicInputConnection;
private Runnable mClearScrollingCache;
private int mMinimumVelocity;
private int mMaximumVelocity;
private float mVelocityScale = 1.0f;
final boolean[] mIsScrap = new boolean[1];
// True when the popup should be hidden because of a call to
// dispatchDisplayHint()
private boolean mPopupHidden;
/**
* ID of the active pointer. This is used to retain consistency during drags/flings if multiple pointers are used.
*/
private int mActivePointerId = INVALID_POINTER;
/**
* Sentinel value for no current active pointer. Used by {@link #mActivePointerId}.
*/
private static final int INVALID_POINTER = -1;
/**
* Maximum distance to overscroll by during edge effects
*/
int mOverscrollDistance;
/**
* Maximum distance to overfling during edge effects
*/
int mTopOverflingDistance;
int mBottomOverflingDistance;
// These two EdgeGlows are always set and used together.
// Checking one for null is as good as checking both.
/**
* Tracks the state of the top edge glow.
*/
// private EdgeEffect mEdgeGlowTop;
/**
* Tracks the state of the bottom edge glow.
*/
// private EdgeEffect mEdgeGlowBottom;
/**
* An estimate of how many pixels are between the top of the list and the top of the first position in the adapter,
* based on the last time we saw it. Used to hint where to draw edge glows.
*/
private int mFirstPositionDistanceGuess;
/**
* An estimate of how many pixels are between the bottom of the list and the bottom of the last position in the
* adapter, based on the last time we saw it. Used to hint where to draw edge glows.
*/
private int mLastPositionDistanceGuess;
/**
* Used for determining when to cancel out of overscroll.
*/
private int mDirection = 0;
/**
* Tracked on measurement in transcript mode. Makes sure that we can still pin to the bottom correctly on resizes.
*/
private boolean mForceTranscriptScroll;
protected boolean mScrollToBottom;
private int mGlowPaddingLeft;
private int mGlowPaddingRight;
private int mLastAccessibilityScrollEventFromIndex;
private int mLastAccessibilityScrollEventToIndex;
/**
* Track if we are currently attached to a window.
*/
boolean mIsAttached;
/**
* Track the item count from the last time we handled a data change.
*/
private int mLastHandledItemCount;
private int mOverScrollMode;
private MoveToBottomScroller mBottomScroller;
private boolean mCallbackOnUnClickItem = false;
/**
* Interface definition for a callback to be invoked when the list or grid has been scrolled.
*/
public interface OnScrollListener
{
/**
* The view is not scrolling. Note navigating the list using the trackball counts as being in the idle state
* since these transitions are not animated.
*/
public static int SCROLL_STATE_IDLE = 0;
/**
* The user is scrolling using touch, and their finger is still on the screen
*/
public static int SCROLL_STATE_TOUCH_SCROLL = 1;
/**
* The user had previously been scrolling using touch and had performed a fling. The animation is now coasting
* to a stop
*/
public static int SCROLL_STATE_FLING = 2;
/**
* Callback method to be invoked while the list view or grid view is being scrolled. If the view is being
* scrolled, this method will be called before the next frame of the scroll is rendered. In particular, it will
* be called before any calls to {@link Adapter#getView(int, View, ViewGroup)}.
*
* @param view The view whose scroll state is being reported
*
* @param scrollState The current scroll state. One of {@link #SCROLL_STATE_IDLE},
* {@link #SCROLL_STATE_TOUCH_SCROLL} or {@link #SCROLL_STATE_IDLE}.
*/
public void onScrollStateChanged(AbsListView view, int scrollState);
/**
* Callback method to be invoked when the list or grid has been scrolled. This will be called after the scroll
* has completed
*
* @param view The view whose scroll state is being reported
* @param firstVisibleItem the index of the first visible cell (ignore if visibleItemCount == 0)
* @param visibleItemCount the number of visible cells
* @param totalItemCount the number of items in the list adaptor
*/
public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount);
}
/**
* The top-level view of a list item can implement this interface to allow itself to modify the bounds of the
* selection shown for that item.
*/
public interface SelectionBoundsAdjuster
{
/**
* Called to allow the list item to adjust the bounds shown for its selection.
*
* @param bounds On call, this contains the bounds the list has selected for the item (that is the bounds of the
* entire view). The values can be modified as desired.
*/
public void adjustListItemSelectionBounds(Rect bounds);
}
public AbsListView(Context context)
{
super(context);
initAbsListView();
setVerticalScrollBarEnabled(true);
TypedArray a = context.obtainStyledAttributes(VIEW_IDS);
initializeScrollbars(a);
a.recycle();
}
public AbsListView(Context context, AttributeSet attrs)
{
this(context, attrs, android.R.attr.absListViewStyle);
}
public AbsListView(Context context, AttributeSet attrs, int defStyle)
{
super(context, attrs, defStyle);
initAbsListView();
TypedArrayWarpper a = new TypedArrayWarpper(context.obtainStyledAttributes(attrs, ABSLISTVIEW, defStyle, 0));
Drawable d = a.getDrawable(ABSLISTVIEW_LIST_SELECTOR);
if (d != null)
{
setSelector(d);
}
mDrawSelectorOnTop = a.getBoolean(ABSLISTVIEW_DRAWSELECTORONTOP, false);
boolean stackFromBottom = a.getBoolean(ABSLISTVIEW_STACKFROMBOTTOM, false);
setStackFromBottom(stackFromBottom);
boolean scrollingCacheEnabled = a.getBoolean(ABSLISTVIEW_SCROLLINGCACHE, true);
setScrollingCacheEnabled(scrollingCacheEnabled);
boolean useTextFilter = a.getBoolean(ABSLISTVIEW_TEXTFILTERENABLED, false);
setTextFilterEnabled(useTextFilter);
int transcriptMode = a.getInt(ABSLISTVIEW_TRANSCRIPTMODE, TRANSCRIPT_MODE_DISABLED);
setTranscriptMode(transcriptMode);
int color = a.getColor(ABSLISTVIEW_CACHECOLORHINT, 0);
setCacheColorHint(color);
boolean enableFastScroll = a.getBoolean(ABSLISTVIEW_FASTSCROLLENABLED, false);
setFastScrollEnabled(enableFastScroll);
boolean smoothScrollbar = a.getBoolean(ABSLISTVIEW_SMOOTHSCROLLBAR, true);
setSmoothScrollbarEnabled(smoothScrollbar);
setChoiceMode(a.getInt(ABSLISTVIEW_CHOICEMODE, CHOICE_MODE_NONE));
setFastScrollAlwaysVisible(a.getBoolean(ABSLISTVIEW_FASTSCROLLALWAYSVISIBLE, false));
a.recycle();
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
private void initAbsListView()
{
// Setting focusable in touch mode will set the focusable property to true
setClickable(true);
setFocusableInTouchMode(true);
setWillNotDraw(false);
setAlwaysDrawnWithCacheEnabled(false);
setScrollingCacheEnabled(true);
final ViewConfiguration configuration = ViewConfiguration.get(getContext());
mTouchSlop = configuration.getScaledTouchSlop();
mMinimumVelocity = configuration.getScaledMinimumFlingVelocity();
mMaximumVelocity = configuration.getScaledMaximumFlingVelocity();
// DisplayMetrics displayMetrics = getContext().getResources().getDisplayMetrics();
// mMaximumVelocity = (int) (displayMetrics.density * displayMetrics.heightPixels * 6);
// if (VersionUtils.isHoneycomb())
// {
// mOverscrollDistance = configuration.getScaledOverscrollDistance();
// mOverflingDistance = configuration.getScaledOverflingDistance();
// }
// else
{
final float density = getResources().getDisplayMetrics().density;
mOverscrollDistance = (int) (density * 0 + 0.5f);
mTopOverflingDistance = mBottomOverflingDistance = (int) (density * OVER_FLING_DISTANCE + 0.5f);
}
mDensityScale = getContext().getResources().getDisplayMetrics().density;
// if (!VersionUtils.isGingerBread())
{
this.setOverScrollMode(AbsListView.OVER_SCROLL_ALWAYS);
}
// 关闭fadingEdge
this.setVerticalFadingEdgeEnabled(false);
setFriction(0.005f);
}
@Override
public void setOverScrollMode(int overScrollMode) {
if (overScrollMode != OVER_SCROLL_ALWAYS &&
overScrollMode != OVER_SCROLL_IF_CONTENT_SCROLLS &&
overScrollMode != OVER_SCROLL_NEVER) {
throw new IllegalArgumentException("Invalid overscroll mode " + overScrollMode);
}
// if (overScrollMode != OVER_SCROLL_NEVER) {
// if (mEdgeGlowTop == null && mEdgeEffectEnabled) {
// Context context = getContext();
// mEdgeGlowTop = new EdgeEffect(context);
// mEdgeGlowBottom = new EdgeEffect(context);
// }
// } else {
// mEdgeGlowTop = null;
// mEdgeGlowBottom = null;
// }
mOverScrollMode = overScrollMode;
}
/**
* 开启/关闭edgeEffect
* @param enable
*/
public void setEdgeEffectEnabled(boolean enable)
{
if(mEdgeEffectEnabled != enable)
{
// if(enable)
// {
// if (mOverScrollMode != OVER_SCROLL_NEVER)
// {
// if (mEdgeGlowTop == null)
// {
// Context context = getContext();
// mEdgeGlowTop = new EdgeEffect(context);
// mEdgeGlowBottom = new EdgeEffect(context);
// }
// }
// }
// else
// {
// mEdgeGlowTop = null;
// mEdgeGlowBottom = null;
// }
mEdgeEffectEnabled = enable;
}
}
/**
* {@inheritDoc}
*/
@Override
public void setAdapter(ListAdapter adapter)
{
if (adapter != null)
{
if (mChoiceMode != CHOICE_MODE_NONE && mAdapter.hasStableIds() && mCheckedIdStates == null)
{
mCheckedIdStates = new LongSparseArray<Integer>();
}
}
if (mCheckStates != null)
{
mCheckStates.clear();
}
if (mCheckedIdStates != null)
{
mCheckedIdStates.clear();
}
}
/**
* Returns the number of items currently selected. This will only be valid if the choice mode is not
* {@link #CHOICE_MODE_NONE} (default).
*
* <p>
* To determine the specific items that are currently selected, use one of the <code>getChecked*</code> methods.
*
* @return The number of items currently selected
*
* @see #getCheckedItemPosition()
* @see #getCheckedItemPositions()
* @see #getCheckedItemIds()
*/
public int getCheckedItemCount()
{
return mCheckedItemCount;
}
/**
* Returns the checked state of the specified position. The result is only valid if the choice mode has been set to
* {@link #CHOICE_MODE_SINGLE} or {@link #CHOICE_MODE_MULTIPLE}.
*
* @param position The item whose checked state to return
* @return The item's checked state or <code>false</code> if choice mode is invalid
*
* @see #setChoiceMode(int)
*/
public boolean isItemChecked(int position)
{
if (mChoiceMode != CHOICE_MODE_NONE && mCheckStates != null)
{
return mCheckStates.get(position);
}
return false;
}
/**
* Returns the currently checked item. The result is only valid if the choice mode has been set to
* {@link #CHOICE_MODE_SINGLE}.
*
* @return The position of the currently checked item or {@link #INVALID_POSITION} if nothing is selected
*
* @see #setChoiceMode(int)
*/
public int getCheckedItemPosition()
{
if (mChoiceMode == CHOICE_MODE_SINGLE && mCheckStates != null && mCheckStates.size() == 1)
{
return mCheckStates.keyAt(0);
}
return INVALID_POSITION;
}
/**
* Returns the set of checked items in the list. The result is only valid if the choice mode has not been set to
* {@link #CHOICE_MODE_NONE}.
*
* @return A SparseBooleanArray which will return true for each call to get(int position) where position is a
* position in the list, or <code>null</code> if the choice mode is set to {@link #CHOICE_MODE_NONE}.
*/
public SparseBooleanArray getCheckedItemPositions()
{
if (mChoiceMode != CHOICE_MODE_NONE)
{
return mCheckStates;
}
return null;
}
/**
* Returns the set of checked items ids. The result is only valid if the choice mode has not been set to
* {@link #CHOICE_MODE_NONE} and the adapter has stable IDs. ({@link ListAdapter#hasStableIds()} == {@code true})
*
* @return A new array which contains the id of each checked item in the list.
*/
public long[] getCheckedItemIds()
{
if (mChoiceMode == CHOICE_MODE_NONE || mCheckedIdStates == null || mAdapter == null)
{
return new long[0];
}
final LongSparseArray<Integer> idStates = mCheckedIdStates;
final int count = idStates.size();
final long[] ids = new long[count];
for (int i = 0; i < count; i++)
{
ids[i] = idStates.keyAt(i);
}
return ids;
}
/**
* Clear any choices previously set
*/
public void clearChoices()
{
if (mCheckStates != null)
{
mCheckStates.clear();
}
if (mCheckedIdStates != null)
{
mCheckedIdStates.clear();
}
mCheckedItemCount = 0;
}
/**
* Sets the checked state of the specified position. The is only valid if the choice mode has been set to
* {@link #CHOICE_MODE_SINGLE} or {@link #CHOICE_MODE_MULTIPLE}.
*
* @param position The item whose checked state is to be checked
* @param value The new checked state for the item
*/
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
public void setItemChecked(int position, boolean value)
{
if (mChoiceMode == CHOICE_MODE_NONE)
{
return;
}
// Start selection mode if needed. We don't need to if we're unchecking something.
if (VersionUtils.isHoneycomb() && value && mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL
&& mChoiceActionMode == null)
{
mChoiceActionMode = startActionMode(mMultiChoiceModeCallback);
}
if (mChoiceMode == CHOICE_MODE_MULTIPLE || mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL)
{
boolean oldValue = mCheckStates.get(position);
mCheckStates.put(position, value);
if (mCheckedIdStates != null && mAdapter.hasStableIds())
{
if (value)
{
mCheckedIdStates.put(mAdapter.getItemId(position), position);
}
else
{
mCheckedIdStates.delete(mAdapter.getItemId(position));
}
}
if (oldValue != value)
{
if (value)
{
mCheckedItemCount++;
}
else
{
mCheckedItemCount--;
}
}
if (mChoiceActionMode != null)
{
final long id = mAdapter.getItemId(position);
mMultiChoiceModeCallback.onItemCheckedStateChanged(mChoiceActionMode, position, id, value);
}
}
else
{
boolean updateIds = mCheckedIdStates != null && mAdapter.hasStableIds();
// Clear all values if we're checking something, or unchecking the currently
// selected item
if (value || isItemChecked(position))
{
mCheckStates.clear();
if (updateIds)
{
mCheckedIdStates.clear();
}
}
// this may end up selecting the value we just cleared but this way
// we ensure length of mCheckStates is 1, a fact getCheckedItemPosition relies on
if (value)
{
mCheckStates.put(position, true);
if (updateIds)
{
mCheckedIdStates.put(mAdapter.getItemId(position), position);
}
mCheckedItemCount = 1;
}
else if (mCheckStates.size() == 0 || !mCheckStates.valueAt(0))
{
mCheckedItemCount = 0;
}
}
// Do not generate a data change while we are in the layout phase
if (!mInLayout && !mBlockLayoutRequests)
{
mDataChanged = true;
rememberSyncState();
requestLayout();
}
}
@Override
public boolean performItemClick(View view, int position, long id)
{
boolean handled = false;
boolean dispatchItemClick = true;
if(isValidPosition(position, getAdapter().getCount()))
{
if (mChoiceMode != CHOICE_MODE_NONE)
{
handled = true;
if (mChoiceMode == CHOICE_MODE_MULTIPLE
|| (mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL && mChoiceActionMode != null))
{
boolean newValue = !mCheckStates.get(position, false);
mCheckStates.put(position, newValue);
if (mCheckedIdStates != null && mAdapter.hasStableIds())
{
if (newValue)
{
mCheckedIdStates.put(mAdapter.getItemId(position), position);
}
else
{
mCheckedIdStates.delete(mAdapter.getItemId(position));
}
}
if (newValue)
{
mCheckedItemCount++;
}
else
{
mCheckedItemCount--;
}
if (mChoiceActionMode != null)
{
mMultiChoiceModeCallback.onItemCheckedStateChanged(mChoiceActionMode, position, id, newValue);
dispatchItemClick = false;
}
}
else if (mChoiceMode == CHOICE_MODE_SINGLE)
{
boolean newValue = !mCheckStates.get(position, false);
if (newValue)
{
mCheckStates.clear();
mCheckStates.put(position, true);
if (mCheckedIdStates != null && mAdapter.hasStableIds())
{
mCheckedIdStates.clear();
mCheckedIdStates.put(mAdapter.getItemId(position), position);
}
mCheckedItemCount = 1;
}
else if (mCheckStates.size() == 0 || !mCheckStates.valueAt(0))
{
mCheckedItemCount = 0;
}
}
mDataChanged = true;
rememberSyncState();
requestLayout();
}
}
if (dispatchItemClick)
{
handled |= super.performItemClick(view, position, id);
}
return handled;
}
/**
* 设置为true后,即时没有点击到任何item, 也会触发onItemClick事件
* @param mCallbackOnUnClickItem
*/
public void setCallbackOnUnClickItem(boolean mCallbackOnUnClickItem)
{
this.mCallbackOnUnClickItem = mCallbackOnUnClickItem;
}
/**
* @see #setChoiceMode(int)
*
* @return The current choice mode
*/
public int getChoiceMode()
{
return mChoiceMode;
}
/**
* Defines the choice behavior for the List. By default, Lists do not have any choice behavior (
* {@link #CHOICE_MODE_NONE}). By setting the choiceMode to {@link #CHOICE_MODE_SINGLE}, the List allows up to one
* item to be in a chosen state. By setting the choiceMode to {@link #CHOICE_MODE_MULTIPLE}, the list allows any
* number of items to be chosen.
*
* @param choiceMode One of {@link #CHOICE_MODE_NONE}, {@link #CHOICE_MODE_SINGLE}, or {@link #CHOICE_MODE_MULTIPLE}
*/
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
public void setChoiceMode(int choiceMode)
{
mChoiceMode = choiceMode;
if (mChoiceActionMode != null)
{
mChoiceActionMode.finish();
mChoiceActionMode = null;
}
if (mChoiceMode != CHOICE_MODE_NONE)
{
if (mCheckStates == null)
{
mCheckStates = new SparseBooleanArray();
}
if (mCheckedIdStates == null && mAdapter != null && mAdapter.hasStableIds())
{
mCheckedIdStates = new LongSparseArray<Integer>();
}
// Modal multi-choice mode only has choices when the mode is active. Clear them.
if (mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL)
{
clearChoices();
setLongClickable(true);
}
}
}
/**
* Set a {@link MultiChoiceModeListener} that will manage the lifecycle of the selection {@link ActionMode}. Only
* used when the choice mode is set to {@link #CHOICE_MODE_MULTIPLE_MODAL}.
*
* @param listener Listener that will manage the selection mode
*
* @see #setChoiceMode(int)
*/
public void setMultiChoiceModeListener(MultiChoiceModeListener listener)
{
if (mMultiChoiceModeCallback == null)
{
mMultiChoiceModeCallback = new MultiChoiceModeWrapper();
}
mMultiChoiceModeCallback.setWrapped(listener);
}
/**
* @return true if all list content currently fits within the view boundaries
*/
private boolean contentFits()
{
final int childCount = getChildCount();
if (childCount == 0)
return true;
if (childCount != mItemCount)
return false;
return getChildAt(0).getTop() >= mListPadding.top
&& getChildAt(childCount - 1).getBottom() <= getHeight() - mListPadding.bottom;
}
/**
* Enables fast scrolling by letting the user quickly scroll through lists by dragging the fast scroll thumb. The
* adapter attached to the list may want to implement {@link SectionIndexer} if it wishes to display alphabet
* preview and jump between sections of the list.
*
* @see SectionIndexer
* @see #isFastScrollEnabled()
* @param enabled whether or not to enable fast scrolling
*/
public void setFastScrollEnabled(boolean enabled)
{
mFastScrollEnabled = enabled;
if (enabled)
{
if (mFastScroller == null)
{
mFastScroller = new FastScroller(getContext(), this);
}
}
else
{
if (mFastScroller != null)
{
mFastScroller.stop();
mFastScroller = null;
}
}
}
/**
* Set whether or not the fast scroller should always be shown in place of the standard scrollbars. Fast scrollers
* shown in this way will not fade out and will be a permanent fixture within the list. Best combined with an inset
* scroll bar style that will ensure enough padding. This will enable fast scrolling if it is not already enabled.
*
* @param alwaysShow true if the fast scroller should always be displayed.
* @see #setScrollBarStyle(int)
* @see #setFastScrollEnabled(boolean)
*/
public void setFastScrollAlwaysVisible(boolean alwaysShow)
{
if (alwaysShow && !mFastScrollEnabled)
{
setFastScrollEnabled(true);
}
if (mFastScroller != null)
{
mFastScroller.setAlwaysShow(alwaysShow);
}
Method m;
try
{
m = ReflectedMethods.getDeclaredMethod( View.class, "computeOpaqueFlags");
m.setAccessible(true);
m.invoke(this);
}
catch (Exception e)
{
Log.i(TAG, e.getMessage());
}
// computeOpaqueFlags();
try
{
Method m1 = ReflectedMethods.getDeclaredMethod(View.class, "recomputePadding");
m1.setAccessible(true);
m1.invoke(this);
}
catch (Exception e)
{
Log.i(TAG, e.getMessage());
}
// recomputePadding();
}
/**
* Returns true if the fast scroller is set to always show on this view rather than fade out when not in use.
*
* @return true if the fast scroller will always show.
* @see #setFastScrollAlwaysVisible(boolean)
*/
public boolean isFastScrollAlwaysVisible()
{
return mFastScrollEnabled && mFastScroller.isAlwaysShowEnabled();
}
@Override
public int getVerticalScrollbarWidth()
{
if (isFastScrollAlwaysVisible())
{
return Math.max(super.getVerticalScrollbarWidth(), mFastScroller.getWidth());
}
return super.getVerticalScrollbarWidth();
}
/**
* Returns the current state of the fast scroll feature.
*
* @see #setFastScrollEnabled(boolean)
* @return true if fast scroll is enabled, false otherwise
*/
@ViewDebug.ExportedProperty
public boolean isFastScrollEnabled()
{
return mFastScrollEnabled;
}
@Override
public void setVerticalScrollbarPosition(int position)
{
super.setVerticalScrollbarPosition(position);
if (mFastScroller != null)
{
mFastScroller.setScrollbarPosition(position);
}
}
/**
* If fast scroll is visible, then don't draw the vertical scrollbar.
*
* @hide
*/
// @Override
protected boolean isVerticalScrollBarHidden()
{
return mFastScroller != null && mFastScroller.isVisible();
}
/**
* When smooth scrollbar is enabled, the position and size of the scrollbar thumb is computed based on the number of
* visible pixels in the visible items. This however assumes that all list items have the same height. If you use a
* list in which items have different heights, the scrollbar will change appearance as the user scrolls through the
* list. To avoid this issue, you need to disable this property.
*
* When smooth scrollbar is disabled, the position and size of the scrollbar thumb is based solely on the number of
* items in the adapter and the position of the visible items inside the adapter. This provides a stable scrollbar
* as the user navigates through a list of items with varying heights.
*
* @param enabled Whether or not to enable smooth scrollbar.
*
* @see #setSmoothScrollbarEnabled(boolean)
* @attr ref android.R.styleable#AbsListView_smoothScrollbar
*/
public void setSmoothScrollbarEnabled(boolean enabled)
{
mSmoothScrollbarEnabled = enabled;
}
/**
* Returns the current state of the fast scroll feature.
*
* @return True if smooth scrollbar is enabled is enabled, false otherwise.
*
* @see #setSmoothScrollbarEnabled(boolean)
*/
@ViewDebug.ExportedProperty
public boolean isSmoothScrollbarEnabled()
{
return mSmoothScrollbarEnabled;
}
/**
* Set the listener that will receive notifications every time the list scrolls.
*
* @param l the scroll listener
*/
public void setOnScrollListener(OnScrollListener l)
{
mOnScrollListener = l;
invokeOnItemScrollListener();
}
/**
* Notify our scroll listener (if there is one) of a change in scroll state
*/
void invokeOnItemScrollListener()
{
if (mFastScroller != null)
{
mFastScroller.onScroll(this, mFirstPosition, getChildCount(), mItemCount);
}
if (mOnScrollListener != null)
{
mOnScrollListener.onScroll(this, mFirstPosition, getChildCount(), mItemCount);
}
onScrollChanged(0, 0, 0, 0); // dummy values, View's implementation does not use these.
}
@Override
public void sendAccessibilityEvent(int eventType)
{
// Since this class calls onScrollChanged even if the mFirstPosition and the
// child count have not changed we will avoid sending duplicate accessibility
// events.
if (eventType == AccessibilityEvent.TYPE_VIEW_SCROLLED)
{
final int firstVisiblePosition = getFirstVisiblePosition();
final int lastVisiblePosition = getLastVisiblePosition();
if (mLastAccessibilityScrollEventFromIndex == firstVisiblePosition
&& mLastAccessibilityScrollEventToIndex == lastVisiblePosition)
{
return;
}
else
{
mLastAccessibilityScrollEventFromIndex = firstVisiblePosition;
mLastAccessibilityScrollEventToIndex = lastVisiblePosition;
}
}
super.sendAccessibilityEvent(eventType);
}
/**
* Indicates whether the children's drawing cache is used during a scroll. By default, the drawing cache is enabled
* but this will consume more memory.
*
* @return true if the scrolling cache is enabled, false otherwise
*
* @see #setScrollingCacheEnabled(boolean)
* @see View#setDrawingCacheEnabled(boolean)
*/
@ViewDebug.ExportedProperty
public boolean isScrollingCacheEnabled()
{
return mScrollingCacheEnabled;
}
/**
* Enables or disables the children's drawing cache during a scroll. By default, the drawing cache is enabled but
* this will use more memory.
*
* When the scrolling cache is enabled, the caches are kept after the first scrolling. You can manually clear the
* cache by calling {@link android.view.ViewGroup#setChildrenDrawingCacheEnabled(boolean)}.
*
* @param enabled true to enable the scroll cache, false otherwise
*
* @see #isScrollingCacheEnabled()
* @see View#setDrawingCacheEnabled(boolean)
*/
public void setScrollingCacheEnabled(boolean enabled)
{
if (mScrollingCacheEnabled && !enabled)
{
clearScrollingCache();
}
mScrollingCacheEnabled = enabled;
}
/**
* Enables or disables the type filter window. If enabled, typing when this view has focus will filter the children
* to match the users input. Note that the {@link Adapter} used by this view must implement the {@link Filterable}
* interface.
*
* @param textFilterEnabled true to enable type filtering, false otherwise
*
* @see Filterable
*/
public void setTextFilterEnabled(boolean textFilterEnabled)
{
mTextFilterEnabled = textFilterEnabled;
}
/**
* Indicates whether type filtering is enabled for this view
*
* @return true if type filtering is enabled, false otherwise
*
* @see #setTextFilterEnabled(boolean)
* @see Filterable
*/
@ViewDebug.ExportedProperty
public boolean isTextFilterEnabled()
{
return mTextFilterEnabled;
}
@Override
public void getFocusedRect(Rect r)
{
View view = getSelectedView();
if (view != null && view.getParent() == this)
{
// the focused rectangle of the selected view offset into the
// coordinate space of this view.
view.getFocusedRect(r);
offsetDescendantRectToMyCoords(view, r);
}
else
{
// otherwise, just the norm
super.getFocusedRect(r);
}
}
private void useDefaultSelector()
{
setSelector(getResources().getDrawable(android.R.drawable.list_selector_background));
}
/**
* Indicates whether the content of this view is pinned to, or stacked from, the bottom edge.
*
* @return true if the content is stacked from the bottom edge, false otherwise
*/
@ViewDebug.ExportedProperty
public boolean isStackFromBottom()
{
return mStackFromBottom;
}
/**
* When stack from bottom is set to true, the list fills its content starting from the bottom of the view.
*
* @param stackFromBottom true to pin the view's content to the bottom edge, false to pin the view's content to the
* top edge
*/
public void setStackFromBottom(boolean stackFromBottom)
{
if (mStackFromBottom != stackFromBottom)
{
mStackFromBottom = stackFromBottom;
requestLayoutIfNecessary();
}
}
void requestLayoutIfNecessary()
{
if (getChildCount() > 0)
{
resetList();
requestLayout();
invalidate();
}
}
public static class SavedState extends BaseSavedState
{
long selectedId = -1;
long firstId;
int viewTop;
int position;
int height;
String filter;
boolean inActionMode;
int checkedItemCount;
SparseBooleanArray checkState;
LongSparseArray<Integer> checkIdState;
/**
* Constructor called from {@link AbsListView#onSaveInstanceState()}
*/
SavedState(Parcelable superState)
{
super(superState);
}
/**
* Constructor called from {@link #CREATOR}
*/
private SavedState(Parcel in)
{
super(in);
selectedId = in.readLong();
firstId = in.readLong();
viewTop = in.readInt();
position = in.readInt();
height = in.readInt();
filter = in.readString();
inActionMode = in.readByte() != 0;
checkedItemCount = in.readInt();
checkState = in.readSparseBooleanArray();
final int N = in.readInt();
if (N > 0)
{
checkIdState = new LongSparseArray<Integer>();
for (int i = 0; i < N; i++)
{
final long key = in.readLong();
final int value = in.readInt();
checkIdState.put(key, value);
}
}
}
@Override
public void writeToParcel(Parcel out, int flags)
{
super.writeToParcel(out, flags);
out.writeLong(selectedId);
out.writeLong(firstId);
out.writeInt(viewTop);
out.writeInt(position);
out.writeInt(height);
out.writeString(filter);
out.writeByte((byte) (inActionMode ? 1 : 0));
out.writeInt(checkedItemCount);
out.writeSparseBooleanArray(checkState);
final int N = checkIdState != null ? checkIdState.size() : 0;
out.writeInt(N);
for (int i = 0; i < N; i++)
{
out.writeLong(checkIdState.keyAt(i));
out.writeInt(checkIdState.valueAt(i));
}
}
@Override
public String toString()
{
return "AbsListView.SavedState{" + Integer.toHexString(System.identityHashCode(this)) + " selectedId="
+ selectedId + " firstId=" + firstId + " viewTop=" + viewTop + " position=" + position + " height="
+ height + " filter=" + filter + " checkState=" + checkState + "}";
}
public static final Parcelable.Creator<SavedState> CREATOR = new Parcelable.Creator<SavedState>()
{
public SavedState createFromParcel(Parcel in)
{
return new SavedState(in);
}
public SavedState[] newArray(int size)
{
return new SavedState[size];
}
};
}
@Override
public Parcelable onSaveInstanceState()
{
/*
* This doesn't really make sense as the place to dismiss the popups, but there don't seem to be any other
* useful hooks that happen early enough to keep from getting complaints about having leaked the window.
*/
dismissPopup();
Parcelable superState = super.onSaveInstanceState();
SavedState ss = new SavedState(superState);
boolean haveChildren = getChildCount() > 0 && mItemCount > 0;
ss.height = mLayoutHeight;
if (mSelectedPosition >= 0)
{
ss.selectedId = mNextSelectedRowId;
if(haveChildren)
{
// Remember the selection
ss.position = getSelectedItemPosition();
// Sync the selection state
View v = getChildAt(mSelectedPosition - mFirstPosition);
if(v != null)
{
ss.viewTop = mStackFromBottom ? mLayoutHeight - v.getBottom() : v.getTop();
}
ss.firstId = INVALID_POSITION;
}
}
// 从上往下
else if(!mStackFromBottom)
{
if (haveChildren && mFirstPosition >= 0)
{
// Remember the position of the first child.
// We only do this if we are not currently at the top of
// the list, for two reasons:
// (1) The list may be in the process of becoming empty, in
// which case mItemCount may not be 0, but if we try to
// ask for any information about position 0 we will crash.
// (2) Being "at the top" seems like a special case, anyway,
// and the user wouldn't expect to end up somewhere else when
// they revisit the list even if its content has changed.
View v = getChildAt(0);
ss.viewTop = v.getTop();
int firstPos = mFirstPosition;
if (firstPos >= mItemCount)
{
firstPos = mItemCount - 1;
}
ss.position = firstPos;
ss.firstId = mAdapter.getItemId(firstPos);
}
else
{
ss.viewTop = 0;
ss.firstId = INVALID_POSITION;
ss.position = 0;
}
}
// 从下向上
else
{
if (haveChildren && mFirstPosition >= 0)
{
int childCount = getChildCount();
int lastPosition = mFirstPosition == INVALID_POSITION ? INVALID_POSITION : mFirstPosition + childCount
- 1;
View v = getChildAt(childCount - 1);
ss.viewTop = mLayoutHeight - v.getBottom();
int firstPos = lastPosition;
if (firstPos >= mItemCount)
{
firstPos = mItemCount - 1;
}
int viewBottom = v.getBottom();
// 已经滚到最后面了, 则记录为最后一行
if (viewBottom <= mLayoutHeight - mListPadding.bottom && mTranscriptMode == TRANSCRIPT_MODE_NORMAL)
{
ss.position = Integer.MAX_VALUE;
}
else
{
ss.position = firstPos;
}
ss.firstId = mAdapter.getItemId(firstPos);
}
else
{
ss.viewTop = 0;
ss.firstId = INVALID_POSITION;
ss.position = 0;
}
}
ss.filter = null;
if (mFiltered)
{
final EditText textFilter = mTextFilter;
if (textFilter != null)
{
Editable filterText = textFilter.getText();
if (filterText != null)
{
ss.filter = filterText.toString();
}
}
}
ss.inActionMode = mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL && mChoiceActionMode != null;
if (mCheckStates != null)
{
ss.checkState = mCheckStates.clone();
}
if (mCheckedIdStates != null)
{
final LongSparseArray<Integer> idState = new LongSparseArray<Integer>();
final int count = mCheckedIdStates.size();
for (int i = 0; i < count; i++)
{
idState.put(mCheckedIdStates.keyAt(i), mCheckedIdStates.valueAt(i));
}
ss.checkIdState = idState;
}
ss.checkedItemCount = mCheckedItemCount;
return ss;
}
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
@Override
public void onRestoreInstanceState(Parcelable state)
{
SavedState ss = (SavedState) state;
super.onRestoreInstanceState(ss.getSuperState());
mDataChanged = true;
mSyncHeight = ss.height;
if (ss.selectedId >= 0)
{
mNeedSync = true;
mSyncRowId = ss.selectedId;
mSyncPosition = ss.position;
mSpecificTop = ss.viewTop;
mSpecificBottom = ss.viewTop;
mSyncMode = SYNC_SELECTED_POSITION;
}
else if (ss.firstId >= 0)
{
setSelectedPositionInt(INVALID_POSITION);
// Do this before setting mNeedSync since setNextSelectedPosition looks at mNeedSync
setNextSelectedPositionInt(INVALID_POSITION);
mSelectorPosition = INVALID_POSITION;
// 如果是最后一行, 则不用同步, layout会自动layout成最后一行
if(!(ss.position == Integer.MAX_VALUE))
{
mNeedSync = true;
mSyncRowId = ss.firstId;
if(!mStackFromBottom)
{
mSyncPosition = ss.position;
mSpecificTop = ss.viewTop;
mSyncMode = SYNC_FIRST_POSITION;
}
else
{
mSyncPosition = ss.position;
// mSpecificTop = ss.viewTop;
mSpecificBottom = ss.viewTop;
mSyncMode = SYNC_LAST_POSITION;
}
}
}
setFilterText(ss.filter);
if (ss.checkState != null)
{
mCheckStates = ss.checkState;
}
if (ss.checkIdState != null)
{
mCheckedIdStates = ss.checkIdState;
}
mCheckedItemCount = ss.checkedItemCount;
if (VersionUtils.isHoneycomb() && ss.inActionMode && mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL
&& mMultiChoiceModeCallback != null)
{
mChoiceActionMode = startActionMode(mMultiChoiceModeCallback);
}
requestLayout();
}
private boolean acceptFilter()
{
return mTextFilterEnabled && getAdapter() instanceof Filterable
&& ((Filterable) getAdapter()).getFilter() != null;
}
/**
* Sets the initial value for the text filter.
*
* @param filterText The text to use for the filter.
*
* @see #setTextFilterEnabled
*/
public void setFilterText(String filterText)
{
// TODO: Should we check for acceptFilter()?
if (mTextFilterEnabled && !TextUtils.isEmpty(filterText))
{
createTextFilter(false);
// This is going to call our listener onTextChanged, but we might not
// be ready to bring up a window yet
mTextFilter.setText(filterText);
mTextFilter.setSelection(filterText.length());
if (mAdapter instanceof Filterable)
{
// if mPopup is non-null, then onTextChanged will do the filtering
if (mPopup == null)
{
Filter f = ((Filterable) mAdapter).getFilter();
f.filter(filterText);
}
// Set filtered to true so we will display the filter window when our main
// window is ready
mFiltered = true;
mDataSetObserver.clearSavedState();
}
}
}
/**
* Returns the list's text filter, if available.
*
* @return the list's text filter or null if filtering isn't enabled
*/
public CharSequence getTextFilter()
{
if (mTextFilterEnabled && mTextFilter != null)
{
return mTextFilter.getText();
}
return null;
}
@Override
protected void onFocusChanged(boolean gainFocus, int direction, Rect previouslyFocusedRect)
{
super.onFocusChanged(gainFocus, direction, previouslyFocusedRect);
if (gainFocus && mSelectedPosition < 0 && !isInTouchMode())
{
if (!mIsAttached && mAdapter != null)
{
// Data may have changed while we were detached and it's valid
// to change focus while detached. Refresh so we don't die.
mDataChanged = true;
mOldItemCount = mItemCount;
mItemCount = mAdapter.getCount();
}
resurrectSelection();
}
}
@Override
public void requestLayout()
{
if (!mBlockLayoutRequests && !mInLayout)
{
rememberSyncState();
super.requestLayout();
}
}
/**
* The list is empty. Clear everything out.
*/
void resetList()
{
removeAllViewsInLayout();
mFirstPosition = 0;
mDataChanged = false;
mNeedSync = false;
mOldSelectedPosition = INVALID_POSITION;
mOldSelectedRowId = INVALID_ROW_ID;
setSelectedPositionInt(INVALID_POSITION);
setNextSelectedPositionInt(INVALID_POSITION);
mSelectedTop = 0;
mSelectorPosition = INVALID_POSITION;
mSelectorRect.setEmpty();
invalidate();
}
@Override
protected int computeVerticalScrollExtent()
{
final int count = getChildCount();
if (count > 0)
{
if (mSmoothScrollbarEnabled)
{
int extent = count * 100;
View view = getChildAt(0);
final int top = view.getTop();
int height = view.getHeight();
if (height > 0)
{
extent += (top * 100) / height;
}
view = getChildAt(count - 1);
final int bottom = view.getBottom();
height = view.getHeight();
if (height > 0)
{
extent -= ((bottom - getHeight()) * 100) / height;
}
return extent;
}
else
{
return 1;
}
}
return 0;
}
@Override
protected int computeVerticalScrollOffset()
{
final int firstPosition = mFirstPosition;
final int childCount = getChildCount();
if (firstPosition >= 0 && childCount > 0)
{
if (mSmoothScrollbarEnabled)
{
final View view = getChildAt(0);
final int top = view.getTop();
int height = view.getHeight();
if (height > 0)
{
return Math.max(firstPosition * 100 - (top * 100) / height, 0);
}
}
else
{
int index;
final int count = mItemCount;
if (firstPosition == 0)
{
index = 0;
}
else if (firstPosition + childCount == count)
{
index = count;
}
else
{
index = firstPosition + childCount / 2;
}
return (int) (firstPosition + childCount * (index / (float) count));
}
}
return 0;
}
@Override
protected int computeVerticalScrollRange()
{
int result;
if (mSmoothScrollbarEnabled)
{
result = Math.max(mItemCount * 100, 0);
// if (getScrollY() != 0)
// {
// // Compensate for overscroll
// result += Math.abs((int) ((float) getScrollY() / getHeight() * mItemCount * 100));
// }
}
else
{
result = mItemCount;
}
return result;
}
/**
* 覆盖隐藏的方法..
*/
protected void onDrawVerticalScrollBar(Canvas canvas, Drawable scrollBar,
int l, int t, int r, int b) {
scrollBar.setBounds(l, t + mScrollY, r, b + mScrollY);
scrollBar.draw(canvas);
}
@Override
protected float getTopFadingEdgeStrength()
{
final int count = getChildCount();
final float fadeEdge = super.getTopFadingEdgeStrength();
if (count == 0)
{
return fadeEdge;
}
else
{
if (mFirstPosition > 0)
{
return 1.0f;
}
final int top = getChildAt(0).getTop();
final float fadeLength = (float) getVerticalFadingEdgeLength();
return top < mPaddingTop ? (float) -(top - mPaddingTop) / fadeLength : fadeEdge;
}
}
@Override
protected float getBottomFadingEdgeStrength()
{
final int count = getChildCount();
final float fadeEdge = super.getBottomFadingEdgeStrength();
if (count == 0)
{
return fadeEdge;
}
else
{
if (mFirstPosition + count - 1 < mItemCount - 1)
{
return 1.0f;
}
final int bottom = getChildAt(count - 1).getBottom();
final int height = getHeight();
final float fadeLength = (float) getVerticalFadingEdgeLength();
return bottom > height - mPaddingBottom ? (float) (bottom - height + mPaddingBottom) / fadeLength
: fadeEdge;
}
}
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)
{
if (mSelector == null)
{
useDefaultSelector();
}
final Rect listPadding = mListPadding;
listPadding.left = mSelectionLeftPadding + mPaddingLeft;
listPadding.top = mSelectionTopPadding + mPaddingTop;
listPadding.right = mSelectionRightPadding + mPaddingRight;
listPadding.bottom = mSelectionBottomPadding + mPaddingBottom;
// Check if our previous measured size was at a point where we should scroll later.
if (mTranscriptMode == TRANSCRIPT_MODE_NORMAL)
{
final int childCount = getChildCount();
if(childCount > 0)
{
final int listBottom = getHeight() - mPaddingBottom;
final View lastChild = getChildAt(childCount - 1);
final int lastBottom = lastChild != null ? lastChild.getBottom() : listBottom;
mForceTranscriptScroll = mFirstPosition + childCount >= mLastHandledItemCount && lastBottom <= listBottom;
}
}
}
/**
* Subclasses should NOT override this method but {@link #layoutChildren()} instead.
*/
@Override
protected void onLayout(boolean changed, int l, int t, int r, int b)
{
traceBegin("AbsListView.onLayout");
try
{
// long current = System.nanoTime();
// final boolean dataChanged = mDataChanged;
super.onLayout(changed, l, t, r, b);
mInLayout = true;
if (changed)
{
int childCount = getChildCount();
for (int i = 0; i < childCount; i++)
{
getChildAt(i).forceLayout();
}
mRecycler.markChildrenDirty();
}
if (mFastScroller != null && mItemCount != mOldItemCount)
{
mFastScroller.onItemCountChanged(mOldItemCount, mItemCount);
}
layoutChildren();
mInLayout = false;
mOverscrollMax = (b - t) / OVERSCROLL_LIMIT_DIVISOR;
// 数据变了, 并且还在滚
if(mScrollToBottom)
{
if(mBottomScroller == null)
{
mBottomScroller = new MoveToBottomScroller();
}
mBottomScroller.start();
}
}
finally
{
traceEnd();
}
}
protected boolean setFrame(int left, int top, int right, int bottom)
{
final boolean changed = super.setFrame(left, top, right, bottom);
if (changed)
{
// Reposition the popup when the frame has changed. This includes
// translating the widget, not just changing its dimension. The
// filter popup needs to follow the widget.
final boolean visible = getWindowVisibility() == View.VISIBLE;
if (mFiltered && visible && mPopup != null && mPopup.isShowing())
{
positionPopup();
}
}
return changed;
}
/**
* Subclasses must override this method to layout their children.
*/
protected void layoutChildren()
{
}
void updateScrollIndicators()
{
if (mScrollUp != null)
{
boolean canScrollUp;
// 0th element is not visible
canScrollUp = mFirstPosition > 0;
// ... Or top of 0th element is not visible
if (!canScrollUp)
{
if (getChildCount() > 0)
{
View child = getChildAt(0);
canScrollUp = child.getTop() < mListPadding.top;
}
}
mScrollUp.setVisibility(canScrollUp ? View.VISIBLE : View.INVISIBLE);
}
if (mScrollDown != null)
{
boolean canScrollDown;
int count = getChildCount();
// Last item is not visible
canScrollDown = (mFirstPosition + count) < mItemCount;
// ... Or bottom of the last element is not visible
if (!canScrollDown && count > 0)
{
View child = getChildAt(count - 1);
canScrollDown = child.getBottom() > mBottom - mListPadding.bottom;
}
mScrollDown.setVisibility(canScrollDown ? View.VISIBLE : View.INVISIBLE);
}
}
@Override
@ViewDebug.ExportedProperty
public View getSelectedView()
{
if (mItemCount > 0 && mSelectedPosition >= 0)
{
return getChildAt(mSelectedPosition - mFirstPosition);
}
else
{
return null;
}
}
/**
* List padding is the maximum of the normal view's padding and the padding of the selector.
*
* @see android.view.View#getPaddingTop()
* @see #getSelector()
*
* @return The top list padding.
*/
public int getListPaddingTop()
{
return mListPadding.top;
}
/**
* List padding is the maximum of the normal view's padding and the padding of the selector.
*
* @see android.view.View#getPaddingBottom()
* @see #getSelector()
*
* @return The bottom list padding.
*/
public int getListPaddingBottom()
{
return mListPadding.bottom;
}
/**
* List padding is the maximum of the normal view's padding and the padding of the selector.
*
* @see android.view.View#getPaddingLeft()
* @see #getSelector()
*
* @return The left list padding.
*/
public int getListPaddingLeft()
{
return mListPadding.left;
}
/**
* List padding is the maximum of the normal view's padding and the padding of the selector.
*
* @see android.view.View#getPaddingRight()
* @see #getSelector()
*
* @return The right list padding.
*/
public int getListPaddingRight()
{
return mListPadding.right;
}
/**
* Get a view and have it show the data associated with the specified position. This is called when we have already
* discovered that the view is not available for reuse in the recycle bin. The only choices left are converting an
* old view or making a new one.
*
* @param position The position to display
* @param isScrap Array of at least 1 boolean, the first entry will become true if the returned view was taken from
* the scrap heap, false if otherwise.
*
* @return A view displaying the data associated with the specified position
*/
View obtainView(int position, boolean[] isScrap)
{
isScrap[0] = false;
View scrapView;
scrapView = mRecycler.getScrapView(position);
View child;
if (scrapView != null)
{
// if (ViewDebug.TRACE_RECYCLER)
// {
// ViewDebug.trace(scrapView, ViewDebug.RecyclerTraceType.RECYCLE_FROM_SCRAP_HEAP, position, -1);
// }
child = mAdapter.getView(position, scrapView, this);
// if (ViewDebug.TRACE_RECYCLER)
// {
// ViewDebug.trace(child, ViewDebug.RecyclerTraceType.BIND_VIEW, position, getChildCount());
// }
if (child != scrapView)
{
mRecycler.addScrapView(scrapView, position);
if (mCacheColorHint != 0)
{
child.setDrawingCacheBackgroundColor(mCacheColorHint);
}
// if (ViewDebug.TRACE_RECYCLER)
// {
// ViewDebug.trace(scrapView, ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, position, -1);
// }
}
else
{
isScrap[0] = true;
// child.dispatchFinishTemporaryDetach();
dispatchFinishTemporaryDetachForView(child);
}
}
else
{
child = mAdapter.getView(position, null, this);
if (mCacheColorHint != 0)
{
child.setDrawingCacheBackgroundColor(mCacheColorHint);
}
// if (ViewDebug.TRACE_RECYCLER)
// {
// ViewDebug.trace(child, ViewDebug.RecyclerTraceType.NEW_VIEW, position, getChildCount());
// }
}
return child;
}
void positionSelector(int position, View sel)
{
if (position != INVALID_POSITION)
{
mSelectorPosition = position;
}
final Rect selectorRect = mSelectorRect;
selectorRect.set(sel.getLeft(), sel.getTop(), sel.getRight(), sel.getBottom());
if (sel instanceof SelectionBoundsAdjuster)
{
((SelectionBoundsAdjuster) sel).adjustListItemSelectionBounds(selectorRect);
}
positionSelector(selectorRect.left, selectorRect.top, selectorRect.right, selectorRect.bottom);
final boolean isChildViewEnabled = mIsChildViewEnabled;
if (sel.isEnabled() != isChildViewEnabled)
{
mIsChildViewEnabled = !isChildViewEnabled;
if (getSelectedItemPosition() != INVALID_POSITION)
{
refreshDrawableState();
}
}
}
private void positionSelector(int l, int t, int r, int b)
{
mSelectorRect.set(l - mSelectionLeftPadding, t - mSelectionTopPadding, r + mSelectionRightPadding, b
+ mSelectionBottomPadding);
}
@Override
protected void dispatchDraw(Canvas canvas)
{
int saveCount = 0;
final boolean clipToPadding = (mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK;
if (clipToPadding)
{
saveCount = canvas.save();
final int scrollX = getScrollX();
final int scrollY = getScrollY();
canvas.clipRect(scrollX + mPaddingLeft, scrollY + mPaddingTop, scrollX + mRight - mLeft
- mPaddingRight, scrollY + mBottom - mTop - mPaddingBottom);
mGroupFlags &= ~CLIP_TO_PADDING_MASK;
}
final boolean drawSelectorOnTop = mDrawSelectorOnTop;
if (!drawSelectorOnTop)
{
drawSelector(canvas);
}
super.dispatchDraw(canvas);
if (drawSelectorOnTop)
{
drawSelector(canvas);
}
if (clipToPadding)
{
canvas.restoreToCount(saveCount);
mGroupFlags |= CLIP_TO_PADDING_MASK;
}
}
@Override
protected boolean isPaddingOffsetRequired()
{
return (mGroupFlags & CLIP_TO_PADDING_MASK) != CLIP_TO_PADDING_MASK;
}
@Override
protected int getLeftPaddingOffset()
{
return (mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK ? 0 : -getPaddingLeft();
}
@Override
protected int getTopPaddingOffset()
{
return (mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK ? 0 : -getPaddingTop();
}
@Override
protected int getRightPaddingOffset()
{
return (mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK ? 0 : mPaddingRight;
}
@Override
protected int getBottomPaddingOffset()
{
return (mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK ? 0 : mPaddingBottom;
}
@Override
protected void onSizeChanged(int w, int h, int oldw, int oldh)
{
if (getChildCount() > 0)
{
mDataChanged = true;
rememberSyncState();
}
if (mFastScroller != null)
{
mFastScroller.onSizeChanged(w, h, oldw, oldh);
}
}
/**
* @return True if the current touch mode requires that we draw the selector in the pressed state.
*/
boolean touchModeDrawsInPressedState()
{
// FIXME use isPressed for this
switch (mTouchMode)
{
case TOUCH_MODE_TAP:
case TOUCH_MODE_DONE_WAITING:
return true;
default:
return false;
}
}
/**
* Indicates whether this view is in a state where the selector should be drawn. This will happen if we have focus
* but are not in touch mode, or we are in the middle of displaying the pressed state for an item.
*
* @return True if the selector should be shown
*/
boolean shouldShowSelector()
{
return (hasFocus() && !isInTouchMode()) || touchModeDrawsInPressedState();
}
private void drawSelector(Canvas canvas)
{
if (!mSelectorRect.isEmpty())
{
final Drawable selector = mSelector;
selector.setBounds(mSelectorRect);
selector.draw(canvas);
}
}
/**
* Controls whether the selection highlight drawable should be drawn on top of the item or behind it.
*
* @param onTop If true, the selector will be drawn on the item it is highlighting. The default is false.
*
* @attr ref android.R.styleable#AbsListView_drawSelectorOnTop
*/
public void setDrawSelectorOnTop(boolean onTop)
{
mDrawSelectorOnTop = onTop;
}
/**
* Set a Drawable that should be used to highlight the currently selected item.
*
* @param resID A Drawable resource to use as the selection highlight.
*
* @attr ref android.R.styleable#AbsListView_listSelector
*/
public void setSelector(int resID)
{
setSelector(getResources().getDrawable(resID));
}
public void setSelector(Drawable sel)
{
if (mSelector != null)
{
mSelector.setCallback(null);
unscheduleDrawable(mSelector);
}
mSelector = sel;
Rect padding = new Rect();
sel.getPadding(padding);
mSelectionLeftPadding = padding.left;
mSelectionTopPadding = padding.top;
mSelectionRightPadding = padding.right;
mSelectionBottomPadding = padding.bottom;
sel.setCallback(this);
updateSelectorState();
}
/**
* Returns the selector {@link android.graphics.drawable.Drawable} that is used to draw the selection in the list.
*
* @return the drawable used to display the selector
*/
public Drawable getSelector()
{
return mSelector;
}
/**
* Sets the selector state to "pressed" and posts a CheckForKeyLongPress to see if this is a long press.
*/
void keyPressed()
{
if (!isEnabled() || !isClickable())
{
return;
}
Drawable selector = mSelector;
Rect selectorRect = mSelectorRect;
if (selector != null && (isFocused() || touchModeDrawsInPressedState()) && !selectorRect.isEmpty())
{
final View v = getChildAt(mSelectedPosition - mFirstPosition);
if (v != null)
{
if (v.hasFocusable())
return;
v.setPressed(true);
}
setPressed(true);
final boolean longClickable = isLongClickable();
Drawable d = selector.getCurrent();
if (d != null && d instanceof TransitionDrawable)
{
if (longClickable)
{
((TransitionDrawable) d).startTransition(ViewConfiguration.getLongPressTimeout());
}
else
{
((TransitionDrawable) d).resetTransition();
}
}
if (longClickable && !mDataChanged)
{
if (mPendingCheckForKeyLongPress == null)
{
mPendingCheckForKeyLongPress = new CheckForKeyLongPress();
}
mPendingCheckForKeyLongPress.rememberWindowAttachCount();
postDelayed(mPendingCheckForKeyLongPress, ViewConfiguration.getLongPressTimeout());
}
}
}
public void setScrollIndicators(View up, View down)
{
mScrollUp = up;
mScrollDown = down;
}
private static final int[] NOTHING = new int[] { 0 };
void updateSelectorState()
{
if (mSelector != null)
{
if (shouldShowSelector())
{
mSelector.setState(getDrawableState());
}
else
{
mSelector.setState(NOTHING);
}
}
}
@Override
protected void drawableStateChanged()
{
super.drawableStateChanged();
updateSelectorState();
}
@Override
protected int[] onCreateDrawableState(int extraSpace)
{
// If the child view is enabled then do the default behavior.
if (mIsChildViewEnabled)
{
// Common case
return super.onCreateDrawableState(extraSpace);
}
// The selector uses this View's drawable state. The selected child view
// is disabled, so we need to remove the enabled state from the drawable
// states.
final int enabledState = ENABLED_STATE_SET[0];
// If we don't have any extra space, it will return one of the static state arrays,
// and clearing the enabled state on those arrays is a bad thing! If we specify
// we need extra space, it will create+copy into a new array that safely mutable.
int[] state = super.onCreateDrawableState(extraSpace + 1);
int enabledPos = -1;
for (int i = state.length - 1; i >= 0; i--)
{
if (state[i] == enabledState)
{
enabledPos = i;
break;
}
}
// Remove the enabled state
if (enabledPos >= 0)
{
System.arraycopy(state, enabledPos + 1, state, enabledPos, state.length - enabledPos - 1);
}
return state;
}
@Override
public boolean verifyDrawable(Drawable dr)
{
return mSelector == dr || super.verifyDrawable(dr);
}
@Override
public void invalidateDrawable(Drawable drawable)
{
// 默认的Android是有添加scroll值偏移的, 因为invalidate会减掉
// 但是selector返回的bound本本来就是未计算偏移量的
// 如果添加了, 会导致重绘区域不正确.
// so, 为了解决这操蛋的问题...
if (verifyDrawable(drawable)) {
invalidate(drawable.getBounds());
}
}
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
@Override
public void jumpDrawablesToCurrentState()
{
super.jumpDrawablesToCurrentState();
if (mSelector != null)
mSelector.jumpToCurrentState();
}
@Override
protected void onAttachedToWindow()
{
super.onAttachedToWindow();
final ViewTreeObserver treeObserver = getViewTreeObserver();
treeObserver.addOnTouchModeChangeListener(this);
if (mTextFilterEnabled && mPopup != null && !mGlobalLayoutListenerAddedFilter)
{
treeObserver.addOnGlobalLayoutListener(this);
}
if (mAdapter != null && mDataSetObserver == null)
{
mDataSetObserver = newObserver();
mAdapter.registerDataSetObserver(mDataSetObserver);
// Data may have changed while we were detached. Refresh.
mDataChanged = true;
mOldItemCount = mItemCount;
mItemCount = mAdapter.getCount();
requestLayout();
}
mIsAttached = true;
}
protected AdapterDataSetObserver newObserver()
{
return new AdapterDataSetObserver();
}
@Override
protected void onDetachedFromWindow()
{
super.onDetachedFromWindow();
// Dismiss the popup in case onSaveInstanceState() was not invoked
dismissPopup();
// Detach any view left in the scrap heap
mRecycler.clear();
final ViewTreeObserver treeObserver = getViewTreeObserver();
treeObserver.removeOnTouchModeChangeListener(this);
if (mTextFilterEnabled && mPopup != null)
{
treeObserver.removeGlobalOnLayoutListener(this);
mGlobalLayoutListenerAddedFilter = false;
}
if (mAdapter != null)
{
mAdapter.unregisterDataSetObserver(mDataSetObserver);
mDataSetObserver = null;
}
if (mScrollStrictSpan != null)
{
// mFlingStrictSpan.finish();
// mFlingStrictSpan = null;
mScrollStrictSpan = finishSpan(mScrollStrictSpan);
}
if (mFlingStrictSpan != null)
{
// mFlingStrictSpan.finish();
// mFlingStrictSpan = null;
mFlingStrictSpan = finishSpan(mFlingStrictSpan);
}
if (mFlingRunnable != null)
{
removeCallbacks(mFlingRunnable);
}
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
if (mClearScrollingCache != null)
{
removeCallbacks(mClearScrollingCache);
}
if (mPerformClick != null)
{
removeCallbacks(mPerformClick);
}
if (mTouchModeReset != null)
{
removeCallbacks(mTouchModeReset);
mTouchModeReset = null;
}
mIsAttached = false;
}
@Override
public void onWindowFocusChanged(boolean hasWindowFocus)
{
super.onWindowFocusChanged(hasWindowFocus);
final int touchMode = isInTouchMode() ? TOUCH_MODE_ON : TOUCH_MODE_OFF;
if (!hasWindowFocus)
{
setChildrenDrawingCacheEnabled(false);
if (mFlingRunnable != null)
{
removeCallbacks(mFlingRunnable);
// let the fling runnable report it's new state which
// should be idle
mFlingRunnable.endFling();
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
if (getScrollY() != 0)
{
mScrollY = 0;
invalidateParentCaches();
finishGlows();
invalidate();
}
}
// Always hide the type filter
dismissPopup();
if (touchMode == TOUCH_MODE_OFF)
{
// Remember the last selected element
mResurrectToPosition = mSelectedPosition;
}
}
else
{
if (mFiltered && !mPopupHidden)
{
// Show the type filter only if a filter is in effect
showPopup();
}
// If we changed touch mode since the last time we had focus
if (touchMode != mLastTouchMode && mLastTouchMode != TOUCH_MODE_UNKNOWN)
{
// If we come back in trackball mode, we bring the selection back
if (touchMode == TOUCH_MODE_OFF)
{
// This will trigger a layout
resurrectSelection();
// If we come back in touch mode, then we want to hide the selector
}
else
{
hideSelector();
mLayoutMode = LAYOUT_NORMAL;
layoutChildren();
}
}
}
mLastTouchMode = touchMode;
}
/**
* Creates the ContextMenuInfo returned from {@link #getContextMenuInfo()}. This methods knows the view, position
* and ID of the item that received the long press.
*
* @param view The view that received the long press.
* @param position The position of the item that received the long press.
* @param id The ID of the item that received the long press.
* @return The extra information that should be returned by {@link #getContextMenuInfo()}.
*/
ContextMenuInfo createContextMenuInfo(View view, int position, long id)
{
return new AdapterContextMenuInfo(view, position, id);
}
/**
* A base class for Runnables that will check that their view is still attached to the original window as when the
* Runnable was created.
*
*/
private class WindowRunnnable
{
private int mOriginalAttachCount;
public void rememberWindowAttachCount()
{
mOriginalAttachCount = getWindowAttachCount();
}
public boolean sameWindow()
{
return hasWindowFocus() && getWindowAttachCount() == mOriginalAttachCount;
}
}
private class PerformClick extends WindowRunnnable implements Runnable
{
int mClickMotionPosition;
public void run()
{
// The data has changed since we posted this action in the event queue,
// bail out before bad things happen
if (mDataChanged)
return;
final ListAdapter adapter = mAdapter;
final int motionPosition = mClickMotionPosition;
boolean isValidPosition = isValidPosition(motionPosition, mAdapter.getCount());
if (adapter != null && (isValidPosition || mCallbackOnUnClickItem) && sameWindow())
{
final View view = getChildAt(motionPosition - mFirstPosition);
// If there is no view, something bad happened (the view scrolled off the
// screen, etc.) and we should cancel the click
if (view != null || mCallbackOnUnClickItem)
{
performItemClick(view, motionPosition, isValidPosition ? adapter.getItemId(motionPosition) : 0);
}
}
}
}
private boolean isValidPosition(int motionPosition, int adapterCount)
{
return (mItemCount > 0 && motionPosition != INVALID_POSITION && motionPosition < adapterCount);
}
private class CheckForLongPress extends WindowRunnnable implements Runnable
{
public void run()
{
final int motionPosition = mMotionPosition;
final View child = getChildAt(motionPosition - mFirstPosition);
if (child != null)
{
final int longPressPosition = mMotionPosition;
final long longPressId = mAdapter.getItemId(mMotionPosition);
boolean handled = false;
if (sameWindow() && !mDataChanged)
{
handled = performLongPress(child, longPressPosition, longPressId);
}
if (handled)
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
setPressed(false);
child.setPressed(false);
}
else
{
mTouchMode = TOUCH_MODE_DONE_WAITING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_DONE_WAITING");
}
}
}
}
}
private class CheckForKeyLongPress extends WindowRunnnable implements Runnable
{
public void run()
{
if (isPressed() && mSelectedPosition >= 0)
{
int index = mSelectedPosition - mFirstPosition;
View v = getChildAt(index);
if (!mDataChanged)
{
boolean handled = false;
if (sameWindow())
{
handled = performLongPress(v, mSelectedPosition, mSelectedRowId);
}
if (handled)
{
setPressed(false);
v.setPressed(false);
}
}
else
{
setPressed(false);
if (v != null)
v.setPressed(false);
}
}
}
}
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
boolean performLongPress(final View child, final int longPressPosition, final long longPressId)
{
// CHOICE_MODE_MULTIPLE_MODAL takes over long press.
if (mChoiceMode == CHOICE_MODE_MULTIPLE_MODAL)
{
if (VersionUtils.isHoneycomb() && mChoiceActionMode == null
&& (mChoiceActionMode = startActionMode(mMultiChoiceModeCallback)) != null)
{
setItemChecked(longPressPosition, true);
performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
}
return true;
}
boolean handled = false;
if (mOnItemLongClickListener != null)
{
handled = mOnItemLongClickListener.onItemLongClick(AbsListView.this, child, longPressPosition, longPressId);
}
if (!handled)
{
mContextMenuInfo = createContextMenuInfo(child, longPressPosition, longPressId);
handled = super.showContextMenuForChild(AbsListView.this);
}
if (handled)
{
performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
}
return handled;
}
@Override
protected ContextMenuInfo getContextMenuInfo()
{
return mContextMenuInfo;
}
/** @hide */
public boolean showContextMenu(float x, float y, int metaState)
{
final int position = pointToPosition((int) x, (int) y);
if (position != INVALID_POSITION)
{
final long id = mAdapter.getItemId(position);
View child = getChildAt(position - mFirstPosition);
if (child != null)
{
mContextMenuInfo = createContextMenuInfo(child, position, id);
return super.showContextMenuForChild(AbsListView.this);
}
}
return super.showContextMenu();
}
@Override
public boolean showContextMenuForChild(View originalView)
{
final int longPressPosition = getPositionForView(originalView);
if (longPressPosition >= 0)
{
final long longPressId = mAdapter.getItemId(longPressPosition);
boolean handled = false;
if (mOnItemLongClickListener != null)
{
handled = mOnItemLongClickListener.onItemLongClick(AbsListView.this, originalView, longPressPosition,
longPressId);
}
if (!handled)
{
mContextMenuInfo = createContextMenuInfo(getChildAt(longPressPosition - mFirstPosition),
longPressPosition, longPressId);
handled = super.showContextMenuForChild(originalView);
}
return handled;
}
return false;
}
@Override
public boolean onKeyDown(int keyCode, KeyEvent event)
{
return false;
}
@Override
public boolean onKeyUp(int keyCode, KeyEvent event)
{
switch (keyCode)
{
case KeyEvent.KEYCODE_DPAD_CENTER:
case KeyEvent.KEYCODE_ENTER:
if (!isEnabled())
{
return true;
}
if (isClickable() && isPressed() && mSelectedPosition >= 0 && mAdapter != null
&& mSelectedPosition < mAdapter.getCount())
{
final View view = getChildAt(mSelectedPosition - mFirstPosition);
if (view != null)
{
performItemClick(view, mSelectedPosition, mSelectedRowId);
view.setPressed(false);
}
setPressed(false);
return true;
}
break;
}
return super.onKeyUp(keyCode, event);
}
@Override
protected void dispatchSetPressed(boolean pressed)
{
// Don't dispatch setPressed to our children. We call setPressed on ourselves to
// get the selector in the right state, but we don't want to press each child.
}
/**
* Maps a point to a position in the list.
*
* @param x X in local coordinate
* @param y Y in local coordinate
* @return The position of the item which contains the specified point, or {@link #INVALID_POSITION} if the point
* does not intersect an item.
*/
public int pointToPosition(int x, int y)
{
Rect frame = mTouchFrame;
if (frame == null)
{
mTouchFrame = new Rect();
frame = mTouchFrame;
}
final int count = getChildCount();
for (int i = count - 1; i >= 0; i--)
{
final View child = getChildAt(i);
if (child.getVisibility() == View.VISIBLE)
{
child.getHitRect(frame);
if (frame.contains(x, y))
{
return mFirstPosition + i;
}
}
}
return INVALID_POSITION;
}
/**
* Maps a point to a the rowId of the item which intersects that point.
*
* @param x X in local coordinate
* @param y Y in local coordinate
* @return The rowId of the item which contains the specified point, or {@link #INVALID_ROW_ID} if the point does
* not intersect an item.
*/
public long pointToRowId(int x, int y)
{
int position = pointToPosition(x, y);
if (position >= 0)
{
return mAdapter.getItemId(position);
}
return INVALID_ROW_ID;
}
final class CheckForTap implements Runnable
{
public void run()
{
if (mTouchMode == TOUCH_MODE_DOWN)
{
mTouchMode = TOUCH_MODE_TAP;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_TAP");
}
final View child = getChildAt(mMotionPosition - mFirstPosition);
if (child != null && !child.hasFocusable())
{
mLayoutMode = LAYOUT_NORMAL;
if (!mDataChanged)
{
child.setPressed(true);
setPressed(true);
layoutChildren();
positionSelector(mMotionPosition, child);
refreshDrawableState();
final int longPressTimeout = ViewConfiguration.getLongPressTimeout();
final boolean longClickable = isLongClickable();
if (mSelector != null)
{
Drawable d = mSelector.getCurrent();
if (d != null && d instanceof TransitionDrawable)
{
if (longClickable)
{
((TransitionDrawable) d).startTransition(longPressTimeout);
}
else
{
((TransitionDrawable) d).resetTransition();
}
}
}
if (longClickable)
{
if (mPendingCheckForLongPress == null)
{
mPendingCheckForLongPress = new CheckForLongPress();
}
mPendingCheckForLongPress.rememberWindowAttachCount();
postDelayed(mPendingCheckForLongPress, longPressTimeout);
}
else
{
mTouchMode = TOUCH_MODE_DONE_WAITING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_DONE_WAITING");
}
}
}
else
{
mTouchMode = TOUCH_MODE_DONE_WAITING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_DONE_WAITING");
}
}
}
}
}
}
private boolean startScrollIfNeeded(int y)
{
// Check if we have moved far enough that it looks more like a
// scroll than a tap
final int deltaY = y - mMotionY;
final int distance = Math.abs(deltaY);
final boolean overscroll = mScrollY != 0;
if (overscroll || distance > mTouchSlop)
{
createScrollingCache();
if (overscroll)
{
mTouchMode = TOUCH_MODE_OVERSCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERSCROLL");
}
mMotionCorrection = 0;
}
else
{
mTouchMode = TOUCH_MODE_SCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_SCROLL");
}
mMotionCorrection = deltaY > 0 ? mTouchSlop : -mTouchSlop;
}
final Handler handler = getHandler();
// Handler should not be null unless the AbsListView is not attached to a
// window, which would make it very hard to scroll it... but the monkeys
// say it's possible.
if (handler != null)
{
handler.removeCallbacks(mPendingCheckForLongPress);
}
setPressed(false);
View motionView = getChildAt(mMotionPosition - mFirstPosition);
if (motionView != null)
{
motionView.setPressed(false);
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_TOUCH_SCROLL);
// Time to start stealing events! Once we've stolen them, don't let anyone
// steal from us
final ViewParent parent = getParent();
if (parent != null)
{
parent.requestDisallowInterceptTouchEvent(true);
}
scrollIfNeeded(y);
return true;
}
return false;
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
private void scrollIfNeeded(int y)
{
final int rawDeltaY = y - mMotionY;
final int deltaY = rawDeltaY - mMotionCorrection;
int incrementalDeltaY = mLastY != Integer.MIN_VALUE ? y - mLastY : deltaY;
if (mTouchMode == TOUCH_MODE_SCROLL)
{
if (PROFILE_SCROLLING)
{
if (!mScrollProfilingStarted)
{
Debug.startMethodTracing("AbsListViewScroll");
mScrollProfilingStarted = true;
}
}
if (mScrollStrictSpan == null)
{
// If it's non-null, we're already in a scroll.
mScrollStrictSpan = enterCriticalSpan("AbsListView-scroll");
}
if (y != mLastY)
{
// We may be here after stopping a fling and continuing to scroll.
// If so, we haven't disallowed intercepting touch events yet.
// Make sure that we do so in case we're in a parent that can intercept.
if ((mGroupFlags & 0x80000 /* FLAG_DISALLOW_INTERCEPT */) == 0 && Math.abs(rawDeltaY) > mTouchSlop)
{
final ViewParent parent = getParent();
if (parent != null)
{
parent.requestDisallowInterceptTouchEvent(true);
}
}
final int motionIndex;
if (mMotionPosition >= 0)
{
motionIndex = mMotionPosition - mFirstPosition;
}
else
{
// If we don't have a motion position that we can reliably track,
// pick something in the middle to make a best guess at things below.
motionIndex = getChildCount() / 2;
}
int motionViewPrevTop = 0;
View motionView = this.getChildAt(motionIndex);
if (motionView != null)
{
motionViewPrevTop = motionView.getTop();
}
// No need to do all this work if we're not going to move anyway
boolean atEdge = false;
if (incrementalDeltaY != 0)
{
atEdge = trackMotionScroll(deltaY, incrementalDeltaY);
}
// Check to see if we have bumped into the scroll limit
motionView = this.getChildAt(motionIndex);
if (motionView != null)
{
// Check if the top of the motion view is where it is
// supposed to be
final int motionViewRealTop = motionView.getTop();
if (atEdge)
{
// Apply overscroll
int overscroll = -incrementalDeltaY - (motionViewRealTop - motionViewPrevTop);
overScrollBy(0, reviseOverScrollByTouch(overscroll), 0, getScrollY(), 0, 0, 0, mOverscrollDistance, true);
if (Math.abs(mOverscrollDistance) == Math.abs(getScrollY()))
{
// Don't allow overfling if we're at the edge.
if (mVelocityTracker != null)
{
mVelocityTracker.clear();
}
}
final int overscrollMode = getOverScrollMode();
if (overscrollMode == OVER_SCROLL_ALWAYS
|| (overscrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && !contentFits()))
{
mDirection = 0; // Reset when entering overscroll.
mTouchMode = TOUCH_MODE_OVERSCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERSCROLL");
}
// if(mEdgeGlowTop != null)
// {
// if (rawDeltaY > 0)
// {
// mEdgeGlowTop.onPull((float) overscroll / getHeight());
// if (!mEdgeGlowBottom.isFinished())
// {
// mEdgeGlowBottom.onRelease();
// }
// }
// else if (rawDeltaY < 0)
// {
// mEdgeGlowBottom.onPull((float) overscroll / getHeight());
// if (!mEdgeGlowTop.isFinished())
// {
// mEdgeGlowTop.onRelease();
// }
// }
// }
}
}
mMotionY = y;
invalidate();
}
mLastY = y;
}
}
else if (mTouchMode == TOUCH_MODE_OVERSCROLL)
{
if (y != mLastY)
{
final int oldScroll = getScrollY();
final int newScroll = oldScroll - incrementalDeltaY;
int newDirection = y > mLastY ? 1 : -1;
if (mDirection == 0)
{
mDirection = newDirection;
}
int overScrollDistance = -incrementalDeltaY;
if ((newScroll < 0 && oldScroll >= 0) || (newScroll > 0 && oldScroll <= 0))
{
overScrollDistance = -oldScroll;
incrementalDeltaY += overScrollDistance;
}
else
{
incrementalDeltaY = 0;
}
if (overScrollDistance != 0)
{
final int scrollY = getScrollY();
overScrollBy(0, reviseOverScrollByTouch(overScrollDistance), 0, scrollY, 0, 0, 0, mOverscrollDistance, true);
final int overscrollMode = getOverScrollMode();
if (overscrollMode == OVER_SCROLL_ALWAYS
|| (overscrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && !contentFits()))
{
// if(mEdgeGlowTop != null)
// {
// if (rawDeltaY > 0)
// {
// mEdgeGlowTop.onPull((float) overScrollDistance / getHeight());
// if (!mEdgeGlowBottom.isFinished())
// {
// mEdgeGlowBottom.onRelease();
// }
// }
// else if (rawDeltaY < 0)
// {
// mEdgeGlowBottom.onPull((float) overScrollDistance / getHeight());
// if (!mEdgeGlowTop.isFinished())
// {
// mEdgeGlowTop.onRelease();
// }
// }
// }
invalidate();
}
}
if (incrementalDeltaY != 0)
{
// Coming back to 'real' list scrolling
mScrollY = 0;
invalidateParentIfNeeded();
// No need to do all this work if we're not going to move anyway
if (incrementalDeltaY != 0)
{
trackMotionScroll(incrementalDeltaY, incrementalDeltaY);
}
mTouchMode = TOUCH_MODE_SCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_SCROLL");
}
// We did not scroll the full amount. Treat this essentially like the
// start of a new touch scroll
final int motionPosition = findClosestMotionRow(y);
mMotionCorrection = 0;
View motionView = getChildAt(motionPosition - mFirstPosition);
mMotionViewOriginalTop = motionView != null ? motionView.getTop() : 0;
mMotionY = y;
mMotionPosition = motionPosition;
}
mLastY = y;
mDirection = newDirection;
}
}
}
private int reviseOverScrollByTouch(int srcs)
{
if (srcs * mScrollY < 0)
{
return srcs;
}
else
{
int res = (mLayoutHeight - Math.abs(mScrollY)) * srcs / mLayoutHeight / 2;
return res;
}
}
public void onTouchModeChanged(boolean isInTouchMode)
{
if (isInTouchMode)
{
// Get rid of the selection when we enter touch mode
hideSelector();
// Layout, but only if we already have done so previously.
// (Otherwise may clobber a LAYOUT_SYNC layout that was requested to restore
// state.)
if (getHeight() > 0 && getChildCount() > 0)
{
// We do not lose focus initiating a touch (since AbsListView is focusable in
// touch mode). Force an initial layout to get rid of the selection.
layoutChildren();
}
updateSelectorState();
}
else
{
int touchMode = mTouchMode;
if (touchMode == TOUCH_MODE_OVERSCROLL || touchMode == TOUCH_MODE_OVERFLING)
{
if (mFlingRunnable != null && mScrollY == 0)
{
mFlingRunnable.endFling();
}
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
if (getScrollY() != 0)
{
mScrollY = 0;
invalidateParentCaches();
finishGlows();
invalidate();
}
}
}
}
@TargetApi(Build.VERSION_CODES.FROYO)
@Override
public boolean onTouchEvent(MotionEvent ev)
{
if (!isEnabled())
{
// A disabled view that is clickable still consumes the touch
// events, it just doesn't respond to them.
return isClickable() || isLongClickable();
}
if (mFastScroller != null)
{
boolean intercepted = mFastScroller.onTouchEvent(ev);
if (intercepted)
{
return true;
}
}
final int action = ev.getAction();
View v;
initVelocityTrackerIfNotExists();
mVelocityTracker.addMovement(ev);
switch (action & MotionEvent.ACTION_MASK)
{
case MotionEvent.ACTION_DOWN:
{
switch (mTouchMode)
{
case TOUCH_MODE_OVERFLING:
{
mFlingRunnable.endFling();
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
mTouchMode = TOUCH_MODE_OVERSCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERSCROLL");
}
mMotionX = (int) ev.getX();
mMotionY = mLastY = (int) ev.getY();
mMotionCorrection = 0;
mActivePointerId = ev.getPointerId(0);
mDirection = 0;
break;
}
default:
{
// mFlingRunnable.endFling();
mActivePointerId = ev.getPointerId(0);
final int x = (int) ev.getX();
final int y = (int) ev.getY();
int motionPosition = pointToPosition(x, y + getScrollY());
if (!mDataChanged)
{
if ((mTouchMode != TOUCH_MODE_FLING) && (motionPosition >= 0)
&& (getAdapter().isEnabled(motionPosition)))
{
// User clicked on an actual view (and was not stopping a fling).
// It might be a click or a scroll. Assume it is a click until
// proven otherwise
mTouchMode = TOUCH_MODE_DOWN;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_DOWN");
}
// FIXME Debounce
if (mPendingCheckForTap == null)
{
mPendingCheckForTap = new CheckForTap();
}
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
}
else
{
if (mTouchMode == TOUCH_MODE_FLING)
{
// Stopped a fling. It is a scroll.
createScrollingCache();
mFlingRunnable.endFling();
mTouchMode = TOUCH_MODE_SCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_SCROLL");
}
mMotionCorrection = 0;
motionPosition = findMotionRow(y);
mFlingRunnable.flywheelTouch();
}
}
}
if (motionPosition >= 0)
{
// Remember where the motion event started
v = getChildAt(motionPosition - mFirstPosition);
mMotionViewOriginalTop = v.getTop();
}
mMotionX = x;
mMotionY = y;
mMotionPosition = motionPosition;
mLastY = Integer.MIN_VALUE;
break;
}
}
if (performButtonActionOnTouchDown(ev))
{
if (mTouchMode == TOUCH_MODE_DOWN)
{
removeCallbacks(mPendingCheckForTap);
}
}
break;
}
case MotionEvent.ACTION_MOVE:
{
int pointerIndex = ev.findPointerIndex(mActivePointerId);
if (pointerIndex == -1)
{
pointerIndex = 0;
mActivePointerId = ev.getPointerId(pointerIndex);
}
final int y = (int) ev.getY(pointerIndex);
switch (mTouchMode)
{
case TOUCH_MODE_DOWN:
case TOUCH_MODE_TAP:
case TOUCH_MODE_DONE_WAITING:
// Check if we have moved far enough that it looks more like a
// scroll than a tap
startScrollIfNeeded(y);
break;
case TOUCH_MODE_SCROLL:
case TOUCH_MODE_OVERSCROLL:
scrollIfNeeded(y);
break;
}
break;
}
case MotionEvent.ACTION_UP:
{
switch (mTouchMode)
{
case TOUCH_MODE_DOWN:
case TOUCH_MODE_TAP:
case TOUCH_MODE_DONE_WAITING:
final int motionPosition = mMotionPosition;
final View child = getChildAt(motionPosition - mFirstPosition);
final float x = ev.getX();
final boolean inList = x > mListPadding.left && x < getWidth() - mListPadding.right;
if (mPerformClick == null)
{
mPerformClick = new PerformClick();
}
final AbsListView.PerformClick performClick = mPerformClick;
performClick.mClickMotionPosition = motionPosition;
performClick.rememberWindowAttachCount();
if (child != null && !child.hasFocusable() && inList)
{
if (mTouchMode != TOUCH_MODE_DOWN)
{
child.setPressed(false);
}
mResurrectToPosition = motionPosition;
if (mTouchMode == TOUCH_MODE_DOWN || mTouchMode == TOUCH_MODE_TAP)
{
final Handler handler = getHandler();
if (handler != null)
{
handler.removeCallbacks(mTouchMode == TOUCH_MODE_DOWN ? mPendingCheckForTap
: mPendingCheckForLongPress);
}
mLayoutMode = LAYOUT_NORMAL;
if (!mDataChanged && mAdapter.isEnabled(motionPosition))
{
mTouchMode = TOUCH_MODE_TAP;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_TAP");
}
setSelectedPositionInt(mMotionPosition);
layoutChildren();
child.setPressed(true);
positionSelector(mMotionPosition, child);
setPressed(true);
if (mSelector != null)
{
Drawable d = mSelector.getCurrent();
if (d != null && d instanceof TransitionDrawable)
{
((TransitionDrawable) d).resetTransition();
}
}
if (mTouchModeReset != null)
{
removeCallbacks(mTouchModeReset);
}
mTouchModeReset = new Runnable()
{
@Override
public void run()
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
child.setPressed(false);
setPressed(false);
if (!mDataChanged)
{
performClick.run();
}
}
};
postDelayed(mTouchModeReset, ViewConfiguration.getPressedStateDuration());
}
else
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
updateSelectorState();
}
return true;
}
else if (!mDataChanged && mAdapter.isEnabled(motionPosition))
{
performClick.run();
}
}
else
{
performClick.run();
}
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
updateSelectorState();
break;
case TOUCH_MODE_SCROLL:
final int childCount = getChildCount();
if (childCount > 0)
{
final int firstChildTop = getChildAt(0).getTop();
final int lastChildBottom = getChildAt(childCount - 1).getBottom();
final int contentTop = mListPadding.top;
final int contentBottom = getHeight() - mListPadding.bottom;
if (mFirstPosition == 0 && firstChildTop >= contentTop && mFirstPosition + childCount < mItemCount
&& lastChildBottom <= getHeight() - contentBottom)
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
}
else
{
final VelocityTracker velocityTracker = mVelocityTracker;
velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
final int initialVelocity = (int) ((VersionUtils.isrFroyo() ? velocityTracker
.getYVelocity(mActivePointerId) : velocityTracker.getYVelocity()) * mVelocityScale);
// Fling if we have enough velocity and we aren't at a boundary.
// Since we can potentially overfling more than we can overscroll, don't
// allow the weird behavior where you can scroll to a boundary then
// fling further.
if (Math.abs(initialVelocity) > mMinimumVelocity
&& !((mFirstPosition == 0 && firstChildTop == contentTop - mOverscrollDistance)
|| (mFirstPosition + childCount == mItemCount
&& lastChildBottom == contentBottom + mOverscrollDistance)))
{
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_FLING);
mFlingRunnable.start(-initialVelocity);
}
else
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
if (mFlingRunnable != null)
{
mFlingRunnable.endFling();
}
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
}
}
}
else
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
}
break;
case TOUCH_MODE_OVERSCROLL:
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
// final VelocityTracker velocityTracker = mVelocityTracker;
// velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
// final int initialVelocity = VersionUtils.isrFroyo() ? (int) velocityTracker
// .getYVelocity(mActivePointerId) : (int) velocityTracker.getYVelocity();
reportScrollStateChange(OnScrollListener.SCROLL_STATE_FLING);
// if (Math.abs(initialVelocity) > mMinimumVelocity)
// {
// mFlingRunnable.startOverfling(-initialVelocity);
// }
// else
{
mFlingRunnable.startSpringback(getSpringbackOffset());
}
break;
}
setPressed(false);
// if (mEdgeGlowTop != null)
// {
// mEdgeGlowTop.onRelease();
// mEdgeGlowBottom.onRelease();
// }
// Need to redraw since we probably aren't drawing the selector anymore
invalidate();
final Handler handler = getHandler();
if (handler != null)
{
handler.removeCallbacks(mPendingCheckForLongPress);
}
recycleVelocityTracker();
mActivePointerId = INVALID_POINTER;
if (PROFILE_SCROLLING)
{
if (mScrollProfilingStarted)
{
Debug.stopMethodTracing();
mScrollProfilingStarted = false;
}
}
if (mScrollStrictSpan != null)
{
// mScrollStrictSpan.finish();
// mScrollStrictSpan = null;
mScrollStrictSpan = finishSpan(mScrollStrictSpan);
}
break;
}
case MotionEvent.ACTION_CANCEL:
{
switch (mTouchMode)
{
case TOUCH_MODE_OVERSCROLL:
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
mFlingRunnable.startSpringback(0);
break;
case TOUCH_MODE_OVERFLING:
// Do nothing - let it play out.
break;
default:
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
setPressed(false);
View motionView = this.getChildAt(mMotionPosition - mFirstPosition);
if (motionView != null)
{
motionView.setPressed(false);
}
clearScrollingCache();
final Handler handler = getHandler();
if (handler != null)
{
handler.removeCallbacks(mPendingCheckForLongPress);
}
recycleVelocityTracker();
}
// if (mEdgeGlowTop != null)
// {
// mEdgeGlowTop.onRelease();
// mEdgeGlowBottom.onRelease();
// }
mActivePointerId = INVALID_POINTER;
break;
}
case MotionEvent.ACTION_POINTER_UP:
{
if (VersionUtils.isrFroyo())
{
onSecondaryPointerUp(ev);
final int x = mMotionX;
final int y = mMotionY;
final int motionPosition = pointToPosition(x, y);
if (motionPosition >= 0)
{
// Remember where the motion event started
v = getChildAt(motionPosition - mFirstPosition);
mMotionViewOriginalTop = v.getTop();
mMotionPosition = motionPosition;
}
mLastY = y;
}
break;
}
case MotionEvent.ACTION_POINTER_DOWN:
{
if (VersionUtils.isrFroyo())
{
// New pointers take over dragging duties
final int index = ev.getActionIndex();
final int id = ev.getPointerId(index);
final int x = (int) ev.getX(index);
final int y = (int) ev.getY(index);
mMotionCorrection = 0;
mActivePointerId = id;
mMotionX = x;
mMotionY = y;
final int motionPosition = pointToPosition(x, y);
if (motionPosition >= 0)
{
// Remember where the motion event started
v = getChildAt(motionPosition - mFirstPosition);
mMotionViewOriginalTop = v.getTop();
mMotionPosition = motionPosition;
}
mLastY = y;
}
break;
}
}
return true;
}
/**
* SpringBack 偏移量, 用来显示OverScroller header
* @return
*/
protected int getSpringbackOffset()
{
return 0;
}
@Override
protected void onOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY)
{
if (getScrollY() != scrollY)
{
onScrollChanged(getScrollX(), scrollY, getScrollX(), getScrollY());
mScrollY = scrollY;
invalidateParentIfNeeded();
awakenScrollBars();
}
}
@TargetApi(Build.VERSION_CODES.HONEYCOMB_MR1)
@Override
public boolean onGenericMotionEvent(MotionEvent event)
{
if ((event.getSource() & InputDevice.SOURCE_CLASS_POINTER) != 0)
{
switch (event.getAction())
{
case MotionEvent.ACTION_SCROLL:
{
if (mTouchMode == TOUCH_MODE_REST)
{
final float vscroll = event.getAxisValue(MotionEvent.AXIS_VSCROLL);
if (vscroll != 0)
{
final int delta = (int) (vscroll * getVerticalScrollFactor());
if (!trackMotionScroll(delta, delta))
{
return true;
}
}
}
}
}
}
return super.onGenericMotionEvent(event);
}
@Override
public void draw(Canvas canvas)
{
super.draw(canvas);
// if (mEdgeGlowTop != null)
// {
// final int scrollY = mScrollY;
// if (!mEdgeGlowTop.isFinished())
// {
// final int restoreCount = canvas.save();
// final int leftPadding = mListPadding.left + mGlowPaddingLeft;
// final int rightPadding = mListPadding.right + mGlowPaddingRight;
// final int width = getWidth() - leftPadding - rightPadding;
//
// canvas.translate(leftPadding, Math.min(0, scrollY + mFirstPositionDistanceGuess));
// mEdgeGlowTop.setSize(width, getHeight());
// if (mEdgeGlowTop.draw(canvas))
// {
// invalidate();
// }
// canvas.restoreToCount(restoreCount);
// }
// if (!mEdgeGlowBottom.isFinished())
// {
// final int restoreCount = canvas.save();
// final int leftPadding = mListPadding.left + mGlowPaddingLeft;
// final int rightPadding = mListPadding.right + mGlowPaddingRight;
// final int width = getWidth() - leftPadding - rightPadding;
// final int height = getHeight();
//
// canvas.translate(-width + leftPadding, Math.max(height, scrollY + mLastPositionDistanceGuess));
// canvas.rotate(180, width, 0);
// mEdgeGlowBottom.setSize(width, height);
// if (mEdgeGlowBottom.draw(canvas))
// {
// invalidate();
// }
// canvas.restoreToCount(restoreCount);
// }
// }
if (mFastScroller != null)
{
final int scrollY = mScrollY;
if (scrollY != 0)
{
// Pin to the top/bottom during overscroll
int restoreCount = canvas.save();
canvas.translate(0, (float) scrollY);
mFastScroller.draw(canvas);
canvas.restoreToCount(restoreCount);
}
else
{
mFastScroller.draw(canvas);
}
}
}
/**
* @hide
*/
public void setOverScrollEffectPadding(int leftPadding, int rightPadding)
{
mGlowPaddingLeft = leftPadding;
mGlowPaddingRight = rightPadding;
}
private void initOrResetVelocityTracker()
{
if (mVelocityTracker == null)
{
mVelocityTracker = VelocityTracker.obtain();
}
else
{
mVelocityTracker.clear();
}
}
private void initVelocityTrackerIfNotExists()
{
if (mVelocityTracker == null)
{
mVelocityTracker = VelocityTracker.obtain();
}
}
private void recycleVelocityTracker()
{
if (mVelocityTracker != null)
{
mVelocityTracker.recycle();
mVelocityTracker = null;
}
}
@Override
public void requestDisallowInterceptTouchEvent(boolean disallowIntercept)
{
if (disallowIntercept)
{
recycleVelocityTracker();
}
super.requestDisallowInterceptTouchEvent(disallowIntercept);
}
@Override
public boolean onInterceptTouchEvent(MotionEvent ev)
{
int action = ev.getAction();
View v;
if (mFastScroller != null)
{
boolean intercepted = mFastScroller.onInterceptTouchEvent(ev);
if (intercepted)
{
return true;
}
}
switch (action & MotionEvent.ACTION_MASK)
{
case MotionEvent.ACTION_DOWN:
{
int touchMode = mTouchMode;
if (touchMode == TOUCH_MODE_OVERFLING || touchMode == TOUCH_MODE_OVERSCROLL)
{
mMotionCorrection = 0;
return true;
}
final int x = (int) ev.getX();
final int y = (int) ev.getY();
mActivePointerId = ev.getPointerId(0);
int motionPosition = findClosestMotionRow(y);
if (touchMode != TOUCH_MODE_FLING && motionPosition >= 0)
{
// User clicked on an actual view (and was not stopping a fling).
// Remember where the motion event started
v = getChildAt(motionPosition - mFirstPosition);
mMotionViewOriginalTop = v.getTop();
mMotionX = x;
mMotionY = y;
mMotionPosition = motionPosition;
mTouchMode = TOUCH_MODE_DOWN;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_DOWN");
}
clearScrollingCache();
}
mLastY = Integer.MIN_VALUE;
initOrResetVelocityTracker();
mVelocityTracker.addMovement(ev);
if (touchMode == TOUCH_MODE_FLING)
{
return true;
}
break;
}
case MotionEvent.ACTION_MOVE:
{
switch (mTouchMode)
{
case TOUCH_MODE_DOWN:
int pointerIndex = ev.findPointerIndex(mActivePointerId);
if (pointerIndex == -1)
{
pointerIndex = 0;
mActivePointerId = ev.getPointerId(pointerIndex);
}
final int y = (int) ev.getY(pointerIndex);
initVelocityTrackerIfNotExists();
mVelocityTracker.addMovement(ev);
if (startScrollIfNeeded(y))
{
return true;
}
break;
}
break;
}
case MotionEvent.ACTION_CANCEL:
case MotionEvent.ACTION_UP:
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
mActivePointerId = INVALID_POINTER;
recycleVelocityTracker();
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
break;
}
case MotionEvent.ACTION_POINTER_UP:
{
onSecondaryPointerUp(ev);
break;
}
}
return false;
}
private void onSecondaryPointerUp(MotionEvent ev)
{
final int pointerIndex = (ev.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) >> MotionEvent.ACTION_POINTER_INDEX_SHIFT;
final int pointerId = ev.getPointerId(pointerIndex);
if (pointerId == mActivePointerId)
{
// This was our active pointer going up. Choose a new
// active pointer and adjust accordingly.
// TODO: Make this decision more intelligent.
final int newPointerIndex = pointerIndex == 0 ? 1 : 0;
mMotionX = (int) ev.getX(newPointerIndex);
mMotionY = (int) ev.getY(newPointerIndex);
mMotionCorrection = 0;
mActivePointerId = ev.getPointerId(newPointerIndex);
}
}
/**
* {@inheritDoc}
*/
@Override
public void addTouchables(ArrayList<View> views)
{
final int count = getChildCount();
final int firstPosition = mFirstPosition;
final ListAdapter adapter = mAdapter;
if (adapter == null)
{
return;
}
for (int i = 0; i < count; i++)
{
final View child = getChildAt(i);
if (adapter.isEnabled(firstPosition + i))
{
views.add(child);
}
child.addTouchables(views);
}
}
/**
* Fires an "on scroll state changed" event to the registered {@link android.widget.AbsListView.OnScrollListener},
* if any. The state change is fired only if the specified state is different from the previously known state.
*
* @param newState The new scroll state.
*/
protected void reportScrollStateChange(int newState)
{
if (newState != mLastScrollState)
{
if (mOnScrollListener != null)
{
mLastScrollState = newState;
mOnScrollListener.onScrollStateChanged(this, newState);
}
}
}
/**
* Responsible for fling behavior. Use {@link #start(int)} to initiate a fling. Each frame of the fling is handled
* in {@link #run()}. A FlingRunnable will keep re-posting itself until the fling is done.
*
*/
private class FlingRunnable implements Runnable
{
/**
* Tracks the decay of a fling scroll
*/
private final OverScroller mScroller;
/**
* Y value reported by mScroller on the previous fling
*/
private int mLastFlingY;
private final Runnable mCheckFlywheel = new Runnable()
{
@TargetApi(Build.VERSION_CODES.FROYO)
public void run()
{
final int activeId = mActivePointerId;
final VelocityTracker vt = mVelocityTracker;
final OverScroller scroller = mScroller;
if (vt == null || activeId == INVALID_POINTER)
{
return;
}
vt.computeCurrentVelocity(1000, mMaximumVelocity);
final float yvel = VersionUtils.isrFroyo() ? -vt.getYVelocity(activeId) : -vt.getYVelocity();
if (Math.abs(yvel) >= mMinimumVelocity && scroller.isScrollingInDirection(0, yvel))
{
// Keep the fling alive a little longer
postDelayed(this, FLYWHEEL_TIMEOUT);
}
else
{
endFling();
mTouchMode = TOUCH_MODE_SCROLL;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_SCROLL");
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_TOUCH_SCROLL);
}
}
};
private static final int FLYWHEEL_TIMEOUT = 40; // milliseconds
FlingRunnable()
{
mScroller = new OverScroller(getContext());
}
void start(int initialVelocity)
{
int initialY = initialVelocity < 0 ? Integer.MAX_VALUE : 0;
mLastFlingY = initialY;
mScroller.fling(0, initialY, 0, initialVelocity, 0, Integer.MAX_VALUE, 0, Integer.MAX_VALUE);
mTouchMode = TOUCH_MODE_FLING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_FLING");
}
post(this);
if (PROFILE_FLINGING)
{
if (!mFlingProfilingStarted)
{
Debug.startMethodTracing("AbsListViewFling");
mFlingProfilingStarted = true;
}
}
if (mFlingStrictSpan == null)
{
mFlingStrictSpan = enterCriticalSpan("AbsListView-fling");
}
}
void startSpringback(int offset)
{
// if(Math.abs(getScrollY()) < offset)
// {
// throw new IllegalArgumentException();
// }
if (mScroller.springBack(0, getScrollY(), offset, offset, offset, offset))
{
mTouchMode = TOUCH_MODE_OVERFLING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERFLING");
}
invalidate();
post(this);
}
else
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
}
}
void startOverfling(int initialVelocity)
{
// TODO 这个算法有BUG..
mScroller.fling(0, getScrollY(), 0, initialVelocity, 0, 0, Integer.MIN_VALUE, Integer.MAX_VALUE, 0,
getHeight());
mTouchMode = TOUCH_MODE_OVERFLING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERFLING");
}
invalidate();
post(this);
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
void edgeReached(int delta)
{
mScroller.notifyVerticalEdgeReached(delta, 0, delta > 0 ? mTopOverflingDistance : mBottomOverflingDistance);
final int overscrollMode = getOverScrollMode();
if (overscrollMode == OVER_SCROLL_ALWAYS
|| (overscrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && !contentFits()))
{
mTouchMode = TOUCH_MODE_OVERFLING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_OVERFLING");
}
// final int vel = (int) mScroller.getCurrVelocity();
// if(mEdgeGlowTop != null)
// {
// if (delta > 0)
// {
// mEdgeGlowTop.onAbsorb(vel);
// }
// else
// {
// mEdgeGlowBottom.onAbsorb(vel);
// }
// }
}
else
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
}
invalidate();
post(this);
}
void startScroll(int distance, int duration)
{
int initialY = distance < 0 ? Integer.MAX_VALUE : 0;
mLastFlingY = initialY;
mScroller.startScroll(0, initialY, 0, distance, duration);
mTouchMode = TOUCH_MODE_FLING;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_FLING");
}
post(this);
}
void endFling()
{
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
removeCallbacks(this);
removeCallbacks(mCheckFlywheel);
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
clearScrollingCache();
mScroller.abortAnimation();
if (mFlingStrictSpan != null)
{
// mFlingStrictSpan.finish();
// mFlingStrictSpan = null;
mFlingStrictSpan = finishSpan(mFlingStrictSpan);
}
}
void flywheelTouch()
{
postDelayed(mCheckFlywheel, FLYWHEEL_TIMEOUT);
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
public void run()
{
switch (mTouchMode)
{
default:
endFling();
return;
case TOUCH_MODE_SCROLL:
if (mScroller.isFinished())
{
return;
}
// Fall through
case TOUCH_MODE_FLING:
{
traceBegin("AbsListView.FlingRunable.onfling");
try
{
if (mDataChanged)
{
layoutChildren();
}
if (mItemCount == 0 || getChildCount() == 0)
{
endFling();
return;
}
final OverScroller scroller = mScroller;
boolean more = scroller.computeScrollOffset();
final int y = scroller.getCurrY();
// Flip sign to convert finger direction to list items direction
// (e.g. finger moving down means list is moving towards the top)
int delta = mLastFlingY - y;
// Pretend that each frame of a fling scroll is a touch scroll
if (delta > 0)
{
// List is moving towards the top. Use first view as mMotionPosition
mMotionPosition = mFirstPosition;
final View firstView = getChildAt(0);
mMotionViewOriginalTop = firstView.getTop();
// Don't fling more than 1 screen
delta = Math.min(getHeight() - mPaddingBottom - mPaddingTop - 1, delta);
}
else
{
// List is moving towards the bottom. Use last view as mMotionPosition
int offsetToLast = getChildCount() - 1;
mMotionPosition = mFirstPosition + offsetToLast;
final View lastView = getChildAt(offsetToLast);
mMotionViewOriginalTop = lastView.getTop();
// Don't fling more than 1 screen
delta = Math.max(-(getHeight() - mPaddingBottom - mPaddingTop - 1), delta);
}
// Check to see if we have bumped into the scroll limit
View motionView = getChildAt(mMotionPosition - mFirstPosition);
int oldTop = 0;
if (motionView != null)
{
oldTop = motionView.getTop();
}
// Don't stop just because delta is zero (it could have been rounded)
final boolean atEnd = trackMotionScroll(delta, delta) && (delta != 0);
if (atEnd)
{
if (motionView != null)
{
// Tweak the scroll for how far we overshot
int overshoot = -(delta - (motionView.getTop() - oldTop));
if (more)
{
edgeReached(overshoot);
overshoot = mScroller.getCurrY();
}
overScrollBy(0, overshoot, 0, getScrollY(), 0, 0, 0, mOverscrollDistance, false);
}
break;
}
if (more && !atEnd)
{
invalidate();
mLastFlingY = y;
post(this);
}
else
{
endFling();
if (PROFILE_FLINGING)
{
if (mFlingProfilingStarted)
{
Debug.stopMethodTracing();
mFlingProfilingStarted = false;
}
if (mFlingStrictSpan != null)
{
// mFlingStrictSpan.finish();
// mFlingStrictSpan = null;
mFlingStrictSpan = finishSpan(mFlingStrictSpan);
}
}
}
break;
}
finally
{
traceEnd();
}
}
case TOUCH_MODE_OVERFLING:
{
if(DEBUG)
{
traceBegin("AbsListView.FlingRunable.onOverfling");
}
try
{
final OverScroller scroller = mScroller;
if (scroller.computeScrollOffset())
{
final int scrollY = getScrollY();
final int currY = scroller.getCurrY();
final int deltaY = currY - scrollY;
if (overScrollBy(0, deltaY, 0, scrollY, 0, 0, 0, mOverscrollDistance, false))
{
final boolean crossDown = scrollY <= 0 && currY > 0;
final boolean crossUp = scrollY >= 0 && currY < 0;
if (crossDown || crossUp)
{
int velocity = (int) scroller.getCurrVelocity();
if (crossUp)
velocity = -velocity;
// Don't flywheel from this; we're just continuing things.
scroller.abortAnimation();
start(velocity);
}
else
{
startSpringback(0);
}
}
else
{
invalidate();
post(this);
}
}
else
{
endFling();
}
break;
}
finally
{
if(DEBUG)
{
traceEnd();
}
}
}
}
}
}
/**
* 滚到最后面
*
*
*/
class MoveToBottomScroller implements Runnable
{
private static final int SCROLL_DURATION = 400;
// 加速度or减速度, 取决于估算的距离, 即要滚动的
private float mAccerleration;
// // 减速度
// private float mDeceleration;
// 当前速度, 单位px/ms
private float mCurrVelocity;
// 最大速度(估算)
private float mMaxVeloctiy;
// 开始时间
private long mStartTime;
// 上一次的位置
private int lastMotionY = 0;
// 状态
private int mStatus;
private int mTargetPosition;
// 滚动时长
private int mDuration;
private int mDistance;
private boolean mUseViscousFluid = false;
// 加速中
private static final int STATUS_ACCERLERING = 0;
// 减速中
private static final int STATUS_DECERLERING = 1;
// 匀速
private static final int STATUS_UNIFORM = 2;
// 流体减速
private static final int STATUS_VISCOUS_FLUID = 3;
void start()
{
final int firstPos = mFirstPosition;
// 最后一个view的位置
final int lastPos = firstPos + getChildCount() - 1;
// 滚动的Count
final int scrollCount = mItemCount - lastPos - 1;
// 1. 已经在最后一个, 直接return
// 2. 在同一屏幕, 直接滚过去
if(scrollCount == 0)
{
int childrenBottom = mBottom - mTop - mListPadding.bottom;
// 要滚动的距离
mDistance = getChildAt(getChildCount() - 1).getBottom() - childrenBottom;
// 滚到底了
if(mDistance == 0)
{
stop();
return;
}
mDuration = SCROLL_DURATION;
mStartTime = AnimationUtils.currentAnimationTimeMillis();
lastMotionY = 0;
// 流体算法
mStatus = STATUS_VISCOUS_FLUID;
post(this);
}
else
{
// 要滚动的距离(估算)
final int scrollDistance = scrollCount * getHeight() / getChildCount();
mMaxVeloctiy = (float) scrollDistance / (0.75f * SCROLL_DURATION);
// 估算加速度
mAccerleration = mMaxVeloctiy / (0.25f * SCROLL_DURATION);
mCurrVelocity = 0;
mStartTime = AnimationUtils.currentAnimationTimeMillis();
mStatus = STATUS_ACCERLERING;
lastMotionY = 0;
// 目标
mTargetPosition = mItemCount - 1;
mUseViscousFluid = scrollCount == 1;
post(this);
}
}
void stop()
{
removeCallbacks(this);
// 把状态设置为false
mScrollToBottom = false;
}
@Override
public void run()
{
traceBegin("AbsListView.MoveToBottomScroller.run");
try
{
final long time = AnimationUtils.currentAnimationTimeMillis();
final int currentTime = (int) (time - mStartTime);
int motionY = 0;
switch (mStatus)
{
// 加速
case STATUS_ACCERLERING:
// 匀速
if(currentTime > SCROLL_DURATION / 4)
{
mCurrVelocity = mMaxVeloctiy;
motionY = (int) (mMaxVeloctiy * currentTime - mMaxVeloctiy * SCROLL_DURATION / 8);
// 转为匀速
mAccerleration = 0;
mStatus = STATUS_UNIFORM;
}
else
{
// v = at
mCurrVelocity = mAccerleration * currentTime;
// s = v * t / 2
motionY = (int) (mCurrVelocity * currentTime / 2);
}
break;
// 匀速运动
case STATUS_UNIFORM:
// 匀速
motionY = (int) (mMaxVeloctiy * currentTime - mMaxVeloctiy * SCROLL_DURATION / 8);
break;
// 开始减速运动
case STATUS_DECERLERING:
if(currentTime > mDuration)
{
motionY = mDistance;
int delta = motionY - lastMotionY;
trackMotionScroll(-delta, -delta);
return;
}
else
{
// v = v0 - at
mCurrVelocity = mCurrVelocity - mAccerleration * currentTime;
// s = v0^2 - 1/2at^2
motionY = (int) (mDistance - mCurrVelocity * (mDuration - currentTime) / 2);
}
break;
case STATUS_VISCOUS_FLUID:
if(currentTime > mDuration)
{
motionY = mDistance;
int delta = motionY - lastMotionY;
trackMotionScroll(-delta, -delta);
return;
}
else
{
final float t = (float) currentTime / mDuration;
motionY = (int) (AnimateUtils.viscousFluid(t) * mDistance);
}
break;
default:
break;
}
int delta = motionY - lastMotionY;
// 滚动, 因为是向上滚动, 因此delta取反
final boolean atEdge = trackMotionScroll(-delta, -delta);
// 还没滚到低
if(!atEdge)
{
final int childCount = getChildCount();
final int firstPosition = mFirstPosition;
// 目标出现了
if(mStatus != STATUS_VISCOUS_FLUID && mStatus != STATUS_DECERLERING && firstPosition + childCount - 1 >= mTargetPosition)
{
int childrenBottom = mBottom - mTop - mListPadding.bottom;
// 要滚动的距离
mDistance = getChildAt(childCount - 1).getBottom() - childrenBottom;
// 滚到底了
if(mDistance == 0)
{
stop();
return;
}
mDuration = SCROLL_DURATION - currentTime;
if(mDuration < 100)
{
mDuration = 100;
}
mStartTime = AnimationUtils.currentAnimationTimeMillis();
lastMotionY = 0;
// 大于最小速度, 则开始减速
if (mCurrVelocity * 1000 > mMinimumVelocity && !mUseViscousFluid)
{
mStatus = STATUS_DECERLERING;
mCurrVelocity = 2f * mDistance / mDuration;
mAccerleration = mCurrVelocity / mDuration;
}
// 小于的话, 使用流体滚动
else
{
mStatus = STATUS_VISCOUS_FLUID;
}
}
post(this);
}
else
{
stop();
}
}
finally
{
traceEnd();
}
}
}
class PositionScroller implements Runnable
{
private static final int SCROLL_DURATION = 400;
private static final int MOVE_DOWN_POS = 1;
private static final int MOVE_UP_POS = 2;
private static final int MOVE_DOWN_BOUND = 3;
private static final int MOVE_UP_BOUND = 4;
private static final int MOVE_OFFSET = 5;
private int mMode;
private int mTargetPos;
private int mBoundPos;
private int mLastSeenPos;
private int mScrollDuration;
private final int mExtraScroll;
private int mOffsetFromTop;
PositionScroller()
{
mExtraScroll = ViewConfiguration.get(getContext()).getScaledFadingEdgeLength();
}
void start(int position)
{
stop();
final int firstPos = mFirstPosition;
final int lastPos = firstPos + getChildCount() - 1;
int viewTravelCount;
if (position <= firstPos)
{
viewTravelCount = firstPos - position + 1;
mMode = MOVE_UP_POS;
}
else if (position >= lastPos)
{
viewTravelCount = position - lastPos + 1;
mMode = MOVE_DOWN_POS;
}
else
{
// Already on screen, nothing to do
return;
}
if (viewTravelCount > 0)
{
mScrollDuration = SCROLL_DURATION / viewTravelCount;
}
else
{
mScrollDuration = SCROLL_DURATION;
}
mTargetPos = position;
mBoundPos = INVALID_POSITION;
mLastSeenPos = INVALID_POSITION;
post(this);
}
void start(int position, int boundPosition)
{
stop();
if (boundPosition == INVALID_POSITION)
{
start(position);
return;
}
final int firstPos = mFirstPosition;
final int lastPos = firstPos + getChildCount() - 1;
int viewTravelCount;
if (position <= firstPos)
{
final int boundPosFromLast = lastPos - boundPosition;
if (boundPosFromLast < 1)
{
// Moving would shift our bound position off the screen. Abort.
return;
}
final int posTravel = firstPos - position + 1;
final int boundTravel = boundPosFromLast - 1;
if (boundTravel < posTravel)
{
viewTravelCount = boundTravel;
mMode = MOVE_UP_BOUND;
}
else
{
viewTravelCount = posTravel;
mMode = MOVE_UP_POS;
}
}
else if (position >= lastPos)
{
final int boundPosFromFirst = boundPosition - firstPos;
if (boundPosFromFirst < 1)
{
// Moving would shift our bound position off the screen. Abort.
return;
}
final int posTravel = position - lastPos + 1;
final int boundTravel = boundPosFromFirst - 1;
if (boundTravel < posTravel)
{
viewTravelCount = boundTravel;
mMode = MOVE_DOWN_BOUND;
}
else
{
viewTravelCount = posTravel;
mMode = MOVE_DOWN_POS;
}
}
else
{
// Already on screen, nothing to do
return;
}
if (viewTravelCount > 0)
{
mScrollDuration = SCROLL_DURATION / viewTravelCount;
}
else
{
mScrollDuration = SCROLL_DURATION;
}
mTargetPos = position;
mBoundPos = boundPosition;
mLastSeenPos = INVALID_POSITION;
post(this);
}
void startWithOffset(int position, int offset)
{
startWithOffset(position, offset, SCROLL_DURATION);
}
void startWithOffset(int position, int offset, int duration)
{
stop();
mTargetPos = position;
mOffsetFromTop = offset;
mBoundPos = INVALID_POSITION;
mLastSeenPos = INVALID_POSITION;
mMode = MOVE_OFFSET;
final int firstPos = mFirstPosition;
final int childCount = getChildCount();
final int lastPos = firstPos + childCount - 1;
int viewTravelCount;
if (position < firstPos)
{
viewTravelCount = firstPos - position;
}
else if (position > lastPos)
{
viewTravelCount = position - lastPos;
}
else
{
// On-screen, just scroll.
final int targetTop = getChildAt(position - firstPos).getTop();
smoothScrollBy(targetTop - offset, duration);
return;
}
// Estimate how many screens we should travel
final float screenTravelCount = (float) viewTravelCount / childCount;
// mScrollDuration = screenTravelCount < 1 ? (int) (screenTravelCount * duration)
// : (int) (duration / screenTravelCount);
// 估算滚动所需的时间
mScrollDuration = (int) (duration / screenTravelCount);
mLastSeenPos = INVALID_POSITION;
post(this);
}
void stop()
{
removeCallbacks(this);
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
}
public void run()
{
if (mTouchMode != TOUCH_MODE_FLING && mLastSeenPos != INVALID_POSITION)
{
return;
}
final int listHeight = getHeight();
final int firstPos = mFirstPosition;
switch (mMode)
{
case MOVE_DOWN_POS:
{
final int lastViewIndex = getChildCount() - 1;
final int lastPos = firstPos + lastViewIndex;
if (lastViewIndex < 0)
{
return;
}
if (lastPos == mLastSeenPos)
{
// No new views, let things keep going.
post(this);
return;
}
final View lastView = getChildAt(lastViewIndex);
final int lastViewHeight = lastView.getHeight();
final int lastViewTop = lastView.getTop();
final int lastViewPixelsShowing = listHeight - lastViewTop;
final int extraScroll = lastPos < mItemCount - 1 ? mExtraScroll : mListPadding.bottom;
smoothScrollBy(lastViewHeight - lastViewPixelsShowing + extraScroll, mScrollDuration);
mLastSeenPos = lastPos;
if (lastPos < mTargetPos)
{
post(this);
}
break;
}
case MOVE_DOWN_BOUND:
{
final int nextViewIndex = 1;
final int childCount = getChildCount();
if (firstPos == mBoundPos || childCount <= nextViewIndex || firstPos + childCount >= mItemCount)
{
return;
}
final int nextPos = firstPos + nextViewIndex;
if (nextPos == mLastSeenPos)
{
// No new views, let things keep going.
post(this);
return;
}
final View nextView = getChildAt(nextViewIndex);
final int nextViewHeight = nextView.getHeight();
final int nextViewTop = nextView.getTop();
final int extraScroll = mExtraScroll;
if (nextPos < mBoundPos)
{
smoothScrollBy(Math.max(0, nextViewHeight + nextViewTop - extraScroll), mScrollDuration);
mLastSeenPos = nextPos;
post(this);
}
else
{
if (nextViewTop > extraScroll)
{
smoothScrollBy(nextViewTop - extraScroll, mScrollDuration);
}
}
break;
}
case MOVE_UP_POS:
{
if (firstPos == mLastSeenPos)
{
// No new views, let things keep going.
post(this);
return;
}
final View firstView = getChildAt(0);
if (firstView == null)
{
return;
}
final int firstViewTop = firstView.getTop();
final int extraScroll = firstPos > 0 ? mExtraScroll : mListPadding.top;
smoothScrollBy(firstViewTop - extraScroll, mScrollDuration);
mLastSeenPos = firstPos;
if (firstPos > mTargetPos)
{
post(this);
}
break;
}
case MOVE_UP_BOUND:
{
final int lastViewIndex = getChildCount() - 2;
if (lastViewIndex < 0)
{
return;
}
final int lastPos = firstPos + lastViewIndex;
if (lastPos == mLastSeenPos)
{
// No new views, let things keep going.
post(this);
return;
}
final View lastView = getChildAt(lastViewIndex);
final int lastViewHeight = lastView.getHeight();
final int lastViewTop = lastView.getTop();
final int lastViewPixelsShowing = listHeight - lastViewTop;
mLastSeenPos = lastPos;
if (lastPos > mBoundPos)
{
smoothScrollBy(-(lastViewPixelsShowing - mExtraScroll), mScrollDuration);
post(this);
}
else
{
final int bottom = listHeight - mExtraScroll;
final int lastViewBottom = lastViewTop + lastViewHeight;
if (bottom > lastViewBottom)
{
smoothScrollBy(-(bottom - lastViewBottom), mScrollDuration);
}
}
break;
}
case MOVE_OFFSET:
{
if (mLastSeenPos == firstPos)
{
// No new views, let things keep going.
post(this);
return;
}
mLastSeenPos = firstPos;
final int childCount = getChildCount();
final int position = mTargetPos;
final int lastPos = firstPos + childCount - 1;
int viewTravelCount = 0;
if (position < firstPos)
{
viewTravelCount = firstPos - position + 1;
}
else if (position > lastPos)
{
viewTravelCount = position - lastPos;
}
// Estimate how many screens we should travel
// 估算要滚多少屏
final float screenTravelCount = (float) viewTravelCount / childCount;
// 一次最多滚一屏?
final float modifier = Math.min(Math.abs(screenTravelCount), 1.f);
// 在屏幕外的话, 开始滚
if (position < firstPos)
{
smoothScrollBy((int) (-getHeight() * modifier), mScrollDuration);
post(this);
}
else if (position > lastPos)
{
smoothScrollBy((int) (getHeight() * modifier), mScrollDuration);
post(this);
}
else
{
// On-screen, just scroll.
final int targetTop = getChildAt(position - firstPos).getTop();
final int distance = targetTop - mOffsetFromTop;
// int duration = Math.abs(i)
// 这里算法有bug......当向上滚时. 时间为负数..
final int duration = Math.abs((int) (mScrollDuration * ((float) distance / getHeight())));
smoothScrollBy(distance, duration);
}
break;
}
default:
break;
}
}
}
/**
* The amount of friction applied to flings. The default value is {@link ViewConfiguration#getScrollFriction}.
*
* @return A scalar dimensionless value representing the coefficient of friction.
*/
public void setFriction(float friction)
{
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
mFlingRunnable.mScroller.setFriction(friction);
}
/**
* Sets a scale factor for the fling velocity. The initial scale factor is 1.0.
*
* @param scale The scale factor to multiply the velocity by.
*/
public void setVelocityScale(float scale)
{
mVelocityScale = scale;
}
/**
* Smoothly scroll to the specified adapter position. The view will scroll such that the indicated position is
* displayed.
*
* @param position Scroll to this adapter position.
*/
public void smoothScrollToPosition(int position)
{
if (mPositionScroller == null)
{
mPositionScroller = new PositionScroller();
}
mPositionScroller.start(position);
}
/**
* Smoothly scroll to the specified adapter position. The view will scroll such that the indicated position is
* displayed <code>offset</code> pixels from the top edge of the view. If this is impossible, (e.g. the offset would
* scroll the first or last item beyond the boundaries of the list) it will get as close as possible. The scroll
* will take <code>duration</code> milliseconds to complete.
*
* @param position Position to scroll to
* @param offset Desired distance in pixels of <code>position</code> from the top of the view when scrolling is
* finished
* @param duration Number of milliseconds to use for the scroll
*/
public void smoothScrollToPositionFromTop(int position, int offset, int duration)
{
if (mPositionScroller == null)
{
mPositionScroller = new PositionScroller();
}
mPositionScroller.startWithOffset(position, offset, duration);
}
/**
* Smoothly scroll to the specified adapter position. The view will scroll such that the indicated position is
* displayed <code>offset</code> pixels from the top edge of the view. If this is impossible, (e.g. the offset would
* scroll the first or last item beyond the boundaries of the list) it will get as close as possible.
*
* @param position Position to scroll to
* @param offset Desired distance in pixels of <code>position</code> from the top of the view when scrolling is
* finished
*/
public void smoothScrollToPositionFromTop(int position, int offset)
{
if (mPositionScroller == null)
{
mPositionScroller = new PositionScroller();
}
mPositionScroller.startWithOffset(position, offset);
}
/**
* Smoothly scroll to the specified adapter position. The view will scroll such that the indicated position is
* displayed, but it will stop early if scrolling further would scroll boundPosition out of view.
*
* @param position Scroll to this adapter position.
* @param boundPosition Do not scroll if it would move this adapter position out of view.
*/
public void smoothScrollToPosition(int position, int boundPosition)
{
if (mPositionScroller == null)
{
mPositionScroller = new PositionScroller();
}
mPositionScroller.start(position, boundPosition);
}
/**
* Smoothly scroll by distance pixels over duration milliseconds.
*
* @param distance Distance to scroll in pixels.
* @param duration Duration of the scroll animation in milliseconds.
*/
public void smoothScrollBy(int distance, int duration)
{
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
// No sense starting to scroll if we're not going anywhere
final int firstPos = mFirstPosition;
final int childCount = getChildCount();
final int lastPos = firstPos + childCount - 1;
final int topLimit = mPaddingTop;
final int bottomLimit = getHeight() - mPaddingBottom;
if (distance == 0 || mItemCount == 0 || childCount == 0
|| (firstPos == 0 && getChildAt(0).getTop() == topLimit && distance < 0)
|| (lastPos == mItemCount - 1 && getChildAt(childCount - 1).getBottom() == bottomLimit && distance > 0))
{
mFlingRunnable.endFling();
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
}
else
{
reportScrollStateChange(OnScrollListener.SCROLL_STATE_FLING);
mFlingRunnable.startScroll(distance, duration);
}
}
/**
* Allows RemoteViews to scroll relatively to a position.
*/
void smoothScrollByOffset(int position)
{
int index = -1;
if (position < 0)
{
index = getFirstVisiblePosition();
}
else if (position > 0)
{
index = getLastVisiblePosition();
}
if (index > -1)
{
View child = getChildAt(index - getFirstVisiblePosition());
if (child != null)
{
Rect visibleRect = new Rect();
if (child.getGlobalVisibleRect(visibleRect))
{
// the child is partially visible
int childRectArea = child.getWidth() * child.getHeight();
int visibleRectArea = visibleRect.width() * visibleRect.height();
float visibleArea = (visibleRectArea / (float) childRectArea);
final float visibleThreshold = 0.75f;
if ((position < 0) && (visibleArea < visibleThreshold))
{
// the top index is not perceivably visible so offset
// to account for showing that top index as well
++index;
}
else if ((position > 0) && (visibleArea < visibleThreshold))
{
// the bottom index is not perceivably visible so offset
// to account for showing that bottom index as well
--index;
}
}
smoothScrollToPosition(Math.max(0, Math.min(getCount(), index + position)));
}
}
}
private void createScrollingCache()
{
if (mScrollingCacheEnabled && !mCachingStarted)
{
setChildrenDrawnWithCacheEnabled(true);
setChildrenDrawingCacheEnabled(true);
mCachingStarted = mCachingActive = true;
}
}
private void clearScrollingCache()
{
if (mClearScrollingCache == null)
{
mClearScrollingCache = new Runnable()
{
public void run()
{
if (mCachingStarted)
{
mCachingStarted = mCachingActive = false;
setChildrenDrawnWithCacheEnabled(false);
if ((mPersistentDrawingCache & PERSISTENT_SCROLLING_CACHE) == 0)
{
setChildrenDrawingCacheEnabled(false);
}
if (!isAlwaysDrawnWithCacheEnabled())
{
invalidate();
}
}
}
};
}
post(mClearScrollingCache);
}
/**
* Track a motion scroll
*
* @param deltaY Amount to offset mMotionView. This is the accumulated delta since the motion began. Positive
* numbers mean the user's finger is moving down the screen.
* @param incrementalDeltaY Change in deltaY from the previous event.
* @return true if we're already at the beginning/end of the list and have nothing to do.
*/
boolean trackMotionScroll(int deltaY, int incrementalDeltaY)
{
final int childCount = getChildCount();
if (childCount == 0)
{
return true;
}
traceBegin("AbsListView.trackMotionScroll");
try
{
final int firstTop = getChildAt(0).getTop();
final int lastBottom = getChildAt(childCount - 1).getBottom();
final Rect listPadding = mListPadding;
// "effective padding" In this case is the amount of padding that affects
// how much space should not be filled by items. If we don't clip to padding
// there is no effective padding.
int effectivePaddingTop = 0;
int effectivePaddingBottom = 0;
if ((mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK)
{
effectivePaddingTop = listPadding.top;
effectivePaddingBottom = listPadding.bottom;
}
// FIXME account for grid vertical spacing too?
final int spaceAbove = effectivePaddingTop - firstTop;
final int end = getHeight() - effectivePaddingBottom;
final int spaceBelow = lastBottom - end;
final int height = getHeight() - mPaddingBottom - mPaddingTop;
if (deltaY < 0)
{
deltaY = Math.max(-(height - 1), deltaY);
}
else
{
deltaY = Math.min(height - 1, deltaY);
}
if (incrementalDeltaY < 0)
{
incrementalDeltaY = Math.max(-(height - 1), incrementalDeltaY);
}
else
{
incrementalDeltaY = Math.min(height - 1, incrementalDeltaY);
}
final int firstPosition = mFirstPosition;
// Update our guesses for where the first and last views are
if (firstPosition == 0)
{
mFirstPositionDistanceGuess = firstTop - listPadding.top;
}
else
{
mFirstPositionDistanceGuess += incrementalDeltaY;
}
if (firstPosition + childCount == mItemCount)
{
mLastPositionDistanceGuess = lastBottom + listPadding.bottom;
}
else
{
mLastPositionDistanceGuess += incrementalDeltaY;
}
final boolean cannotScrollDown = (firstPosition == 0 && firstTop >= listPadding.top && incrementalDeltaY >= 0);
final boolean cannotScrollUp = (firstPosition + childCount == mItemCount
&& lastBottom <= getHeight() - listPadding.bottom && incrementalDeltaY <= 0);
if (cannotScrollDown || cannotScrollUp)
{
return incrementalDeltaY != 0;
}
final boolean down = incrementalDeltaY < 0;
final boolean inTouchMode = isInTouchMode();
if (inTouchMode)
{
hideSelector();
}
final int headerViewsCount = getHeaderViewsCount();
final int footerViewsStart = mItemCount - getFooterViewsCount();
int start = 0;
int count = 0;
// 回收旧的view
if (down)
{
int top = -incrementalDeltaY;
if ((mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK)
{
top += listPadding.top;
}
for (int i = 0; i < childCount; i++)
{
final View child = getChildAt(i);
if (child.getBottom() >= top)
{
break;
}
else
{
count++;
int position = firstPosition + i;
if (position >= headerViewsCount && position < footerViewsStart)
{
mRecycler.addScrapView(child, position);
if (ViewDebug.TRACE_RECYCLER)
{
ViewDebug.trace(child, ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, firstPosition
+ i, -1);
}
}
}
}
}
else
{
int bottom = getHeight() - incrementalDeltaY;
if ((mGroupFlags & CLIP_TO_PADDING_MASK) == CLIP_TO_PADDING_MASK)
{
bottom -= listPadding.bottom;
}
for (int i = childCount - 1; i >= 0; i--)
{
final View child = getChildAt(i);
if (child.getTop() <= bottom)
{
break;
}
else
{
start = i;
count++;
int position = firstPosition + i;
if (position >= headerViewsCount && position < footerViewsStart)
{
mRecycler.addScrapView(child, position);
if (ViewDebug.TRACE_RECYCLER)
{
ViewDebug.trace(child, ViewDebug.RecyclerTraceType.MOVE_TO_SCRAP_HEAP, firstPosition
+ i, -1);
}
}
}
}
}
mMotionViewNewTop = mMotionViewOriginalTop + deltaY;
mBlockLayoutRequests = true;
// 移除这些view的parent
if (count > 0)
{
detachViewsFromParent(start, count);
}
// 剩下的view全部往手指位置偏移
offsetChildrenTopAndBottom(incrementalDeltaY);
if (down)
{
mFirstPosition += count;
}
// 重绘
invalidate();
// 填充剩余的空间
final int absIncrementalDeltaY = Math.abs(incrementalDeltaY);
if (spaceAbove < absIncrementalDeltaY || spaceBelow < absIncrementalDeltaY)
{
fillGap(down);
}
// 设置selector
// 不在touch模式下(鼠标滚轮?), 且有select
if (!inTouchMode && mSelectedPosition != INVALID_POSITION)
{
final int childIndex = mSelectedPosition - mFirstPosition;
if (childIndex >= 0 && childIndex < getChildCount())
{
positionSelector(mSelectedPosition, getChildAt(childIndex));
}
}
// touch模式下
else if (mSelectorPosition != INVALID_POSITION)
{
final int childIndex = mSelectorPosition - mFirstPosition;
if (childIndex >= 0 && childIndex < getChildCount())
{
positionSelector(INVALID_POSITION, getChildAt(childIndex));
}
}
else
{
mSelectorRect.setEmpty();
}
mBlockLayoutRequests = false;
invokeOnItemScrollListener();
awakenScrollBars();
}
finally
{
traceEnd();
}
return false;
}
/**
* Returns the number of header views in the list. Header views are special views at the top of the list that should
* not be recycled during a layout.
*
* @return The number of header views, 0 in the default implementation.
*/
int getHeaderViewsCount()
{
return 0;
}
/**
* Returns the number of footer views in the list. Footer views are special views at the bottom of the list that
* should not be recycled during a layout.
*
* @return The number of footer views, 0 in the default implementation.
*/
int getFooterViewsCount()
{
return 0;
}
/**
* Fills the gap left open by a touch-scroll. During a touch scroll, children that remain on screen are shifted and
* the other ones are discarded. The role of this method is to fill the gap thus created by performing a partial
* layout in the empty space.
*
* @param down true if the scroll is going down, false if it is going up
*/
abstract void fillGap(boolean down);
void hideSelector()
{
if (mSelectedPosition != INVALID_POSITION)
{
if (mLayoutMode != LAYOUT_SPECIFIC)
{
mResurrectToPosition = mSelectedPosition;
}
if (mNextSelectedPosition >= 0 && mNextSelectedPosition != mSelectedPosition)
{
mResurrectToPosition = mNextSelectedPosition;
}
setSelectedPositionInt(INVALID_POSITION);
setNextSelectedPositionInt(INVALID_POSITION);
mSelectedTop = 0;
}
}
/**
* @return A position to select. First we try mSelectedPosition. If that has been clobbered by entering touch mode,
* we then try mResurrectToPosition. Values are pinned to the range of items available in the adapter
*/
int reconcileSelectedPosition()
{
int position = mSelectedPosition;
if (position < 0)
{
position = mResurrectToPosition;
}
position = Math.max(0, position);
position = Math.min(position, mItemCount - 1);
return position;
}
/**
* Find the row closest to y. This row will be used as the motion row when scrolling
*
* @param y Where the user touched
* @return The position of the first (or only) item in the row containing y
*/
abstract int findMotionRow(int y);
/**
* Find the row closest to y. This row will be used as the motion row when scrolling.
*
* @param y Where the user touched
* @return The position of the first (or only) item in the row closest to y
*/
int findClosestMotionRow(int y)
{
final int childCount = getChildCount();
if (childCount == 0)
{
return INVALID_POSITION;
}
final int motionRow = findMotionRow(y);
return motionRow != INVALID_POSITION ? motionRow : mFirstPosition + childCount - 1;
}
/**
* Causes all the views to be rebuilt and redrawn.
*/
public void invalidateViews()
{
mDataChanged = true;
rememberSyncState();
requestLayout();
invalidate();
}
/**
* If there is a selection returns false. Otherwise resurrects the selection and returns true if resurrected.
*/
boolean resurrectSelectionIfNeeded()
{
if (mSelectedPosition < 0 && resurrectSelection())
{
updateSelectorState();
return true;
}
return false;
}
/**
* Makes the item at the supplied position selected.
*
* @param position the position of the new selection
*/
abstract void setSelectionInt(int position);
/**
* Attempt to bring the selection back if the user is switching from touch to trackball mode
*
* @return Whether selection was set to something.
*/
boolean resurrectSelection()
{
final int childCount = getChildCount();
if (childCount <= 0)
{
return false;
}
int selectedTop = 0;
int selectedPos;
int childrenTop = mListPadding.top;
int childrenBottom = mBottom - mTop - mListPadding.bottom;
final int firstPosition = mFirstPosition;
final int toPosition = mResurrectToPosition;
boolean down = true;
if (toPosition >= firstPosition && toPosition < firstPosition + childCount)
{
selectedPos = toPosition;
final View selected = getChildAt(selectedPos - mFirstPosition);
selectedTop = selected.getTop();
int selectedBottom = selected.getBottom();
// We are scrolled, don't get in the fade
if (selectedTop < childrenTop)
{
selectedTop = childrenTop + getVerticalFadingEdgeLength();
}
else if (selectedBottom > childrenBottom)
{
selectedTop = childrenBottom - selected.getMeasuredHeight() - getVerticalFadingEdgeLength();
}
}
else
{
if (toPosition < firstPosition)
{
// Default to selecting whatever is first
selectedPos = firstPosition;
for (int i = 0; i < childCount; i++)
{
final View v = getChildAt(i);
final int top = v.getTop();
if (i == 0)
{
// Remember the position of the first item
selectedTop = top;
// See if we are scrolled at all
if (firstPosition > 0 || top < childrenTop)
{
// If we are scrolled, don't select anything that is
// in the fade region
childrenTop += getVerticalFadingEdgeLength();
}
}
if (top >= childrenTop)
{
// Found a view whose top is fully visisble
selectedPos = firstPosition + i;
selectedTop = top;
break;
}
}
}
else
{
final int itemCount = mItemCount;
down = false;
selectedPos = firstPosition + childCount - 1;
for (int i = childCount - 1; i >= 0; i--)
{
final View v = getChildAt(i);
final int top = v.getTop();
final int bottom = v.getBottom();
if (i == childCount - 1)
{
selectedTop = top;
if (firstPosition + childCount < itemCount || bottom > childrenBottom)
{
childrenBottom -= getVerticalFadingEdgeLength();
}
}
if (bottom <= childrenBottom)
{
selectedPos = firstPosition + i;
selectedTop = top;
break;
}
}
}
}
mResurrectToPosition = INVALID_POSITION;
removeCallbacks(mFlingRunnable);
if (mPositionScroller != null)
{
mPositionScroller.stop();
}
if(mBottomScroller != null)
{
mBottomScroller.stop();
}
mTouchMode = TOUCH_MODE_REST;
if(DEBUG)
{
//Log.d(TAG, "TOUCH_MODE_REST");
}
clearScrollingCache();
mSpecificTop = selectedTop;
selectedPos = lookForSelectablePosition(selectedPos, down);
if (selectedPos >= firstPosition && selectedPos <= getLastVisiblePosition())
{
mLayoutMode = LAYOUT_SPECIFIC;
updateSelectorState();
setSelectionInt(selectedPos);
invokeOnItemScrollListener();
}
else
{
selectedPos = INVALID_POSITION;
}
reportScrollStateChange(OnScrollListener.SCROLL_STATE_IDLE);
return selectedPos >= 0;
}
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
void confirmCheckedPositionsById()
{
// Clear out the positional check states, we'll rebuild it below from IDs.
mCheckStates.clear();
boolean checkedCountChanged = false;
for (int checkedIndex = 0; checkedIndex < mCheckedIdStates.size(); checkedIndex++)
{
final long id = mCheckedIdStates.keyAt(checkedIndex);
final int lastPos = mCheckedIdStates.valueAt(checkedIndex);
final long lastPosId = mAdapter.getItemId(lastPos);
if (id != lastPosId)
{
// Look around to see if the ID is nearby. If not, uncheck it.
final int start = Math.max(0, lastPos - CHECK_POSITION_SEARCH_DISTANCE);
final int end = Math.min(lastPos + CHECK_POSITION_SEARCH_DISTANCE, mItemCount);
boolean found = false;
for (int searchPos = start; searchPos < end; searchPos++)
{
final long searchId = mAdapter.getItemId(searchPos);
if (id == searchId)
{
found = true;
mCheckStates.put(searchPos, true);
mCheckedIdStates.setValueAt(checkedIndex, searchPos);
break;
}
}
if (!found)
{
mCheckedIdStates.delete(id);
checkedIndex--;
mCheckedItemCount--;
checkedCountChanged = true;
if (mChoiceActionMode != null && mMultiChoiceModeCallback != null)
{
mMultiChoiceModeCallback.onItemCheckedStateChanged(mChoiceActionMode, lastPos, id, false);
}
}
}
else
{
mCheckStates.put(lastPos, true);
}
}
if (checkedCountChanged && mChoiceActionMode != null)
{
mChoiceActionMode.invalidate();
}
}
@Override
protected void handleDataChanged()
{
int count = mItemCount;
int lastHandledItemCount = mLastHandledItemCount;
mLastHandledItemCount = mItemCount;
if (mChoiceMode != CHOICE_MODE_NONE && mAdapter != null && mAdapter.hasStableIds())
{
confirmCheckedPositionsById();
}
if (count > 0)
{
int newPos;
int selectablePos;
// Find the row we are supposed to sync to
if (mNeedSync)
{
// Update this first, since setNextSelectedPositionInt inspects it
mNeedSync = false;
if (mTranscriptMode == TRANSCRIPT_MODE_ALWAYS_SCROLL)
{
// mLayoutMode = LAYOUT_FORCE_BOTTOM;
mScrollToBottom = true;
}
else if (mTranscriptMode == TRANSCRIPT_MODE_NORMAL)
{
if (mForceTranscriptScroll)
{
mForceTranscriptScroll = false;
mScrollToBottom = true;
// mLayoutMode = LAYOUT_FORCE_BOTTOM;
}
else if(getChildCount() > 0)
{
final int childCount = getChildCount();
final int listBottom = getHeight() - mPaddingBottom;
final View lastChild = getChildAt(childCount - 1);
final int lastBottom = lastChild != null ? lastChild.getBottom() : listBottom;
if (mFirstPosition + childCount >= lastHandledItemCount && lastBottom <= listBottom)
{
mLayoutMode = LAYOUT_FORCE_BOTTOM;
return;
}
}
// Something new came in and we didn't scroll; give the user a clue that
// there's something new.
// awakenScrollBars();
}
switch (mSyncMode)
{
case SYNC_SELECTED_POSITION:
if (isInTouchMode())
{
// We saved our state when not in touch mode. (We know this because
// mSyncMode is SYNC_SELECTED_POSITION.) Now we are trying to
// restore in touch mode. Just leave mSyncPosition as it is (possibly
// adjusting if the available range changed) and return.
mLayoutMode = LAYOUT_SYNC;
mSyncPosition = Math.min(Math.max(0, mSyncPosition), count - 1);
return;
}
else
{
// See if we can find a position in the new data with the same
// id as the old selection. This will change mSyncPosition.
newPos = findSyncPosition();
if (newPos >= 0)
{
// Found it. Now verify that new selection is still selectable
selectablePos = lookForSelectablePosition(newPos, true);
if (selectablePos == newPos)
{
// Same row id is selected
mSyncPosition = newPos;
if (mSyncHeight == getHeight())
{
// If we are at the same height as when we saved state, try
// to restore the scroll position too.
mLayoutMode = LAYOUT_SYNC;
}
else
{
// We are not the same height as when the selection was saved, so
// don't try to restore the exact position
mLayoutMode = LAYOUT_SET_SELECTION;
}
// Restore selection
setNextSelectedPositionInt(newPos);
return;
}
}
}
break;
case SYNC_FIRST_POSITION:
// Leave mSyncPosition as it is -- just pin to available range
mLayoutMode = LAYOUT_SYNC;
mSyncPosition = Math.min(Math.max(0, mSyncPosition), count - 1);
return;
case SYNC_LAST_POSITION:
mLayoutMode = LAYOUT_SYNC;
// mSyncPosition = Math.min(Math.max(0, mSyncPosition), count - 1);
mSyncPosition = Math.max(Math.min(mSyncPosition, count - 1), 0);
// mSpecificTop = mLayoutHeight - mSpecificTop;
return;
}
}
// 没触摸屏幕
if (!isInTouchMode())
{
// We couldn't find matching data -- try to use the same position
newPos = getSelectedItemPosition();
// Pin position to the available range
if (newPos >= count)
{
newPos = count - 1;
}
if (newPos < 0)
{
newPos = 0;
}
// Make sure we select something selectable -- first look down
selectablePos = lookForSelectablePosition(newPos, true);
if (selectablePos >= 0)
{
setNextSelectedPositionInt(selectablePos);
return;
}
else
{
// Looking down didn't work -- try looking up
selectablePos = lookForSelectablePosition(newPos, false);
if (selectablePos >= 0)
{
setNextSelectedPositionInt(selectablePos);
return;
}
}
}
// 有触摸屏幕
else
{
// We already know where we want to resurrect the selection
if (mResurrectToPosition >= 0)
{
return;
}
}
}
// Nothing is selected. Give up and reset everything.
mLayoutMode = mStackFromBottom ? LAYOUT_FORCE_BOTTOM : LAYOUT_FORCE_TOP;
mSelectedPosition = INVALID_POSITION;
mSelectedRowId = INVALID_ROW_ID;
mNextSelectedPosition = INVALID_POSITION;
mNextSelectedRowId = INVALID_ROW_ID;
mNeedSync = false;
mSelectorPosition = INVALID_POSITION;
checkSelectionChanged();
}
@Override
void rememberSyncState()
{
if (getChildCount() > 0)
{
mNeedSync = true;
mSyncHeight = mLayoutHeight;
if (mSelectedPosition >= 0)
{
// Sync the selection state
View v = getChildAt(mSelectedPosition - mFirstPosition);
mSyncRowId = mNextSelectedRowId;
mSyncPosition = mNextSelectedPosition;
if (v != null)
{
mSpecificTop = v.getTop();
mSpecificBottom = mLayoutHeight - v.getBottom();
}
mSyncMode = SYNC_SELECTED_POSITION;
}
else if ((mScrollY == 0 && !mStackFromBottom) || mScrollY < 0)
// else if (!mStackFromBottom)
{
// Sync the based on the offset of the first view
View v = getChildAt(0);
ListAdapter adapter = getAdapter();
if (mFirstPosition >= 0 && mFirstPosition < adapter.getCount())
{
mSyncRowId = adapter.getItemId(mFirstPosition);
}
else
{
mSyncRowId = NO_ID;
}
mSyncPosition = mFirstPosition;
if (v != null)
{
mSpecificTop = v.getTop();
mSpecificBottom = mLayoutHeight - v.getBottom();
}
mSyncMode = SYNC_FIRST_POSITION;
}
else
{
ListAdapter adapter = getAdapter();
int childCount = getChildCount();
int lastPosition = mFirstPosition == INVALID_POSITION ? INVALID_POSITION : mFirstPosition + childCount
- 1;
View v = getChildAt(childCount - 1);
if (lastPosition >= 0 && lastPosition < adapter.getCount())
{
mSyncRowId = adapter.getItemId(lastPosition);
}
else
{
mSyncRowId = NO_ID;
}
mSyncPosition = lastPosition;
if (v != null)
{
mSpecificTop = v.getTop();
mSpecificBottom = mLayoutHeight - v.getBottom();
}
mSyncMode = SYNC_LAST_POSITION;
}
}
}
@Override
protected void onDisplayHint(int hint)
{
super.onDisplayHint(hint);
switch (hint)
{
case INVISIBLE:
if (mPopup != null && mPopup.isShowing())
{
dismissPopup();
}
break;
case VISIBLE:
if (mFiltered && mPopup != null && !mPopup.isShowing())
{
showPopup();
}
break;
}
mPopupHidden = hint == INVISIBLE;
}
/**
* Removes the filter window
*/
private void dismissPopup()
{
if (mPopup != null)
{
mPopup.dismiss();
}
}
/**
* Shows the filter window
*/
private void showPopup()
{
// Make sure we have a window before showing the popup
if (getWindowVisibility() == View.VISIBLE)
{
createTextFilter(true);
positionPopup();
// Make sure we get focus if we are showing the popup
checkFocus();
}
}
private void positionPopup()
{
int screenHeight = getResources().getDisplayMetrics().heightPixels;
final int[] xy = new int[2];
getLocationOnScreen(xy);
// TODO: The 20 below should come from the theme
// TODO: And the gravity should be defined in the theme as well
final int bottomGap = screenHeight - xy[1] - getHeight() + (int) (mDensityScale * 20);
if (!mPopup.isShowing())
{
mPopup.showAtLocation(this, Gravity.BOTTOM | Gravity.CENTER_HORIZONTAL, xy[0], bottomGap);
}
else
{
mPopup.update(xy[0], bottomGap, -1, -1);
}
}
/**
* What is the distance between the source and destination rectangles given the direction of focus navigation
* between them? The direction basically helps figure out more quickly what is self evident by the relationship
* between the rects...
*
* @param source the source rectangle
* @param dest the destination rectangle
* @param direction the direction
* @return the distance between the rectangles
*/
static int getDistance(Rect source, Rect dest, int direction)
{
int sX, sY; // source x, y
int dX, dY; // dest x, y
switch (direction)
{
case View.FOCUS_RIGHT:
sX = source.right;
sY = source.top + source.height() / 2;
dX = dest.left;
dY = dest.top + dest.height() / 2;
break;
case View.FOCUS_DOWN:
sX = source.left + source.width() / 2;
sY = source.bottom;
dX = dest.left + dest.width() / 2;
dY = dest.top;
break;
case View.FOCUS_LEFT:
sX = source.left;
sY = source.top + source.height() / 2;
dX = dest.right;
dY = dest.top + dest.height() / 2;
break;
case View.FOCUS_UP:
sX = source.left + source.width() / 2;
sY = source.top;
dX = dest.left + dest.width() / 2;
dY = dest.bottom;
break;
case View.FOCUS_FORWARD:
case View.FOCUS_BACKWARD:
sX = source.right + source.width() / 2;
sY = source.top + source.height() / 2;
dX = dest.left + dest.width() / 2;
dY = dest.top + dest.height() / 2;
break;
default:
throw new IllegalArgumentException("direction must be one of "
+ "{FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, FOCUS_RIGHT, " + "FOCUS_FORWARD, FOCUS_BACKWARD}.");
}
int deltaX = dX - sX;
int deltaY = dY - sY;
return deltaY * deltaY + deltaX * deltaX;
}
@Override
protected boolean isInFilterMode()
{
return mFiltered;
}
/**
* Sends a key to the text filter window
*
* @param keyCode The keycode for the event
* @param event The actual key event
*
* @return True if the text filter handled the event, false otherwise.
*/
boolean sendToTextFilter(int keyCode, int count, KeyEvent event)
{
if (!acceptFilter())
{
return false;
}
boolean handled = false;
boolean okToSend = true;
switch (keyCode)
{
case KeyEvent.KEYCODE_DPAD_UP:
case KeyEvent.KEYCODE_DPAD_DOWN:
case KeyEvent.KEYCODE_DPAD_LEFT:
case KeyEvent.KEYCODE_DPAD_RIGHT:
case KeyEvent.KEYCODE_DPAD_CENTER:
case KeyEvent.KEYCODE_ENTER:
okToSend = false;
break;
case KeyEvent.KEYCODE_BACK:
if (mFiltered && mPopup != null && mPopup.isShowing())
{
if (event.getAction() == KeyEvent.ACTION_DOWN && event.getRepeatCount() == 0)
{
KeyEvent.DispatcherState state = getKeyDispatcherState();
if (state != null)
{
state.startTracking(event, this);
}
handled = true;
}
else if (event.getAction() == KeyEvent.ACTION_UP && event.isTracking() && !event.isCanceled())
{
handled = true;
mTextFilter.setText("");
}
}
okToSend = false;
break;
case KeyEvent.KEYCODE_SPACE:
// Only send spaces once we are filtered
okToSend = mFiltered;
break;
}
if (okToSend)
{
createTextFilter(true);
KeyEvent forwardEvent = event;
if (forwardEvent.getRepeatCount() > 0)
{
forwardEvent = KeyEvent.changeTimeRepeat(event, event.getEventTime(), 0);
}
int action = event.getAction();
switch (action)
{
case KeyEvent.ACTION_DOWN:
handled = mTextFilter.onKeyDown(keyCode, forwardEvent);
break;
case KeyEvent.ACTION_UP:
handled = mTextFilter.onKeyUp(keyCode, forwardEvent);
break;
case KeyEvent.ACTION_MULTIPLE:
handled = mTextFilter.onKeyMultiple(keyCode, count, event);
break;
}
}
return handled;
}
/**
* Return an InputConnection for editing of the filter text.
*/
@Override
public InputConnection onCreateInputConnection(EditorInfo outAttrs)
{
if (isTextFilterEnabled())
{
// XXX we need to have the text filter created, so we can get an
// InputConnection to proxy to. Unfortunately this means we pretty
// much need to make it as soon as a list view gets focus.
createTextFilter(false);
if (mPublicInputConnection == null)
{
mDefInputConnection = new BaseInputConnection(this, false);
mPublicInputConnection = new InputConnectionWrapper(mTextFilter.onCreateInputConnection(outAttrs), true)
{
@Override
public boolean reportFullscreenMode(boolean enabled)
{
// Use our own input connection, since it is
// the "real" one the IME is talking with.
return mDefInputConnection.reportFullscreenMode(enabled);
}
@Override
public boolean performEditorAction(int editorAction)
{
// The editor is off in its own window; we need to be
// the one that does this.
if (editorAction == EditorInfo.IME_ACTION_DONE)
{
InputMethodManager imm = (InputMethodManager) getContext().getSystemService(
Context.INPUT_METHOD_SERVICE);
if (imm != null)
{
imm.hideSoftInputFromWindow(getWindowToken(), 0);
}
return true;
}
return false;
}
@Override
public boolean sendKeyEvent(KeyEvent event)
{
// Use our own input connection, since the filter
// text view may not be shown in a window so has
// no ViewAncestor to dispatch events with.
return mDefInputConnection.sendKeyEvent(event);
}
};
}
outAttrs.inputType = EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_FILTER;
outAttrs.imeOptions = EditorInfo.IME_ACTION_DONE;
return mPublicInputConnection;
}
return null;
}
/**
* For filtering we proxy an input connection to an internal text editor, and this allows the proxying to happen.
*/
@Override
public boolean checkInputConnectionProxy(View view)
{
return view == mTextFilter;
}
/**
* Creates the window for the text filter and populates it with an EditText field;
*
* @param animateEntrance true if the window should appear with an animation
*/
private void createTextFilter(boolean animateEntrance)
{
if (mPopup == null)
{
Context c = getContext();
PopupWindow p = new PopupWindow(c);
LayoutInflater layoutInflater = (LayoutInflater) c.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
mTextFilter = (EditText) layoutInflater.inflate(R.layout.typing_filter, null);
// For some reason setting this as the "real" input type changes
// the text view in some way that it doesn't work, and I don't
// want to figure out why this is.
mTextFilter.setRawInputType(EditorInfo.TYPE_CLASS_TEXT | EditorInfo.TYPE_TEXT_VARIATION_FILTER);
mTextFilter.setImeOptions(EditorInfo.IME_FLAG_NO_EXTRACT_UI);
mTextFilter.addTextChangedListener(this);
p.setFocusable(false);
p.setTouchable(false);
p.setInputMethodMode(PopupWindow.INPUT_METHOD_NOT_NEEDED);
p.setContentView(mTextFilter);
p.setWidth(LayoutParams.WRAP_CONTENT);
p.setHeight(LayoutParams.WRAP_CONTENT);
p.setBackgroundDrawable(null);
mPopup = p;
getViewTreeObserver().addOnGlobalLayoutListener(this);
mGlobalLayoutListenerAddedFilter = true;
}
if (animateEntrance)
{
mPopup.setAnimationStyle(R.style.Animation_TypingFilter);
}
else
{
mPopup.setAnimationStyle(R.style.Animation_TypingFilterRestore);
}
}
/**
* Clear the text filter.
*/
public void clearTextFilter()
{
if (mFiltered)
{
mTextFilter.setText("");
mFiltered = false;
if (mPopup != null && mPopup.isShowing())
{
dismissPopup();
}
}
}
/**
* Returns if the ListView currently has a text filter.
*/
public boolean hasTextFilter()
{
return mFiltered;
}
public void onGlobalLayout()
{
if (isShown())
{
// Show the popup if we are filtered
if (mFiltered && mPopup != null && !mPopup.isShowing() && !mPopupHidden)
{
showPopup();
}
}
else
{
// Hide the popup when we are no longer visible
if (mPopup != null && mPopup.isShowing())
{
dismissPopup();
}
}
}
/**
* For our text watcher that is associated with the text filter. Does nothing.
*/
public void beforeTextChanged(CharSequence s, int start, int count, int after)
{
}
/**
* For our text watcher that is associated with the text filter. Performs the actual filtering as the text changes,
* and takes care of hiding and showing the popup displaying the currently entered filter text.
*/
public void onTextChanged(CharSequence s, int start, int before, int count)
{
if (mPopup != null && isTextFilterEnabled())
{
int length = s.length();
boolean showing = mPopup.isShowing();
if (!showing && length > 0)
{
// Show the filter popup if necessary
showPopup();
mFiltered = true;
}
else if (showing && length == 0)
{
// Remove the filter popup if the user has cleared all text
dismissPopup();
mFiltered = false;
}
if (mAdapter instanceof Filterable)
{
Filter f = ((Filterable) mAdapter).getFilter();
// Filter should not be null when we reach this part
if (f != null)
{
f.filter(s, this);
}
else
{
throw new IllegalStateException("You cannot call onTextChanged with a non " + "filterable adapter");
}
}
}
}
/**
* For our text watcher that is associated with the text filter. Does nothing.
*/
public void afterTextChanged(Editable s)
{
}
public void onFilterComplete(int count)
{
if (mSelectedPosition < 0 && count > 0)
{
mResurrectToPosition = INVALID_POSITION;
resurrectSelection();
}
}
@Override
protected ViewGroup.LayoutParams generateLayoutParams(ViewGroup.LayoutParams p)
{
return new LayoutParams(p);
}
@Override
public LayoutParams generateLayoutParams(AttributeSet attrs)
{
return new AbsListView.LayoutParams(getContext(), attrs);
}
@Override
protected boolean checkLayoutParams(ViewGroup.LayoutParams p)
{
return p instanceof AbsListView.LayoutParams;
}
/**
* Puts the list or grid into transcript mode. In this mode the list or grid will always scroll to the bottom to
* show new items.
*
* @param mode the transcript mode to set
*
* @see #TRANSCRIPT_MODE_DISABLED
* @see #TRANSCRIPT_MODE_NORMAL
* @see #TRANSCRIPT_MODE_ALWAYS_SCROLL
*/
public void setTranscriptMode(int mode)
{
mTranscriptMode = mode;
}
/**
* Returns the current transcript mode.
*
* @return {@link #TRANSCRIPT_MODE_DISABLED}, {@link #TRANSCRIPT_MODE_NORMAL} or
* {@link #TRANSCRIPT_MODE_ALWAYS_SCROLL}
*/
public int getTranscriptMode()
{
return mTranscriptMode;
}
@Override
public int getSolidColor()
{
return mCacheColorHint;
}
/**
* When set to a non-zero value, the cache color hint indicates that this list is always drawn on top of a solid,
* single-color, opaque background.
*
* Zero means that what's behind this object is translucent (non solid) or is not made of a single color. This hint
* will not affect any existing background drawable set on this view ( typically set via
* {@link #setBackgroundDrawable(Drawable)}).
*
* @param color The background color
*/
public void setCacheColorHint(int color)
{
if (color != mCacheColorHint)
{
mCacheColorHint = color;
int count = getChildCount();
for (int i = 0; i < count; i++)
{
getChildAt(i).setDrawingCacheBackgroundColor(color);
}
mRecycler.setCacheColorHint(color);
}
}
/**
* When set to a non-zero value, the cache color hint indicates that this list is always drawn on top of a solid,
* single-color, opaque background
*
* @return The cache color hint
*/
@ViewDebug.ExportedProperty(category = "drawing")
public int getCacheColorHint()
{
return mCacheColorHint;
}
/**
* Move all views (excluding headers and footers) held by this AbsListView into the supplied List. This includes
* views displayed on the screen as well as views stored in AbsListView's internal view recycler.
*
* @param views A list into which to put the reclaimed views
*/
public void reclaimViews(List<View> views)
{
int childCount = getChildCount();
RecyclerListener listener = mRecycler.mRecyclerListener;
// Reclaim views on screen
for (int i = 0; i < childCount; i++)
{
View child = getChildAt(i);
AbsListView.LayoutParams lp = (AbsListView.LayoutParams) child.getLayoutParams();
// Don't reclaim header or footer views, or views that should be ignored
if (lp != null && mRecycler.shouldRecycleViewType(lp.viewType))
{
views.add(child);
if (listener != null)
{
// Pretend they went through the scrap heap
listener.onMovedToScrapHeap(child);
}
}
}
mRecycler.reclaimScrapViews(views);
removeAllViewsInLayout();
}
/**
* @hide
*/
@Override
protected boolean onConsistencyCheck(int consistency)
{
boolean result = super.onConsistencyCheck(consistency);
final boolean checkLayout = (consistency & 0x1/* ViewDebug.CONSISTENCY_LAYOUT */) != 0;
if (checkLayout)
{
// The active recycler must be empty
final View[] activeViews = mRecycler.mActiveViews;
int count = activeViews.length;
for (int i = 0; i < count; i++)
{
if (activeViews[i] != null)
{
result = false;
// //Log.d(ViewDebug.CONSISTENCY_LOG_TAG,
// "AbsListView " + this + " has a view in its active recycler: " +
// activeViews[i]);
}
}
// All views in the recycler must NOT be on screen and must NOT have a parent
final ArrayList<View> scrap = mRecycler.mCurrentScrap;
if (!checkScrap(scrap))
result = false;
final ArrayList<View>[] scraps = mRecycler.mScrapViews;
count = scraps.length;
for (int i = 0; i < count; i++)
{
if (!checkScrap(scraps[i]))
result = false;
}
}
return result;
}
private boolean checkScrap(ArrayList<View> scrap)
{
if (scrap == null)
return true;
boolean result = true;
final int count = scrap.size();
for (int i = 0; i < count; i++)
{
final View view = scrap.get(i);
if (view.getParent() != null)
{
result = false;
// //Log.d(ViewDebug.CONSISTENCY_LOG_TAG, "AbsListView " + this +
// " has a view in its scrap heap still attached to a parent: " + view);
}
if (indexOfChild(view) >= 0)
{
result = false;
// //Log.d(ViewDebug.CONSISTENCY_LOG_TAG, "AbsListView " + this +
// " has a view in its scrap heap that is also a direct child: " + view);
}
}
return result;
}
private void finishGlows()
{
// if (mEdgeGlowTop != null)
// {
// mEdgeGlowTop.finish();
// mEdgeGlowBottom.finish();
// }
}
// /**
// * Sets up this AbsListView to use a remote views adapter which connects to a RemoteViewsService
// * through the specified intent.
// * @param intent the intent used to identify the RemoteViewsService for the adapter to connect to.
// */
// public void setRemoteViewsAdapter(Intent intent) {
// // Ensure that we don't already have a RemoteViewsAdapter that is bound to an existing
// // service handling the specified intent.
// if (mRemoteAdapter != null) {
// Intent.FilterComparison fcNew = new Intent.FilterComparison(intent);
// Intent.FilterComparison fcOld = new Intent.FilterComparison(
// mRemoteAdapter.getRemoteViewsServiceIntent());
// if (fcNew.equals(fcOld)) {
// return;
// }
// }
// mDeferNotifyDataSetChanged = false;
// // Otherwise, create a new RemoteViewsAdapter for binding
// mRemoteAdapter = new RemoteViewsAdapter(getContext(), intent, this);
// }
/**
* This defers a notifyDataSetChanged on the pending RemoteViewsAdapter if it has not connected yet.
*/
public void deferNotifyDataSetChanged()
{
mDeferNotifyDataSetChanged = true;
}
// /**
// * Called back when the adapter connects to the RemoteViewsService.
// */
// public boolean onRemoteAdapterConnected() {
// if (mRemoteAdapter != mAdapter) {
// setAdapter(mRemoteAdapter);
// if (mDeferNotifyDataSetChanged) {
// mRemoteAdapter.notifyDataSetChanged();
// mDeferNotifyDataSetChanged = false;
// }
// return false;
// } else if (mRemoteAdapter != null) {
// mRemoteAdapter.superNotifyDataSetChanged();
// return true;
// }
// return false;
// }
/**
* Called back when the adapter disconnects from the RemoteViewsService.
*/
public void onRemoteAdapterDisconnected()
{
// If the remote adapter disconnects, we keep it around
// since the currently displayed items are still cached.
// Further, we want the service to eventually reconnect
// when necessary, as triggered by this view requesting
// items from the Adapter.
}
/**
* Sets the recycler listener to be notified whenever a View is set aside in the recycler for later reuse. This
* listener can be used to free resources associated to the View.
*
* @param listener The recycler listener to be notified of views set aside in the recycler.
*
* @see android.widget.AbsListView.RecycleBin
* @see android.widget.AbsListView.RecyclerListener
*/
public void setRecyclerListener(RecyclerListener listener)
{
mRecycler.mRecyclerListener = listener;
}
class AdapterDataSetObserver extends AdapterView<ListAdapter>.AdapterDataSetObserver
{
@Override
public void onChanged()
{
super.onChanged();
if (mFastScroller != null)
{
mFastScroller.onSectionsChanged();
}
}
@Override
public void onInvalidated()
{
super.onInvalidated();
if (mFastScroller != null)
{
mFastScroller.onSectionsChanged();
}
}
}
/**
* A MultiChoiceModeListener receives events for {@link AbsListView#CHOICE_MODE_MULTIPLE_MODAL}. It acts as the
* {@link ActionMode.Callback} for the selection mode and also receives
* {@link #onItemCheckedStateChanged(ActionMode, int, long, boolean)} events when the user selects and deselects
* list items.
*/
public interface MultiChoiceModeListener extends ActionMode.Callback
{
/**
* Called when an item is checked or unchecked during selection mode.
*
* @param mode The {@link ActionMode} providing the selection mode
* @param position Adapter position of the item that was checked or unchecked
* @param id Adapter ID of the item that was checked or unchecked
* @param checked <code>true</code> if the item is now checked, <code>false</code> if the item is now unchecked.
*/
public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked);
}
@SuppressLint("NewApi")
class MultiChoiceModeWrapper implements MultiChoiceModeListener
{
private MultiChoiceModeListener mWrapped;
public void setWrapped(MultiChoiceModeListener wrapped)
{
mWrapped = wrapped;
}
public boolean onCreateActionMode(ActionMode mode, Menu menu)
{
if (mWrapped.onCreateActionMode(mode, menu))
{
// Initialize checked graphic state?
setLongClickable(false);
return true;
}
return false;
}
public boolean onPrepareActionMode(ActionMode mode, Menu menu)
{
return mWrapped.onPrepareActionMode(mode, menu);
}
public boolean onActionItemClicked(ActionMode mode, MenuItem item)
{
return mWrapped.onActionItemClicked(mode, item);
}
public void onDestroyActionMode(ActionMode mode)
{
mWrapped.onDestroyActionMode(mode);
mChoiceActionMode = null;
// Ending selection mode means deselecting everything.
clearChoices();
mDataChanged = true;
rememberSyncState();
requestLayout();
setLongClickable(true);
}
public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked)
{
mWrapped.onItemCheckedStateChanged(mode, position, id, checked);
// If there are no items selected we no longer need the selection mode.
if (getCheckedItemCount() == 0)
{
mode.finish();
}
}
}
/**
* AbsListView extends LayoutParams to provide a place to hold the view type.
*/
public static class LayoutParams extends ViewGroup.LayoutParams
{
/**
* View type for this view, as returned by {@link android.widget.Adapter#getItemViewType(int) }
*/
@ViewDebug.ExportedProperty(category = "list", mapping = {
@ViewDebug.IntToString(from = ITEM_VIEW_TYPE_IGNORE, to = "ITEM_VIEW_TYPE_IGNORE"),
@ViewDebug.IntToString(from = ITEM_VIEW_TYPE_HEADER_OR_FOOTER, to = "ITEM_VIEW_TYPE_HEADER_OR_FOOTER") })
int viewType;
/**
* When this boolean is set, the view has been added to the AbsListView at least once. It is used to know
* whether headers/footers have already been added to the list view and whether they should be treated as
* recycled views or not.
*/
@ViewDebug.ExportedProperty(category = "list")
boolean recycledHeaderFooter;
/**
* When an AbsListView is measured with an AT_MOST measure spec, it needs to obtain children views to measure
* itself. When doing so, the children are not attached to the window, but put in the recycler which assumes
* they've been attached before. Setting this flag will force the reused view to be attached to the window
* rather than just attached to the parent.
*/
@ViewDebug.ExportedProperty(category = "list")
boolean forceAdd;
/**
* The position the view was removed from when pulled out of the scrap heap.
*
* @hide
*/
int scrappedFromPosition;
public LayoutParams(Context c, AttributeSet attrs)
{
super(c, attrs);
}
public LayoutParams(int w, int h)
{
super(w, h);
}
public LayoutParams(int w, int h, int viewType)
{
super(w, h);
this.viewType = viewType;
}
public LayoutParams(ViewGroup.LayoutParams source)
{
super(source);
}
}
/**
* A RecyclerListener is used to receive a notification whenever a View is placed inside the RecycleBin's scrap
* heap. This listener is used to free resources associated to Views placed in the RecycleBin.
*
* @see android.widget.AbsListView.RecycleBin
* @see android.widget.AbsListView#setRecyclerListener(android.widget.AbsListView.RecyclerListener)
*/
public static interface RecyclerListener
{
/**
* Indicates that the specified View was moved into the recycler's scrap heap. The view is not displayed on
* screen any more and any expensive resource associated with the view should be discarded.
*
* @param view
*/
void onMovedToScrapHeap(View view);
}
/**
* The RecycleBin facilitates reuse of views across layouts. The RecycleBin has two levels of storage: ActiveViews
* and ScrapViews. ActiveViews are those views which were onscreen at the start of a layout. By construction, they
* are displaying current information. At the end of layout, all views in ActiveViews are demoted to ScrapViews.
* ScrapViews are old views that could potentially be used by the adapter to avoid allocating views unnecessarily.
*
* @see android.widget.AbsListView#setRecyclerListener(android.widget.AbsListView.RecyclerListener)
* @see android.widget.AbsListView.RecyclerListener
*/
class RecycleBin
{
private RecyclerListener mRecyclerListener;
/**
* The position of the first view stored in mActiveViews.
*/
private int mFirstActivePosition;
/**
* Views that were on screen at the start of layout. This array is populated at the start of layout, and at the
* end of layout all view in mActiveViews are moved to mScrapViews. Views in mActiveViews represent a contiguous
* range of Views, with position of the first view store in mFirstActivePosition.
*/
private View[] mActiveViews = new View[0];
/**
* Unsorted views that can be used by the adapter as a convert view.
*/
private ArrayList<View>[] mScrapViews;
private int mViewTypeCount;
private ArrayList<View> mCurrentScrap;
public void setViewTypeCount(int viewTypeCount)
{
if (viewTypeCount < 1)
{
throw new IllegalArgumentException("Can't have a viewTypeCount < 1");
}
// noinspection unchecked
ArrayList<View>[] scrapViews = new ArrayList[viewTypeCount];
for (int i = 0; i < viewTypeCount; i++)
{
scrapViews[i] = new ArrayList<View>();
}
mViewTypeCount = viewTypeCount;
mCurrentScrap = scrapViews[0];
mScrapViews = scrapViews;
}
public void markChildrenDirty()
{
if (mViewTypeCount == 1)
{
final ArrayList<View> scrap = mCurrentScrap;
final int scrapCount = scrap.size();
for (int i = 0; i < scrapCount; i++)
{
scrap.get(i).forceLayout();
}
}
else
{
final int typeCount = mViewTypeCount;
for (int i = 0; i < typeCount; i++)
{
final ArrayList<View> scrap = mScrapViews[i];
final int scrapCount = scrap.size();
for (int j = 0; j < scrapCount; j++)
{
scrap.get(j).forceLayout();
}
}
}
}
public boolean shouldRecycleViewType(int viewType)
{
return viewType >= 0;
}
/**
* Clears the scrap heap.
*/
void clear()
{
if (mViewTypeCount == 1)
{
final ArrayList<View> scrap = mCurrentScrap;
final int scrapCount = scrap.size();
for (int i = 0; i < scrapCount; i++)
{
removeDetachedView(scrap.remove(scrapCount - 1 - i), false);
}
}
else
{
final int typeCount = mViewTypeCount;
for (int i = 0; i < typeCount; i++)
{
final ArrayList<View> scrap = mScrapViews[i];
final int scrapCount = scrap.size();
for (int j = 0; j < scrapCount; j++)
{
removeDetachedView(scrap.remove(scrapCount - 1 - j), false);
}
}
}
}
/**
* Fill ActiveViews with all of the children of the AbsListView.
*
* @param childCount The minimum number of views mActiveViews should hold
* @param firstActivePosition The position of the first view that will be stored in mActiveViews
*/
void fillActiveViews(int childCount, int firstActivePosition)
{
if (mActiveViews.length < childCount)
{
mActiveViews = new View[childCount];
}
mFirstActivePosition = firstActivePosition;
final View[] activeViews = mActiveViews;
for (int i = 0; i < childCount; i++)
{
View child = getChildAt(i);
AbsListView.LayoutParams lp = (AbsListView.LayoutParams) child.getLayoutParams();
// Don't put header or footer views into the scrap heap
if (lp != null && lp.viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER)
{
// Note: We do place AdapterView.ITEM_VIEW_TYPE_IGNORE in active views.
// However, we will NOT place them into scrap views.
activeViews[i] = child;
}
}
}
/**
* Get the view corresponding to the specified position. The view will be removed from mActiveViews if it is
* found.
*
* @param position The position to look up in mActiveViews
* @return The view if it is found, null otherwise
*/
View getActiveView(int position)
{
int index = position - mFirstActivePosition;
final View[] activeViews = mActiveViews;
if (index >= 0 && index < activeViews.length)
{
final View match = activeViews[index];
activeViews[index] = null;
return match;
}
return null;
}
/**
* @return A view from the ScrapViews collection. These are unordered.
*/
View getScrapView(int position)
{
if (mViewTypeCount == 1)
{
return retrieveFromScrap(mCurrentScrap, position);
}
else
{
int whichScrap = mAdapter.getItemViewType(position);
if (whichScrap >= 0 && whichScrap < mScrapViews.length)
{
return retrieveFromScrap(mScrapViews[whichScrap], position);
}
}
return null;
}
/**
* Put a view into the ScapViews list. These views are unordered.
*
* @param scrap The view to add
*/
void addScrapView(View scrap, int position)
{
AbsListView.LayoutParams lp = (AbsListView.LayoutParams) scrap.getLayoutParams();
if (lp == null)
{
return;
}
// Don't put header or footer views or views that should be ignored
// into the scrap heap
int viewType = lp.viewType;
if (!shouldRecycleViewType(viewType))
{
if (viewType != ITEM_VIEW_TYPE_HEADER_OR_FOOTER)
{
removeDetachedView(scrap, false);
}
return;
}
lp.scrappedFromPosition = position;
if (mViewTypeCount == 1)
{
dispatchStartTemporaryDetachForView(scrap);
// scrap.dispatchStartTemporaryDetach();
mCurrentScrap.add(scrap);
}
else
{
// scrap.dispatchStartTemporaryDetach();
dispatchStartTemporaryDetachForView(scrap);
mScrapViews[viewType].add(scrap);
}
if (mRecyclerListener != null)
{
mRecyclerListener.onMovedToScrapHeap(scrap);
}
}
/**
* Move all views remaining in mActiveViews to mScrapViews.
*/
void scrapActiveViews()
{
final View[] activeViews = mActiveViews;
final boolean hasListener = mRecyclerListener != null;
final boolean multipleScraps = mViewTypeCount > 1;
ArrayList<View> scrapViews = mCurrentScrap;
final int count = activeViews.length;
for (int i = count - 1; i >= 0; i--)
{
final View victim = activeViews[i];
if (victim != null)
{
final AbsListView.LayoutParams lp = (AbsListView.LayoutParams) victim.getLayoutParams();
int whichScrap = lp.viewType;
activeViews[i] = null;
if (!shouldRecycleViewType(whichScrap))
{
// Do not move views that should be ignored
if (whichScrap != ITEM_VIEW_TYPE_HEADER_OR_FOOTER)
{
removeDetachedView(victim, false);
}
continue;
}
if (multipleScraps)
{
scrapViews = mScrapViews[whichScrap];
}
// victim.dispatchStartTemporaryDetach();
dispatchStartTemporaryDetachForView(victim);
lp.scrappedFromPosition = mFirstActivePosition + i;
scrapViews.add(victim);
if (hasListener)
{
mRecyclerListener.onMovedToScrapHeap(victim);
}
if (ViewDebug.TRACE_RECYCLER)
{
ViewDebug.trace(victim, ViewDebug.RecyclerTraceType.MOVE_FROM_ACTIVE_TO_SCRAP_HEAP,
mFirstActivePosition + i, -1);
}
}
}
pruneScrapViews();
}
/**
* Makes sure that the size of mScrapViews does not exceed the size of mActiveViews. (This can happen if an
* adapter does not recycle its views).
*/
private void pruneScrapViews()
{
final int maxViews = mActiveViews.length;
final int viewTypeCount = mViewTypeCount;
final ArrayList<View>[] scrapViews = mScrapViews;
for (int i = 0; i < viewTypeCount; ++i)
{
final ArrayList<View> scrapPile = scrapViews[i];
int size = scrapPile.size();
final int extras = size - maxViews;
size--;
for (int j = 0; j < extras; j++)
{
removeDetachedView(scrapPile.remove(size--), false);
}
}
}
/**
* Puts all views in the scrap heap into the supplied list.
*/
void reclaimScrapViews(List<View> views)
{
if (mViewTypeCount == 1)
{
views.addAll(mCurrentScrap);
}
else
{
final int viewTypeCount = mViewTypeCount;
final ArrayList<View>[] scrapViews = mScrapViews;
for (int i = 0; i < viewTypeCount; ++i)
{
final ArrayList<View> scrapPile = scrapViews[i];
views.addAll(scrapPile);
}
}
}
/**
* Updates the cache color hint of all known views.
*
* @param color The new cache color hint.
*/
void setCacheColorHint(int color)
{
if (mViewTypeCount == 1)
{
final ArrayList<View> scrap = mCurrentScrap;
final int scrapCount = scrap.size();
for (int i = 0; i < scrapCount; i++)
{
scrap.get(i).setDrawingCacheBackgroundColor(color);
}
}
else
{
final int typeCount = mViewTypeCount;
for (int i = 0; i < typeCount; i++)
{
final ArrayList<View> scrap = mScrapViews[i];
final int scrapCount = scrap.size();
for (int j = 0; j < scrapCount; j++)
{
scrap.get(j).setDrawingCacheBackgroundColor(color);
}
}
}
// Just in case this is called during a layout pass
final View[] activeViews = mActiveViews;
final int count = activeViews.length;
for (int i = 0; i < count; ++i)
{
final View victim = activeViews[i];
if (victim != null)
{
victim.setDrawingCacheBackgroundColor(color);
}
}
}
}
static View retrieveFromScrap(ArrayList<View> scrapViews, int position)
{
int size = scrapViews.size();
if (size > 0)
{
// See if we still have a view for this position.
for (int i = 0; i < size; i++)
{
View view = scrapViews.get(i);
if (((AbsListView.LayoutParams) view.getLayoutParams()).scrappedFromPosition == position)
{
scrapViews.remove(i);
return view;
}
}
return scrapViews.remove(size - 1);
}
else
{
return null;
}
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
private Object enterCriticalSpan(String name)
{
if(DEBUG)
{
try
{
if (VersionUtils.isGingerBread())
{
Method m = StrictMode.class.getMethod("enterCriticalSpan", String.class);
return m.invoke(null, name);
}
}
catch (Exception e)
{
// Log.e(TAG, e.getMessage(), e);
}
}
return null;
}
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
private Object finishSpan(Object span)
{
if(DEBUG)
{
try
{
Method m = span.getClass().getMethod("finish");
m.invoke(span, new Object[0]);
}
catch (Exception e)
{
Log.i(TAG, e.getMessage());
}
}
return null;
}
/**
* Performs button-related actions during a touch down event.
*
* @param event The event.
* @return True if the down was consumed.
*
* @hide
*/
@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)
protected boolean performButtonActionOnTouchDown(MotionEvent event)
{
if (VersionUtils.isIceScreamSandwich() && ((event.getButtonState() & MotionEvent.BUTTON_SECONDARY) != 0))
{
if (showContextMenu(event.getX(), event.getY(), event.getMetaState()))
{
return true;
}
}
return false;
}
private Method startMethod = null;
private boolean isInit = false;
private void dispatchStartTemporaryDetachForView(View v)
{
try
{
if(!isInit){
initMethod();
}
if(startMethod != null){
startMethod.invoke(v);
}else{
v.onStartTemporaryDetach();
}
}
catch (Exception e)
{
v.onStartTemporaryDetach();
}
}
private Method finishMethod = null;
private void dispatchFinishTemporaryDetachForView(View v)
{
try {
if (!isInit) {
initMethod();
}
if (finishMethod != null) {
finishMethod.invoke(v);
}else{
v.onFinishTemporaryDetach();
}
}
catch (Exception e)
{
v.onFinishTemporaryDetach();
}
}
private void initMethod() throws NoSuchMethodException{
if(!isInit){
isInit = true;
finishMethod = ReflectedMethods.getDeclaredMethod(View.class,"dispatchFinishTemporaryDetach");
startMethod = ReflectedMethods.getDeclaredMethod(View.class,"dispatchStartTemporaryDetach");
}
}
/**
* Scroll the view with standard behavior for scrolling beyond the normal content boundaries. Views that call this
* method should override {@link #onOverScrolled(int, int, boolean, boolean)} to respond to the results of an
* over-scroll operation.
*
* Views can use this method to handle any touch or fling-based scrolling.
*
* @param deltaX Change in X in pixels
* @param deltaY Change in Y in pixels
* @param scrollX Current X scroll value in pixels before applying deltaX
* @param scrollY Current Y scroll value in pixels before applying deltaY
* @param scrollRangeX Maximum content scroll range along the X axis
* @param scrollRangeY Maximum content scroll range along the Y axis
* @param maxOverScrollX Number of pixels to overscroll by in either direction along the X axis.
* @param maxOverScrollY Number of pixels to overscroll by in either direction along the Y axis.
* @param isTouchEvent true if this scroll operation is the result of a touch event.
* @return true if scrolling was clamped to an over-scroll boundary along either axis, false otherwise.
*/
@TargetApi(Build.VERSION_CODES.GINGERBREAD)
protected boolean overScrollBy(int deltaX, int deltaY, int scrollX, int scrollY, int scrollRangeX,
int scrollRangeY, int maxOverScrollX, int maxOverScrollY, boolean isTouchEvent)
{
final int overScrollMode = mOverScrollMode;
final boolean canScrollHorizontal = computeHorizontalScrollRange() > computeHorizontalScrollExtent();
final boolean canScrollVertical = computeVerticalScrollRange() > computeVerticalScrollExtent();
final boolean overScrollHorizontal = overScrollMode == OVER_SCROLL_ALWAYS
|| (overScrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && canScrollHorizontal);
final boolean overScrollVertical = overScrollMode == OVER_SCROLL_ALWAYS
|| (overScrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && canScrollVertical);
int newScrollX = scrollX + deltaX;
if (!overScrollHorizontal)
{
maxOverScrollX = 0;
}
int newScrollY = scrollY + deltaY;
if (!overScrollVertical)
{
maxOverScrollY = 0;
}
// Clamp values if at the limits and record
final int left = -maxOverScrollX;
final int right = maxOverScrollX + scrollRangeX;
final int top = -maxOverScrollY;
final int bottom = maxOverScrollY + scrollRangeY;
boolean clampedX = false;
if (newScrollX > right)
{
newScrollX = right;
clampedX = true;
}
else if (newScrollX < left)
{
newScrollX = left;
clampedX = true;
}
boolean clampedY = false;
if (newScrollY > bottom)
{
newScrollY = bottom;
clampedY = true;
}
else if (newScrollY < top)
{
newScrollY = top;
clampedY = true;
}
// if (VersionUtils.isGingerBread())
{
onOverScrolled(newScrollX, newScrollY, clampedX, clampedY);
}
return clampedX || clampedY;
}
/**
* Returns the over-scroll mode for this view. The result will be one of {@link #OVER_SCROLL_ALWAYS} (default),
* {@link #OVER_SCROLL_IF_CONTENT_SCROLLS} (allow over-scrolling only if the view content is larger than the
* container), or {@link #OVER_SCROLL_NEVER}.
*
* @return This view's over-scroll mode.
*/
public int getOverScrollMode()
{
return mOverScrollMode;
}
protected void doSpringBack()
{
if (mFlingRunnable == null)
{
mFlingRunnable = new FlingRunnable();
}
mFlingRunnable.startSpringback(0);
}
protected void abordFling()
{
if (mFlingRunnable != null)
{
mFlingRunnable.endFling();
}
}
}