AdapterView.java revision d6479ec5eec13914f656f6be996d95fe1610fd57
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.widget; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.DataSetObserver; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.SystemClock; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AttributeSet; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.SparseArray; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.ContextMenu; 268c6c79f0909ceabeb8abe1013648c31c7582b7adSvetoslav Ganovimport android.view.ContextMenu.ContextMenuInfo; 2775986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganovimport android.view.SoundEffectConstants; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.ViewDebug; 3075986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganovimport android.view.ViewGroup; 3175986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganovimport android.view.accessibility.AccessibilityEvent; 324213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganovimport android.view.accessibility.AccessibilityManager; 33d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganovimport android.view.accessibility.AccessibilityNodeInfo; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An AdapterView is a view whose children are determined by an {@link Adapter}. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link ListView}, {@link GridView}, {@link Spinner} and 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Gallery} for commonly used subclasses of AdapterView. 4161fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * 4261fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <div class="special reference"> 4361fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <h3>Developer Guides</h3> 4461fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <p>For more information about using AdapterView, read the 4561fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <a href="{@docRoot}guide/topics/ui/binding.html">Binding to Data with AdapterView</a> 4661fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * developer guide.</p></div> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class AdapterView<T extends Adapter> extends ViewGroup { 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The item view type returned by {@link Adapter#getItemViewType(int)} when 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the adapter does not want the item's view recycled. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ITEM_VIEW_TYPE_IGNORE = -1; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The item view type returned by {@link Adapter#getItemViewType(int)} when 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the item is a header or footer. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ITEM_VIEW_TYPE_HEADER_OR_FOOTER = -2; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The position of the first child displayed 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 65bea95162ca25bd00b0479d93739b6283795c3986Konstantin Lopyrev @ViewDebug.ExportedProperty(category = "scrolling") 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mFirstPosition = 0; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The offset in pixels from the top of the AdapterView to the top 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the view to select during the next layout. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mSpecificTop; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Position from which to start looking for mSyncRowId 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mSyncPosition; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Row id to look for when data has changed 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long mSyncRowId = INVALID_ROW_ID; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Height of the view when mSyncPosition and mSyncRowId where set 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long mSyncHeight; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * True if we need to sync to mSyncRowId 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mNeedSync = false; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates whether to sync based on the selection or position. Possible 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values are {@link #SYNC_SELECTED_POSITION} or 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #SYNC_FIRST_POSITION}. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mSyncMode; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Our height after the last layout 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mLayoutHeight; 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sync based on the selected child 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int SYNC_SELECTED_POSITION = 0; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sync based on the first child displayed 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int SYNC_FIRST_POSITION = 1; 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Maximum amount of time to spend in {@link #findSyncPosition()} 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int SYNC_MAX_DURATION_MILLIS = 100; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates that this view is currently being laid out. 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mInLayout = false; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The listener that receives notifications when an item is selected. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnItemSelectedListener mOnItemSelectedListener; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The listener that receives notifications when an item is clicked. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnItemClickListener mOnItemClickListener; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The listener that receives notifications when an item is long clicked. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnItemLongClickListener mOnItemLongClickListener; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * True if the data has changed since the last layout 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mDataChanged; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The position within the adapter's data set of the item to select 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * during the next layout. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 150bea95162ca25bd00b0479d93739b6283795c3986Konstantin Lopyrev @ViewDebug.ExportedProperty(category = "list") 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mNextSelectedPosition = INVALID_POSITION; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The item id of the item to select during the next layout. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long mNextSelectedRowId = INVALID_ROW_ID; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The position within the adapter's data set of the currently selected item. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 161bea95162ca25bd00b0479d93739b6283795c3986Konstantin Lopyrev @ViewDebug.ExportedProperty(category = "list") 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mSelectedPosition = INVALID_POSITION; 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The item id of the currently selected item. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long mSelectedRowId = INVALID_ROW_ID; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * View to show if there are no items to show. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 172b6af533114cfa5a4547990e79e96bd0402c47e72Mihai Preda private View mEmptyView; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The number of items in the current adapter. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 177bea95162ca25bd00b0479d93739b6283795c3986Konstantin Lopyrev @ViewDebug.ExportedProperty(category = "list") 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mItemCount; 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1815e25c2c14593caee5638603120553ae1ec530f85Chet Haase * The number of items in the adapter before a data changed event occurred. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mOldItemCount; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Represents an invalid position. All valid positions are in the range 0 to 1 less than the 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number of items in the current adapter. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int INVALID_POSITION = -1; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Represents an empty or invalid row id 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long INVALID_ROW_ID = Long.MIN_VALUE; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The last selected position we used when notifying 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mOldSelectedPosition = INVALID_POSITION; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The id of the last selected position we used when notifying 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long mOldSelectedRowId = INVALID_ROW_ID; 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates what focusable state is requested when calling setFocusable(). 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In addition to this, this view has other criteria for actually 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * determining the focusable state (such as whether its empty or the text 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filter is shown). 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setFocusable(boolean) 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #checkFocus() 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mDesiredFocusableState; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mDesiredFocusableInTouchModeState; 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private SelectionNotifier mSelectionNotifier; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * When set to true, calls to requestLayout() will not propagate up the parent hierarchy. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is used to layout the children during a layout pass. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mBlockLayoutRequests = false; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AdapterView(Context context) { 226d6479ec5eec13914f656f6be996d95fe1610fd57Alan Viverette this(context, null); 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AdapterView(Context context, AttributeSet attrs) { 230d6479ec5eec13914f656f6be996d95fe1610fd57Alan Viverette this(context, attrs, 0); 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 233617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette public AdapterView(Context context, AttributeSet attrs, int defStyleAttr) { 234617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette this(context, attrs, defStyleAttr, 0); 235617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette } 236617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette 237617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette public AdapterView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) { 238617feb99a06e7ffb3894e86a286bf30e085f321aAlan Viverette super(context, attrs, defStyleAttr, defStyleRes); 2394213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov 2404213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov // If not explicitly specified this view is important for accessibility. 2414213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov if (getImportantForAccessibility() == IMPORTANT_FOR_ACCESSIBILITY_AUTO) { 2424213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES); 2434213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface definition for a callback to be invoked when an item in this 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AdapterView has been clicked. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnItemClickListener { 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback method to be invoked when an item in this AdapterView has 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been clicked. 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Implementers can call getItemAtPosition(position) if they need 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to access the data associated with the selected item. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parent The AdapterView where the click happened. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The view within the AdapterView that was clicked (this 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be a view provided by the adapter) 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position The position of the view in the adapter. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The row id of the item that was clicked. 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onItemClick(AdapterView<?> parent, View view, int position, long id); 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register a callback to be invoked when an item in this AdapterView has 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been clicked. 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener The callback that will be invoked. 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setOnItemClickListener(OnItemClickListener listener) { 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemClickListener = listener; 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The callback to be invoked with an item in this AdapterView has 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been clicked, or null id no callback has been set. 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final OnItemClickListener getOnItemClickListener() { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mOnItemClickListener; 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call the OnItemClickListener, if it is defined. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The view within the AdapterView that was clicked. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position The position of the view in the adapter. 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The row id of the item that was clicked. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return True if there was an assigned OnItemClickListener that was 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called, false otherwise is returned. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean performItemClick(View view, int position, long id) { 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mOnItemClickListener != null) { 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project playSoundEffect(SoundEffectConstants.CLICK); 298cbff417962b06cb2d80fe8efe8de31482e7bfcbbAdam Powell if (view != null) { 299cbff417962b06cb2d80fe8efe8de31482e7bfcbbAdam Powell view.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED); 300cbff417962b06cb2d80fe8efe8de31482e7bfcbbAdam Powell } 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemClickListener.onItemClick(this, view, position, id); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface definition for a callback to be invoked when an item in this 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * view has been clicked and held. 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnItemLongClickListener { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback method to be invoked when an item in this view has been 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clicked and held. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Implementers can call getItemAtPosition(position) if they need to access 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the data associated with the selected item. 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parent The AbsListView where the click happened 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The view within the AbsListView that was clicked 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position The position of the view in the list 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The row id of the item that was clicked 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the callback consumed the long click, false otherwise 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id); 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register a callback to be invoked when an item in this AdapterView has 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been clicked and held 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener The callback that will run 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setOnItemLongClickListener(OnItemLongClickListener listener) { 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isLongClickable()) { 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setLongClickable(true); 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemLongClickListener = listener; 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The callback to be invoked with an item in this AdapterView has 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been clicked and held, or null id no callback as been set. 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final OnItemLongClickListener getOnItemLongClickListener() { 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mOnItemLongClickListener; 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface definition for a callback to be invoked when 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an item in this view has been selected. 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnItemSelectedListener { 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 358f18c8ddd0f466de4b2f819fbbd612949bd71c532Romain Guy * <p>Callback method to be invoked when an item in this view has been 359f18c8ddd0f466de4b2f819fbbd612949bd71c532Romain Guy * selected. This callback is invoked only when the newly selected 360f18c8ddd0f466de4b2f819fbbd612949bd71c532Romain Guy * position is different from the previously selected position or if 361f18c8ddd0f466de4b2f819fbbd612949bd71c532Romain Guy * there was no selected item.</p> 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Impelmenters can call getItemAtPosition(position) if they need to access the 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data associated with the selected item. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parent The AdapterView where the selection happened 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The view within the AdapterView that was clicked 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position The position of the view in the adapter 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The row id of the item that is selected 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onItemSelected(AdapterView<?> parent, View view, int position, long id); 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback method to be invoked when the selection disappears from this 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * view. The selection can disappear for instance when touch is activated 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or when the adapter becomes empty. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parent The AdapterView that now contains no selected item. 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onNothingSelected(AdapterView<?> parent); 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register a callback to be invoked when an item in this AdapterView has 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been selected. 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener The callback that will run 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setOnItemSelectedListener(OnItemSelectedListener listener) { 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemSelectedListener = listener; 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final OnItemSelectedListener getOnItemSelectedListener() { 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mOnItemSelectedListener; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extra menu information provided to the 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.view.View.OnCreateContextMenuListener#onCreateContextMenu(ContextMenu, View, ContextMenuInfo) } 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback when a context menu is brought up for this AdapterView. 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class AdapterContextMenuInfo implements ContextMenu.ContextMenuInfo { 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AdapterContextMenuInfo(View targetView, int position, long id) { 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.targetView = targetView; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.position = position; 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.id = id; 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The child view for which the context menu is being displayed. This 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be one of the children of this AdapterView. 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public View targetView; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The position in the adapter for which the context menu is being 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed. 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int position; 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The row id of the item for which the context menu is being displayed. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long id; 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the adapter currently associated with this widget. 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The adapter used to provide this view's content. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public abstract T getAdapter(); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the adapter that provides the data and the views to represent the data 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in this widget. 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param adapter The adapter to use to create this view's content. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public abstract void setAdapter(T adapter); 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param child Ignored. 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addView(View child) { 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("addView(View) is not supported in AdapterView"); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param child Ignored. 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Ignored. 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addView(View child, int index) { 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("addView(View, int) is not supported in AdapterView"); 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param child Ignored. 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param params Ignored. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addView(View child, LayoutParams params) { 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("addView(View, LayoutParams) " 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "is not supported in AdapterView"); 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param child Ignored. 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Ignored. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param params Ignored. 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addView(View child, int index, LayoutParams params) { 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("addView(View, int, LayoutParams) " 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "is not supported in AdapterView"); 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param child Ignored. 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeView(View child) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("removeView(View) is not supported in AdapterView"); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Ignored. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeViewAt(int index) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("removeViewAt(int) is not supported in AdapterView"); 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is not supported and throws an UnsupportedOperationException when called. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws UnsupportedOperationException Every time this method is invoked. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeAllViews() { 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("removeAllViews() is not supported in AdapterView"); 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onLayout(boolean changed, int left, int top, int right, int bottom) { 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLayoutHeight = getHeight(); 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the position of the currently selected item within the adapter's data set 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int Position (starting at 0), or {@link #INVALID_POSITION} if there is nothing selected. 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @ViewDebug.CapturedViewProperty 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSelectedItemPosition() { 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNextSelectedPosition; 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The id corresponding to the currently selected item, or {@link #INVALID_ROW_ID} 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if nothing is selected. 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @ViewDebug.CapturedViewProperty 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long getSelectedItemId() { 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNextSelectedRowId; 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The view corresponding to the currently selected item, or null 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if nothing is selected 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public abstract View getSelectedView(); 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The data corresponding to the currently selected item, or 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null if there is nothing selected. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Object getSelectedItem() { 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T adapter = getAdapter(); 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int selection = getSelectedItemPosition(); 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (adapter != null && adapter.getCount() > 0 && selection >= 0) { 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return adapter.getItem(selection); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The number of items owned by the Adapter associated with this 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AdapterView. (This is the number of data items, which may be 5805e25c2c14593caee5638603120553ae1ec530f85Chet Haase * larger than the number of visible views.) 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @ViewDebug.CapturedViewProperty 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getCount() { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mItemCount; 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the position within the adapter's data set for the view, where view is a an adapter item 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or a descendant of an adapter item. 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view an adapter item, or a descendant of an adapter item. This must be visible in this 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AdapterView at the time of the call. 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the position within the adapter's data set of the view, or {@link #INVALID_POSITION} 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the view does not correspond to a list item (or it is not currently visible). 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPositionForView(View view) { 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project View listItem = view; 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project View v; 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (!(v = (View) listItem.getParent()).equals(this)) { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project listItem = v; 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassCastException e) { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We made it up to the window without find this list view 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Search the children for the list item 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int childCount = getChildCount(); 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < childCount; i++) { 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (getChildAt(i).equals(listItem)) { 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mFirstPosition + i; 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Child not found! 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the position within the adapter's data set for the first item 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed on screen. 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The position within the adapter's data set 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getFirstVisiblePosition() { 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mFirstPosition; 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the position within the adapter's data set for the last item 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed on screen. 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The position within the adapter's data set 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getLastVisiblePosition() { 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mFirstPosition + getChildCount() - 1; 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 64175986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov * Sets the currently selected item. To support accessibility subclasses that 64275986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov * override this method must invoke the overriden super method first. 64375986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov * 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position Index (starting at 0) of the data item to be selected. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public abstract void setSelection(int position); 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the view to show if the adapter is empty 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6511480fddea874a42adb43b4bcdac6704e4c3e110bAdam Cohen @android.view.RemotableViewMethod 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setEmptyView(View emptyView) { 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEmptyView = emptyView; 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6554213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov // If not explicitly specified this view is important for accessibility. 656f937313944e0e9dfa4375a275710e420c2a92554Mindy Pereira if (emptyView != null 657f937313944e0e9dfa4375a275710e420c2a92554Mindy Pereira && emptyView.getImportantForAccessibility() == IMPORTANT_FOR_ACCESSIBILITY_AUTO) { 6584213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov emptyView.setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES); 6594213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 6604213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final T adapter = getAdapter(); 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean empty = ((adapter == null) || adapter.isEmpty()); 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project updateEmptyStatus(empty); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * When the current adapter is empty, the AdapterView can display a special view 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call the empty view. The empty view is used to provide feedback to the user 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that no data is available in this AdapterView. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The view to show if the adapter is empty. 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public View getEmptyView() { 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mEmptyView; 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates whether this view is in filter mode. Filter mode can for instance 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be enabled by a user when typing on the keyboard. 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return True if the view is in filter mode, false otherwise. 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isInFilterMode() { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setFocusable(boolean focusable) { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final T adapter = getAdapter(); 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean empty = adapter == null || adapter.getCount() == 0; 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDesiredFocusableState = focusable; 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!focusable) { 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDesiredFocusableInTouchModeState = false; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setFocusable(focusable && (!empty || isInFilterMode())); 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setFocusableInTouchMode(boolean focusable) { 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final T adapter = getAdapter(); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean empty = adapter == null || adapter.getCount() == 0; 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDesiredFocusableInTouchModeState = focusable; 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (focusable) { 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDesiredFocusableState = true; 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setFocusableInTouchMode(focusable && (!empty || isInFilterMode())); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void checkFocus() { 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final T adapter = getAdapter(); 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean empty = adapter == null || adapter.getCount() == 0; 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean focusable = !empty || isInFilterMode(); 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The order in which we set focusable in touch mode/focusable may matter 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // for the client, see View.setFocusableInTouchMode() comments for more 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // details 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setFocusableInTouchMode(focusable && mDesiredFocusableInTouchModeState); 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setFocusable(focusable && mDesiredFocusableState); 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEmptyView != null) { 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project updateEmptyStatus((adapter == null) || adapter.isEmpty()); 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the status of the list based on the empty parameter. If empty is true and 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we have an empty view, display it. In all the other cases, make sure that the listview 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is VISIBLE and that the empty view is GONE (if it's not null). 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void updateEmptyStatus(boolean empty) { 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isInFilterMode()) { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project empty = false; 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (empty) { 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEmptyView != null) { 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEmptyView.setVisibility(View.VISIBLE); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setVisibility(View.GONE); 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If the caller just removed our empty view, make sure the list view is visible 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setVisibility(View.VISIBLE); 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We are now GONE, so pending layouts will not be dispatched. 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Force one here to make sure that the state of the list matches 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the state of the adapter. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataChanged) { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.onLayout(false, mLeft, mTop, mRight, mBottom); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEmptyView != null) mEmptyView.setVisibility(View.GONE); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setVisibility(View.VISIBLE); 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the data associated with the specified position in the list. 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position Which data to get 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The data associated with the specified position in the list 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Object getItemAtPosition(int position) { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T adapter = getAdapter(); 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (adapter == null || position < 0) ? null : adapter.getItem(position); 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long getItemIdAtPosition(int position) { 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T adapter = getAdapter(); 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (adapter == null || position < 0) ? INVALID_ROW_ID : adapter.getItemId(position); 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setOnClickListener(OnClickListener l) { 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Don't call setOnClickListener for an AdapterView. " 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "You probably want setOnItemClickListener instead"); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Override to prevent freezing of any views created by the adapter. 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void dispatchSaveInstanceState(SparseArray<Parcelable> container) { 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dispatchFreezeSelfOnly(container); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Override to prevent thawing of any views created by the adapter. 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void dispatchRestoreInstanceState(SparseArray<Parcelable> container) { 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dispatchThawSelfOnly(container); 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project class AdapterDataSetObserver extends DataSetObserver { 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Parcelable mInstanceState = null; 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onChanged() { 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataChanged = true; 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOldItemCount = mItemCount; 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mItemCount = getAdapter().getCount(); 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Detect the case where a cursor that was previously invalidated has 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // been repopulated with new data. 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (AdapterView.this.getAdapter().hasStableIds() && mInstanceState != null 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project && mOldItemCount == 0 && mItemCount > 0) { 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AdapterView.this.onRestoreInstanceState(mInstanceState); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInstanceState = null; 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rememberSyncState(); 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkFocus(); 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requestLayout(); 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onInvalidated() { 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataChanged = true; 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (AdapterView.this.getAdapter().hasStableIds()) { 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Remember the current state for the case where our hosting activity is being 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // stopped and later restarted 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInstanceState = AdapterView.this.onSaveInstanceState(); 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Data is invalid so we should reset our state 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOldItemCount = mItemCount; 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mItemCount = 0; 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedPosition = INVALID_POSITION; 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedRowId = INVALID_ROW_ID; 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedPosition = INVALID_POSITION; 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedRowId = INVALID_ROW_ID; 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNeedSync = false; 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkFocus(); 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requestLayout(); 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearSavedState() { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInstanceState = null; 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8479c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell @Override 8489c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell protected void onDetachedFromWindow() { 8499c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell super.onDetachedFromWindow(); 8509c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell removeCallbacks(mSelectionNotifier); 8519c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell } 8529c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell 8539c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell private class SelectionNotifier implements Runnable { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mDataChanged) { 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Data has changed between when this SelectionNotifier 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // was posted and now. We need to wait until the AdapterView 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // has been synched to the new data. 8599c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell if (getAdapter() != null) { 8609c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell post(this); 8619c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fireOnSelected(); 8644213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov performAccessibilityActionsOnSelected(); 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void selectionChanged() { 8704213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov if (mOnItemSelectedListener != null 8714213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov || AccessibilityManager.getInstance(mContext).isEnabled()) { 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mInLayout || mBlockLayoutRequests) { 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If we are in a layout traversal, defer notification 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // by posting. This ensures that the view tree is 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // in a consistent state and is able to accomodate 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // new layout or invalidate requests. 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelectionNotifier == null) { 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectionNotifier = new SelectionNotifier(); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8809c17a4c11005877b65d841f4fbd810df89c7c206Adam Powell post(mSelectionNotifier); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fireOnSelected(); 8834213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov performAccessibilityActionsOnSelected(); 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void fireOnSelected() { 8894213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov if (mOnItemSelectedListener == null) { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 8914213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 8924213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov final int selection = getSelectedItemPosition(); 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selection >= 0) { 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project View v = getSelectedView(); 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemSelectedListener.onItemSelected(this, v, selection, 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getAdapter().getItemId(selection)); 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOnItemSelectedListener.onNothingSelected(this); 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9024213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov private void performAccessibilityActionsOnSelected() { 9034213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov if (!AccessibilityManager.getInstance(mContext).isEnabled()) { 9044213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov return; 9054213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 9064213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov final int position = getSelectedItemPosition(); 9074213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov if (position >= 0) { 9084213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov // we fire selection events here not in View 9094213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED); 9104213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 9114213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov } 9124213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 91475986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) { 9150b0a41d8e26eaf0f1d9d922621494daf40964a9aSvetoslav Ganov View selectedView = getSelectedView(); 916d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov if (selectedView != null && selectedView.getVisibility() == VISIBLE 917d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov && selectedView.dispatchPopulateAccessibilityEvent(event)) { 918d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov return true; 9190b0a41d8e26eaf0f1d9d922621494daf40964a9aSvetoslav Ganov } 920bad9d97693a784ea37f1510550e0e4a98f9a9180Svetoslav Ganov return false; 921bad9d97693a784ea37f1510550e0e4a98f9a9180Svetoslav Ganov } 922bad9d97693a784ea37f1510550e0e4a98f9a9180Svetoslav Ganov 923bad9d97693a784ea37f1510550e0e4a98f9a9180Svetoslav Ganov @Override 924bad9d97693a784ea37f1510550e0e4a98f9a9180Svetoslav Ganov public boolean onRequestSendAccessibilityEvent(View child, AccessibilityEvent event) { 9256179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov if (super.onRequestSendAccessibilityEvent(child, event)) { 9266179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov // Add a record for ourselves as well. 9276179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov AccessibilityEvent record = AccessibilityEvent.obtain(); 9286179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov onInitializeAccessibilityEvent(record); 9296179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov // Populate with the text of the requesting child. 9306179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov child.dispatchPopulateAccessibilityEvent(record); 9316179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov event.appendRecord(record); 9326179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov return true; 9336179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov } 9346179ea3196e9306d3f14361fe9ef14191b1edba6Svetoslav Ganov return false; 935736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov } 9363fb3d7c4e756bd32d5abde0abca9ab52d559bc84Adam Powell 937736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov @Override 938d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) { 939d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov super.onInitializeAccessibilityNodeInfo(info); 9408a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov info.setClassName(AdapterView.class.getName()); 941d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov info.setScrollable(isScrollableForAccessibility()); 942d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov View selectedView = getSelectedView(); 943d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov if (selectedView != null) { 944d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov info.setEnabled(selectedView.isEnabled()); 945d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov } 946d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov } 947d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov 948d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov @Override 94930401328c1026389171d454c934c15875c3f7ff0Svetoslav Ganov public void onInitializeAccessibilityEvent(AccessibilityEvent event) { 95030401328c1026389171d454c934c15875c3f7ff0Svetoslav Ganov super.onInitializeAccessibilityEvent(event); 9518a78fd4d9572dff95432fcc4ba0e87563415b728Svetoslav Ganov event.setClassName(AdapterView.class.getName()); 952d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov event.setScrollable(isScrollableForAccessibility()); 953736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov View selectedView = getSelectedView(); 954736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov if (selectedView != null) { 955736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov event.setEnabled(selectedView.isEnabled()); 956736c2756bf3c14ae9fef7255c119057f7a2be1edSvetoslav Ganov } 957eb0c52e491d89543d0e9573b81fdb9145d680059Svetoslav Ganov event.setCurrentItemIndex(getSelectedItemPosition()); 958d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov event.setFromIndex(getFirstVisiblePosition()); 959d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov event.setToIndex(getLastVisiblePosition()); 9600e6fa8b60d113883c92dd754f5e3f8bb8b17e073Svetoslav Ganov event.setItemCount(getCount()); 961d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov } 962d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov 963d9ee72fddb8be40e414a831fb80458dc48699613Svetoslav Ganov private boolean isScrollableForAccessibility() { 96498348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov T adapter = getAdapter(); 96598348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov if (adapter != null) { 96698348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov final int itemCount = adapter.getCount(); 96798348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov return itemCount > 0 96898348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov && (getFirstVisiblePosition() > 0 || getLastVisiblePosition() < itemCount - 1); 96998348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov } 97098348517fde86f993b5720a862bce5c2a5f1a06fSvetoslav Ganov return false; 97175986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov } 97275986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov 97375986cf9bc57ef11ad70f36fb77fbbf5d63af6ecsvetoslavganov @Override 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected boolean canAnimate() { 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return super.canAnimate() && mItemCount > 0; 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void handleDataChanged() { 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int count = mItemCount; 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean found = false; 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (count > 0) { 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int newPos; 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Find the row we are supposed to sync to 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mNeedSync) { 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Update this first, since setNextSelectedPositionInt inspects 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // it 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNeedSync = false; 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // See if we can find a position in the new data with the same 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // id as the old selection 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newPos = findSyncPosition(); 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (newPos >= 0) { 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Verify that new selection is selectable 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int selectablePos = lookForSelectablePosition(newPos, true); 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selectablePos == newPos) { 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Same row id is selected 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setNextSelectedPositionInt(newPos); 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project found = true; 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!found) { 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Try to use the same position if we can't find matching data 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newPos = getSelectedItemPosition(); 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Pin position to the available range 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (newPos >= count) { 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newPos = count - 1; 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (newPos < 0) { 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newPos = 0; 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Make sure we select something selectable -- first look down 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int selectablePos = lookForSelectablePosition(newPos, true); 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selectablePos < 0) { 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Looking down didn't work -- try looking up 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project selectablePos = lookForSelectablePosition(newPos, false); 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selectablePos >= 0) { 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setNextSelectedPositionInt(selectablePos); 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkSelectionChanged(); 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project found = true; 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!found) { 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Nothing is selected 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedPosition = INVALID_POSITION; 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedRowId = INVALID_ROW_ID; 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedPosition = INVALID_POSITION; 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedRowId = INVALID_ROW_ID; 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNeedSync = false; 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkSelectionChanged(); 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10394213804541a8b05cd0587b138a2fd9a3b7fd9350Svetoslav Ganov 104000dbe81fea7be57ee2ff8a97844faf1bc15a427fSvetoslav notifySubtreeAccessibilityStateChangedIfNeeded(); 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void checkSelectionChanged() { 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mSelectedPosition != mOldSelectedPosition) || (mSelectedRowId != mOldSelectedRowId)) { 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project selectionChanged(); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOldSelectedPosition = mSelectedPosition; 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOldSelectedRowId = mSelectedRowId; 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Searches the adapter for a position matching mSyncRowId. The search starts at mSyncPosition 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and then alternates between moving up and moving down until 1) we find the right position, or 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2) we run out of time, or 3) we have looked at every position 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Position of the row that matches mSyncRowId, or {@link #INVALID_POSITION} if it can't 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be found 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int findSyncPosition() { 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = mItemCount; 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (count == 0) { 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long idToMatch = mSyncRowId; 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int seed = mSyncPosition; 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If there isn't a selection don't hunt for it 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (idToMatch == INVALID_ROW_ID) { 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Pin seed to reasonable values 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seed = Math.max(0, seed); 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seed = Math.min(count - 1, seed); 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long endTime = SystemClock.uptimeMillis() + SYNC_MAX_DURATION_MILLIS; 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long rowId; 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // first position scanned so far 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int first = seed; 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // last position scanned so far 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int last = seed; 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // True if we should move down on the next iteration 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean next = false; 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // True when we have looked at the first item in the data 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hitFirst; 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // True when we have looked at the last item in the data 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hitLast; 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Get the item ID locally (instead of getItemIdAtPosition), so 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we need the adapter 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T adapter = getAdapter(); 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (adapter == null) { 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (SystemClock.uptimeMillis() <= endTime) { 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rowId = adapter.getItemId(seed); 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rowId == idToMatch) { 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Found it! 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return seed; 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hitLast = last == count - 1; 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hitFirst = first == 0; 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (hitLast && hitFirst) { 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Looked at everything 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (hitFirst || (next && !hitLast)) { 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Either we hit the top, or we are trying to move down 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project last++; 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seed = last; 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Try going up next time 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project next = false; 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (hitLast || (!next && !hitFirst)) { 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Either we hit the bottom, or we are trying to move up 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project first--; 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project seed = first; 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Try going down next time 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project next = true; 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return INVALID_POSITION; 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Find a position that can be selected (i.e., is not a separator). 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position The starting position to look at. 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param lookDown Whether to look down for other positions. 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The next selectable position starting at position and then searching either up or 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * down. Returns {@link #INVALID_POSITION} if nothing can be found. 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lookForSelectablePosition(int position, boolean lookDown) { 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return position; 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility to keep mSelectedPosition and mSelectedRowId in sync 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position Our current position 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setSelectedPositionInt(int position) { 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedPosition = position; 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelectedRowId = getItemIdAtPosition(position); 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility to keep mNextSelectedPosition and mNextSelectedRowId in sync 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position Intended value for mSelectedPosition the next time we go 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * through layout 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setNextSelectedPositionInt(int position) { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedPosition = position; 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNextSelectedRowId = getItemIdAtPosition(position); 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // If we are trying to sync to the selection, update that too 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mNeedSync && mSyncMode == SYNC_SELECTED_POSITION && position >= 0) { 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncPosition = position; 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncRowId = mNextSelectedRowId; 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remember enough information to restore the screen state when the data has 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void rememberSyncState() { 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (getChildCount() > 0) { 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNeedSync = true; 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncHeight = mLayoutHeight; 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelectedPosition >= 0) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Sync the selection state 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project View v = getChildAt(mSelectedPosition - mFirstPosition); 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncRowId = mNextSelectedRowId; 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncPosition = mNextSelectedPosition; 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (v != null) { 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSpecificTop = v.getTop(); 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncMode = SYNC_SELECTED_POSITION; 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Sync the based on the offset of the first view 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project View v = getChildAt(0); 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T adapter = getAdapter(); 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mFirstPosition >= 0 && mFirstPosition < adapter.getCount()) { 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncRowId = adapter.getItemId(mFirstPosition); 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncRowId = NO_ID; 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncPosition = mFirstPosition; 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (v != null) { 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSpecificTop = v.getTop(); 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSyncMode = SYNC_FIRST_POSITION; 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1210