Android API中文文檔GridView是本文要介紹的內(nèi)容，主要是來了解并學(xué)習(xí)Android API的內(nèi)容，具體Android API內(nèi)容的詳解來看本文。

一、Android API結(jié)構(gòu)

publicfinalclassGridViewextendsAbsListView  
java.lang.Object  
android.view.View  
android.view.ViewGroup  
android.widget.AdapterView  
android.widget.AbsListView  
android.widget.GridView 

二、Android API類概述

Android API中一個在平面上可顯示多個條目的可滾動的視圖組件，該組件中的條目通過一個ListAdapter和該組件進(jìn)行關(guān)聯(lián)。比如android手機(jī)中顯示的應(yīng)用：

比如實(shí)現(xiàn)九宮格圖，用GridView是***，也是最簡單的。

三、Android API構(gòu)造函數(shù)

public Grid View(Contextcontext) 

創(chuàng)建一個默認(rèn)屬性的GridView實(shí)例

public GridView(Contextcontext,AttributeSetattrs) 

創(chuàng)建一個帶有attrs屬性的GridView實(shí)例

public GridView (Contextcontext,AttributeSetattrs,intdefStyle) 

創(chuàng)建一個帶有attrs屬性，并且指定其默認(rèn)樣式的GridView實(shí)例

四、Android API中XML屬性

屬性名稱描述

android:columnWidth設(shè)置列的寬度。關(guān)聯(lián)的方法為：setColumnWidth(int)

android:gravity設(shè)置此組件中的內(nèi)容在組件中的位置。可選的值有：top、bottom、left、right、center_vertical、fill_vertical、center_horizontal、fill_horizontal、center、fill、clip_vertical可以多選，用“|”分開。關(guān)聯(lián)方法：setGravity(intgravity)

android:horizontalSpacing兩列之間的間距。關(guān)聯(lián)方法：setHorizontalSpacing(int)

android:numColumns列數(shù)。關(guān)聯(lián)方法：setNumColumns(int)

android:stretchMode縮放模式。關(guān)聯(lián)方法：setStretchMode(int)

android:verticalSpacing兩行之間的間距。關(guān)聯(lián)方法：setVerticalSpacing(int)

五、Android API公共方法

publicListAdaptergetAdapter() 

獲得與此組件相關(guān)的適配器..

返回值

ListAdapter適配器實(shí)例

publicintgetStretchMode()

獲得GridView的縮放模式..

public boolean onKeyDown (intkeyCode,KeyEventevent) 

默認(rèn)由KeyEvent.Callback.onKeyMultiple（）實(shí)現(xiàn)，如果視圖是可用的并且是可點(diǎn)擊的，那么傳入KEYCODE_DPAD_CENTER或KEYCODE_ENTER值是執(zhí)行的是按下視圖操作。

參數(shù)

keyCode一個表示按下操作的鍵值.

event表示按鈕事件的對象.

返回值

如果你認(rèn)為已經(jīng)完成事件處理,不想讓讓下一個處理器來處理此事件，則返回true,否則返回false。

public boolean onKeyMultiple(intkeyCode,intrepeatCount,KeyEventevent) 

默認(rèn)由KeyEvent.Callback.onKeyMultiple()實(shí)現(xiàn)，總是返回false（不處理此事件）。

參數(shù)

keyCode鍵值.

repeatCount該動作發(fā)生的次數(shù).

event事件對象.

返回值

如果你認(rèn)為已經(jīng)完成事件處理,不想讓讓下一個處理器來處理此事件，則返回true,否則返回false。

public booleanonKeyUp(intkeyCode,KeyEventevent) 

默認(rèn)由KeyEvent.Callback.onKeyMultiple（）實(shí)現(xiàn)，如果視圖是可用的并且是可點(diǎn)擊的，那么傳入KEYCODE_DPAD_CENTER或KEYCODE_ENTER值是執(zhí)行的是點(diǎn)擊視圖操作。

參數(shù)

keyCode鍵值.

event事件對象.

返回值

如果你認(rèn)為已經(jīng)完成事件處理,不想讓讓下一個處理器來處理此事件，則返回true,否則返回false。

public void setAdapter (ListAdapteradapter) 

設(shè)置GridView的數(shù)據(jù)。

參數(shù)

adapter為grid提供數(shù)據(jù)的適配器

publicvoidsetColumnWidth(intcolumnWidth) 

設(shè)置GridView的列寬.

參數(shù)

columnWidth列的寬度，以像素為單位

publicvoidsetGravity(intgravity)

設(shè)置控件內(nèi)容的位置，默認(rèn)值為：Gravity.LEFT.

參數(shù)

gravity位置值

publicvoidsetHorizontalSpacing(inthorizontalSpacing) 

設(shè)置列間距.

參數(shù)

horizontalSpacing列間距值

public void setNumColumns(intnumColumns) 

設(shè)置grid的列數(shù)

參數(shù)

numColumns列數(shù)值.

public void setSelection (intposition) 

設(shè)置選中的條目.

參數(shù)

position.數(shù)據(jù)條目在列表中的索引值（從0開始），如果在可觸摸的模式下，在該索引值下的條目將不會被選中，但是該索引值仍然指向該條目。

public void setStretchMode(intstretchMode) 

設(shè)置grid中的條目以什么縮放模式去填充空間。.

參數(shù)

stretchMode可選值：NO_STRETCH，STRETCH_SPACING，STRETCH_SPACING_UNIFORM，或STRETCH_COLUMN_WIDTH

public void setVertical Spacing(intverticalSpacing) 

設(shè)置行間距.

參數(shù)

verticalSpacing間距值，以像素為單位

六、Android API代碼示例

下面給出一個小例子，先看效果：

1、GridView01.java  
 
public class GridView01 extends Activity {  
    private GridView gridview;  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        // TODO Auto-generated method stub  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.gridview);  
          
//準(zhǔn)備要添加的數(shù)據(jù)條目  
        List<Map<String, Object>> items = new ArrayList<Map<String,Object>>();  
        for (int i = 0; i < 10; i++) {  
            Map<String, Object> item = new HashMap<String, Object>();  
            item.put("imageItem", R.drawable.icon);  
            item.put("textItem", "text" + i);  
            items.add(item);  
        }  
//實(shí)例化一個適配器  
        SimpleAdapter adapter = new SimpleAdapter(this, items, R.layout.grid_item, 
            new String[]{"imageItem", "textItem"}, new int[]{R.id.image_item, R.id.text_item});  
        //獲得GridView實(shí)例  
        gridview = (GridView)findViewById(R.id.mygridview);  
        //gridview.setNumColumns(3);//可以在xml中設(shè)置  
        //gridview.setGravity(Gravity.CENTER);//同上  
//將GridView和數(shù)據(jù)適配器關(guān)聯(lián)  
        gridview.setAdapter(adapter);  
    }  
}  
 
2、gridview.xml  
 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:layout_width="wrap_content" 
    android:layout_height="wrap_content"> 
    <GridView android:id="@+id/mygridview" 
        android:numColumns="3" 
        android:gravity="center_horizontal" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"> 
    </GridView> 
</LinearLayout> 
 
3、grid_item.xml   
 
<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout android:id="@+id/RelativeLayout01" 
    android:layout_width="fill_parent" android:layout_height="fill_parent" 
    xmlns:android="http://schemas.android.com/apk/res/android"> 
    <ImageView android:id="@+id/image_item" 
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content"> 
    </ImageView> 
    <TextView android:id="@+id/text_item" 
        android:layout_below="@+id/image_item" 
        android:layout_height="wrap_content" 
        android:layout_width="wrap_content"> 
    </TextView> 
</RelativeLayout> 

小結(jié)：

Android API中文文檔GridView的內(nèi)容介紹完了，希望通過Android API內(nèi)容的學(xué)習(xí)能對你有所幫助！