android api 中文 （73）—— AdapterView

一、結構

java.lang.Object

android.view.View

         android.view.ViewGroup

                   android.widget.AdapterView<T extends android.widget.Adapter> 

直接子類

間接子類

二、概述

三、常量

　　public static final int INVALID_POSITION

　　代表無效的位置。有效值的範圍是 0 到目前擴充卡項目數減 1 。

　　常量值： -1 (0xffffffff)

　　public static final long INVALID_ROW_ID

　　代表空或者無效的行ID。

　　常量值： -9223372036854775808 (0x8000000000000000)

　　public static final int ITEM_VIEW_TYPE_HEADER_OR_FOOTER

　　常量值： -2 (0xfffffffe)

　　public static final int ITEM_VIEW_TYPE_IGNORE

四、構造函數

　　構造函數

五、公共方法

　　該類不支援該方法，如果調用将抛出 UnsupportedOperationException 異常。

　　參數

         child　　忽略

　　　　　　異常

           child         忽略。

　　index       忽略。

　　抛出

　　index       忽略。

　　params  忽略。

     　　child         忽略。

　  params  忽略。

         event       事件。

　　傳回值

　　如果事件分發完成，傳回真。 

　　public abstract T getAdapter ()

　　傳回目前與該小部件關聯的擴充卡。

　　用于提供視圖内容的擴充卡。 

　　public int getCount ()

傳回值

與 AdapterView 相關聯的擴充卡的條目數量。（該值是資料條目的數量， 可能大于可見的視圖的數量。） 

　　目前擴充卡無内容時，AdapterView 會顯示特殊的空視圖。 空視圖用于告訴使用者，該 AdapterView 沒有資料。

　　擴充卡為空時顯示的視圖。 

　　public int getFirstVisiblePosition ()

　　傳回顯示在螢幕上的第一個元素在擴充卡中所處的位置。

　　在擴充卡資料集中的位置。 

　　取得清單中指定位置的資料。

         position 要取得資料的位置。

　　清單中指定位置的資料。 

　　public long getItemIdAtPosition (int position) 

　　public int getLastVisiblePosition ()

　　傳回顯示在螢幕上的最後一個元素在擴充卡中所處的位置。

　　點選 AdapterView 中的條目時執行的回調函數；沒有設定時傳回空。

取得長按 AdapterView 中的條目時執行的回調函數的監聽器；未設定則傳回空。 

　　取得擴充卡項目對應的視圖或其子視圖在擴充卡的資料中所處的位置。

         view         擴充卡條目或其後代的視圖。調用時該項目在 AdapterView 中必須可見。

目前選中條目對應的資料；無選中條目時傳回空。 

　　public long getSelectedItemId ()

　　public int getSelectedItemPosition ()

　　傳回目前選中項目在擴充卡資料中的位置。

目前選中條目對應的視圖；無選中條目時傳回空。 

　　如果定義了 OnItemClickListener 則調用它。

　　view         AdapterView 中被點選的視圖。

　　position 視圖在擴充卡中的索引。

　　id     點選的條目的行 ID。

　　如果成功調用了定義的 OnItemClickListener 則傳回真；否則傳回假。 

　　public void removeAllViews ()

　　child         忽略。

　　public void removeViewAt (int index)

         index       忽略。

　　public abstract void setAdapter (T adapter)

　　設定用于為該小部件的視圖提供用于顯示的資料的擴充卡。

         adapter 用于建立視圖内容的擴充卡。

　　設定擴充卡内容為空時顯示的視圖。 

　　public void setFocusable (boolean focusable)

　　設定該視圖是否可以擷取焦點。 設為假時，可以確定在觸控模式中該視圖不能得到焦點。

         focusable         設為真時，該視圖可以得到焦點。

　　public void setFocusableInTouchMode (boolean focusable)

　　設定在觸控模式下該視圖是否可以擷取焦點。 設為真時，可以保證視圖可以得到焦點。

　　參數         

             focusable        設為真時，該視圖在觸控模式下可以得到焦點。

　　注冊點選該視圖時執行的回調函數。如果該視圖不可點選，會将其改為可以點選的狀态。

         l       事件發生時運作的回調函數。

　　注冊單擊 AdapterView 中的條目時執行的回調函數。

         listener  将要調用的回調。

　　注冊長按 AdapterView 中的條目時執行的回調函數。

         listener  事件發生時運作的回調函數。

　　注冊選中 AdapterView 中的條目時執行的回調函數。

　　public abstract void setSelection (int position)

　　設定目前選擇條目。為了支援無障礙功能，重寫該方法的子類必須首先調用父類的該方法。

         position 選擇的資料條目的索引（從零開始）。

六、保護方法

　　protected boolean canAnimate ()

　　訓示視圖組是否能夠在首次布局後為其子視圖提供動畫效果的顯示。

　　如果子視圖可以使用動畫效果則傳回真，否則傳回假。 

　　protected void dispatchRestoreInstanceState (SparseArray<Parcelable> container)

　　為了防止擴充卡生成的視圖被解凍而重寫。

        　　container    儲存有之前存儲的狀态資訊的 SparseArray。

　　protected void dispatchSaveInstanceState (SparseArray<Parcelable> container)

　　為了防止擴充卡生成的視圖被當機而重寫。

       　　 container    儲存視圖狀态的 SparseArray。

　　protected void onLayout (boolean changed, int left, int top, int right, int bottom)

　　該視圖設定其子視圖的大小及位置時調用。派生類可以重寫此方法，并為其子類布局。

　　changed     是否為視圖設定了新的大小和位置。

　　left 相對于父視圖的左側的位置。

　　top 相對于父視圖的頂部的位置。

　　right    相對于父視圖的右側的位置。

　　bottom 相對于父視圖的底部的位置。

七、補充

               補充說明

　　文章精選

<a href="http://eshock.blogbus.com/">小胖's blog</a>

<a href="http://eshock.blogbus.com/logs/61259226.html">Android SDK 中文文檔計劃 (14) 使用AdapterView來綁定資料</a>