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