API 25 (Android 7.1.1 API) widget.AbsListView——屬性分析

Android API 25 （Android 7.1.1 API）

AbsListView

public abstract class AbsListView

extends AdapterView<ListAdapter> implements TextWatcher, ViewTreeObserver.OnGlobalLayoutListener,

Filter.FilterListener, ViewTreeObserver.OnTouchModeChangeListener

Added in API level 1

java.lang.Object

   ↳android.view.View

    ↳android.view.ViewGroup

     ↳android.widget.AdapterView<android.widget.ListAdapter>

      ↳android.widget.AbsListView

已知直接子類：

GridView

ListView

【概述】

可用于實作項目的虛拟化清單的基類。清單在這裡沒有空間定義。例如，此類的子類可以在網格，輪播，堆棧等中顯示清單的内容。

【嵌套類】

類   AbsListView.LayoutParams

AbsListView擴充LayoutParams以提供一個地方來儲存視圖類型。

接口 AbsListView.MultiChoiceModeListener

MultiChoiceModeListener接收CHOICE_MODE_MULTIPLE_MODAL的事件。

接口 AbsListView.OnScrollListener

滾動清單或網格時要調用的回調的接口定義。

接口 AbsListView.RecyclerListener

RecyclerListener用于在View被放置在RecycleBin的廢料堆中時接收通知。

接口 AbsListView.SelectionBoundsAdjuster

清單項的頂級視圖可以實作此接口，以允許自身修改為該項顯示的選擇的邊界。

【XML屬性】

android:  cacheColorHint

API 1

屬性說明：訓示該清單總是在實心的單色不透明的背景下繪制。這允許清單優化其繪制過程。

必須是顔色值（color），格式”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是cacheColorHint。

android:  choiceMode

API 1

屬性說明：定義view的多選操作模式。 應用程式将提供一個AbsListView.MultiChoiceModeListener使用

setMultiChoiceModeListener（AbsListView.MultiChoiceModeListener）來控制選擇模式。 這使用ActionMode API。

必須為以下常量值之一：

none                  CHOICE_MODE_NONE                       普通模式，預設模式，沒有選擇。

SingleChoice          CHOICE_MODE_SINGLE                     單選模式

multipleChoice        CHOICE_MODE_MULTIPLE                   多選模式

multipleChoiceModal   CHOICE_MODE_MULTIPLE_MODAL             多選模式

對應的全局屬性資源符号是choiceMode。

當singleChoice時，listview.getChechedItemPosition()有效。傳回選中的item下标

當multipleChoice時，list.getCheckedItemPositions()有效。傳回一個SparseBooleanArray對象，實際上是一個Map

<Object,boolean>的東西，用的時候SparseBooleanArray.get(0)就可以傳回第一項的boolean值。

android:  drawSelectorOnTop

關聯方法：setDrawSelectorOnTop(boolean onTop)

API 1

屬性說明：如果為真，選擇器将繪制在選中條目的上層。否則繪制在下層。預設為false。

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是drawSelectorOnTop。

android:  fastScrollEnabled

API 1

屬性說明：設定是否允許使用快速滾動滑塊，可以通過拖過該滑塊在清單中快速滾動。

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是fastScrollEnabled。

android:  listSelector

API 1

關聯方法：setSelector(int resID)

屬性說明：用于在清單中訓示目前選中條目的Drawable。

可以引用另一個資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

可以是顔色值（color），格式”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

對應的全局屬性資源符号是listSelector。

android:  scrollingCache

API 1

屬性說明：設定清單滾動時是否使用繪圖緩存。該選項使渲染更快，但占用更多的記憶體。預設為真。

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是scrollingCache。

android:  smoothScrollbar

API 3

關聯方法：setSmoothScrollbarEnabled(boolean enabled)

屬性說明：設定為true時，清單将使用基于螢幕上可見項目的像素高度的更精确的計算方法。 預設情況下，此屬性設定為true，但如果擴充卡顯示不同高度的項目，則應将其設定為false。 當此屬性設定為true并且擴充卡顯示不同高度的項目時，滾動條縮略圖将在使用者滾動清單時更改大小。 當設定為false時，清單将僅使用擴充卡中的項目數和螢幕上可見的項目數來确定滾動條的屬性。

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是smoothScrollbar。

當啟用平滑滾動條時，根據可見項目中可見像素的數量計算滾動條縮略圖的位置和大小。然而，這假定所有清單項具有相同的高度。如果使用清單中項目具有不同的高度，滾動條将在使用者滾動清單時更改外觀。要避免此問題，您需要禁用此屬性。當平滑滾動條被禁用時，滾動條縮略圖的位置和大小僅基于擴充卡中的項目數目和擴充卡内的可見項目的位置。當使用者浏覽具有不同高度的項目清單時，這提供了穩定的滾動條。  

android:  stackFromBottom

API 1

屬性說明：用于 ListView和GridView，訓示他們的内容棧從底部開始

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是stackFromBottom。

android:  textFilterEnabled

API 1

屬性說明：設定為true時，清單将按使用者類型過濾結果。 清單的擴充卡必須支援Filterable接口才能正常工作。

必須是布爾值（boolean），“true”或“false”。

也可以引用一個包含此類型值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全局屬性資源符号是texttFilterEnabled。

android:  transcriptMode

API 1

屬性說明：設定清單的記錄模式。在轉錄模式下，清單滾動到底部，以使新項目在添加時可見。

必須是以下常量值之一：

disabled       禁用轉錄模式。預設值。

normal         當接收到資料集更改通知并且隻有最後一個項目已在螢幕上可見時，清單将自動滾動到底部。

alwaysScroll   清單将自動滾動到底部，無論什麼項目是目前可見的。

對應的全局屬性資源符号是transcriptMode。