android自訂控制項(一) 官方文檔的翻譯

構建自訂群組件

Android中，你的應用程式程式與View類組件有著一種固定的聯絡，例如按鈕（Button）、文字框（TextView）,可編輯文字框（EditText）,列表框（ListView）,複選框（CheckBox）,單選框（RadioButton）,捲軸（Gallery）,微調器（Spinner）,
等等，還有一些比較先進的有著特殊用途的View組件，例如AutoCompleteTextView,

ImageSwitcher和
TextSwitcher。除此之外，種類繁多的像
線性布局（LinearLayout）,
架構布局（FrameLayout）, 這樣的布局組件（Layout）也被認為是View組件，他們是從View類派生過來的。

你的應用程式就是這些控制組件和布局組件以某種方式結合顯示在螢幕上，一般來說這些組件對你來說基本夠用，但是你也應該知道你是可以通過類繼承建立屬於自己的組件，一般可以繼承像View、Layouts（布局組件）這樣的組件，甚至可以是一些比較進階的控制類組件。下面我們說一下為什麼要繼承：

·         你可以為實現某種功能建立一個完全自訂風格的組件，例如用二維的圖形建立控制組件實現聲音的控制，就像電子控制一樣。

·         你可以把幾種組件結合形成一個新的組件，你的組件可能同時包含ComboBox（一個能輸入的文本列表）和dual-pane selector control（左右兩個List視窗，你可以分配視窗每一項的從屬關係）等等。

·         你可以建立自己的布局組件（Layout）。SDK中的布局組件已經提供了一系列的選項讓你打造屬於自己的應用程式，但是進階的開發人員會發現根據現有的Layout組件開發新的Layout組件是很有必要的，甚至是完全從底層開發新的組件。

·         你可以覆蓋一個現有組件的顯示或功能。例如，改變EditText（可編輯文本）組件在螢幕上的顯示方式（可以參考Notepad的例子，裡面教你如何建立一個底線的顯示頁面）。

·         你可以捕獲像按鍵按下這樣的事件，以一些通用的方法來處理這些事件（一個遊戲的例子）。

為了實現某種目標你可能很有必要擴充一個已經存在的View組件，下面我們結合一些例子教你如何去做。

內容：

基本方法（The Basic Approach ）

完全自訂群組件（Fully Customized Components ）

定製組件的例子（Customized Component Example ）

組件的混合（或者控制類的混合） （Compound Components (or Compound Controls) ）

修改現有組件（Tweaking an Existing Component ）

小結（Go Forth and Componentize ）

基本方法（The Basic Approach ）

下面的一些步驟都比較概括，教你如何建立自己的組件：

1.      讓你的類（Class）繼承一個現有的View 類或View的子類。

2.      重載父類的一些方法：需要重載的父類方法一般以‘on’開頭，如onDraw(),onMeasure()和

onKeyDown()等等。

o               這個在Activity 或則ListActivity 派生中同樣適用，你需要重載一些生命週期函數和一些其他功能性的HOOK函數。

3.      使用你的繼承類：一旦你的繼承類建立完成，你可以在基類能夠使用的地方使用你的繼承類，但完成功能就是你自己編寫的了。

繼承類能夠定義在activities裡面，這樣你能夠方便的調用，但是這並不是必要的（或許在你的應用程式中你希望建立一個所有人都可以使用的組件）。

完全自訂群組件（Fully Customized Components）

完全自訂群組件的方法可以建立一些用於顯示的圖形組件（graphical components），也許是一個像電壓表的圖形計量器，或者想卡拉OK裡面顯示歌詞的小球隨著音樂滾動。無論那種方式，你也不能單純的利用組件的結合完成，無論你怎麼結合這些現有的組件。

幸運的是，你可以以你自己的要求輕鬆地建立完全屬於自己的組件，你會發現不夠用的只是你的想象力、螢幕的尺寸和處理器的效能（記住你的應用程式最後只會在那些效能低於案頭電腦的平台上面運行）。

下面簡單介紹如何打造完全自訂的組件：

1.      最為通用的VIEW類的父類毫無疑問是View類，因此，最開始你要建立一個基於此類的一個子類。

2.      你可以寫一個建構函式從XML檔案中提取屬性和參數，當然你也可以自己定義這些屬性和參數（也許是圖形計量器的顏色和尺寸，或者是指標的寬度和幅度等等）

3.      你可能有必要寫自己的事件監聽器，屬性的訪問和修改函數和一些組件本身的功能上的代碼。

4.      如果你希望組件能夠顯示什麼東西，你很有可能會重載 onMeasure() 函數，因而你就不得不重載 onDraw() 函數。當兩個函數都用預設的，那麼 onDraw()函數將不會做任何事情，並且預設的 onMeasure() 函數自動的設定了一個100x100 —的尺寸，這個尺寸可能並不是你想要的。

5.      其他有必要重載的on... 系列函數都需要重新寫一次。

onDraw()和onMeasure()

onDraw()函數將會傳給你一個
Canvas 對象，通過它你可以在二維圖形上做任何事情，包括其他的一些標準和通用的組件、文本的格式，任何你可以想到的東西都可以通過它實現。

注意: 這裡不包括三維圖形如果你想使用三維的圖形，你應該把你的父類由View改為SurfaceView類，並且用一個單獨的線程。可以參考GLSurfaceViewActivity 的例子。

onMeasure() 函數有點棘手，因為這個函數是體現組件和容器互動的關鍵區段，onMeasure（）應該重載，讓它能夠有效而準確的表現它所包含部分的測量值。這就有點複雜了，因為我們不但要考慮父類的限制（通過onMeasure（）傳過來的），同時我們應該知道一旦測量寬度和高度出來後，就要立即調用setMeasuredDimension() 方法。

概括的來講，執行onMeasure()函數分為一下幾個階段：

1.      重載的onMeasure（）方法會被調用，高度和寬度參數同時也會涉及到（widthMeasureSpec 和heighMeasureSpec兩個參數都是整數類型），同時你應該考慮你產品的尺寸限制。這裡詳細的內容可以參考View.onMeasure(int, int) （這個串連內容詳細的解釋了整個measurement操作）。

2.      你的組件要通過onMeasure（）計算得到必要的measurement長度和寬度從而來顯示你的組件，它應該與規格保持一致，儘管它可以實現一些規格以外的功能（在這個例子裡，父類能夠選擇做什麼，包括剪下、滑動、提交異常或者用不同的參數又一次調用onMeasure（）函數）。

3.      一旦高度和寬度計算出來之後，必須調用setMeasuredDimension(int width, int height)，否則就會導致異常。

一個自訂群組件的例子（A Customized Component Example）

在
API Demos 中的CustomView提供了以一個自訂群組件的例子，這個自訂群組件在
LabelView 類中定義。

LabelView例子涉及到了自訂群組件的方方面面：

·         首先讓自訂群組件從View類中派生出來。

·         編寫帶參數的建構函式（參數可以來源於XML檔案）。這裡面的一些處理都已經在View父類中完成，但是任然有些Labelview使用的自訂群組件特有的新的參數需要處理。

·         一些標準的Public函數，例如setText(), setTextSize(), setTextColor()

·         重載onMeasure（）方法來確定組件的尺寸（注意：在LabelView中是通過一個私人函數measureWidth()來實現的）

·         重載onDraw()函數把Lable顯示在提供的canvas上。

在例子中，你可以通過custom_view_1.xml看到自訂群組件LabelView的用法。在XML檔案中特別要注意的是android：和app:兩個參數的混合運用，app：參數表示應用程式中被認為是LabelView組件的個體，這些也會作為資源在R類中定義。

組件混合技術Compound Components (or Compound Controls)

如果你不想建立一個完全自訂的組件，而是由幾個現有組件的組合產生的新的組件，那麼混合組件技術就更加適合。簡單的來說，這樣把幾個現有的組件融合到一個邏輯組合裡面可以封裝成一個新的組件。例如，一個Combo Box組件可以看作是是一個EditText和一個帶有彈出列表的Button組件的混合體。如果你點擊按鈕為列表選擇一項，

在Android中，其實還有其他的兩個View類可以做到類似的效果：
Spinner和AutoCompleteTextView,，但是Combo Box作為一個例子更容易讓人理解。

下面簡單的介紹如何建立組合組件：

1.      一般從Layout類開始，建立一個Layout類的衍生類別。也許在Combo box我們會選擇水平方向的LinearLayout作為父類。記住，其他的Layout類是可以嵌套到裡面的，因此混合組件可以是任何組件的混合。注意，正如Activity一樣，你既可以使用外部XML檔案來聲明你的組件，也可以嵌套在代碼中。

2.      在新的混合組件的建構函式中，首先，調用所有的父類的建構函式，傳入對應的參數。然後可以設定你的混合組件的其他的一些方面，在哪建立EditText組件，又在哪建立PopupList組件。注意：你同時也可以在XML檔案中引入一些自己的屬性和參數，這些屬性和參數也可以被你的混合組件所使用。

3.      你也可以建立時間監聽器去監聽新組件中View類觸發的事件，例如，對List選項單擊事件的監聽，你必須在此時間發生後更新你EditText的值。

4.      你可能建立自己的一些屬性，帶有訪問和修改方法。例如，允許設定EditText初始值並且提供訪問它的方法。

5.      在Layout的衍生類別中，你沒有必要去重載onDraw（）和onMeasure（）方法，因為Layout會有比較好的預設處理。但是，如果你覺得有必要你也可以重載它。

6.      你也可能重載一些on系列函數，例如通過onKeyDown()的重載，你可以通過按某個鍵去挑選清單中的對應的值。

總之，把Layout類作為基類有下面幾個優點：

·         正如activity一樣，你也可以通過XML檔案去聲明你的新組件，或者你也可以在代碼中嵌套。

·         onDraw（）函數和onMeasure()函數是沒有必要重載的，兩個函數已經做得很好了。

·         你可以很快的建立你的混合組件，並且可以像單一組件那樣使用。

混合組件的例子（Examples of Compound Controls）

In theAPI Demos project 在API Demos工程中，有兩個List類的例子——Example 4和Example6，裡面的SpeechView組件是從LinearLayout類派生過來，實現顯示演講顯示功能，對應的原代碼是List4.java和List6.java。

調整現有組件（Tweaking an Existing Component）

在某些情況下，你可能有更簡單的方法去建立你的組件。如果你應經有了一個非常類似的組件，你所要做的只是簡單的從這個組件派生出你的組件，重在其中一些有必要修改的方法。通過完全自訂群組件的方法你也可以同樣的實現，但通過沖View派生產生新的組件，你可以簡單擷取一些已經存在的處理機制，這些很可能是你所想要的，而沒有必要從頭開始。

例如，在SDK中有一個NotePad的例子（NotePad application ）。該例子示範了很多Android平台實用的細節，例如你會學到從EditView派生出能夠自動換行的記事本。這還不是一個完美的例子，因為相比早期的版本來說，這些API已經感變了很多，但它確實說明了一些問題。

如果你還未查看該程式，現在你就可以在Eclipse中匯入記事本常式（或僅通過提供的連結查看相應的原始碼）。特別是查看NoteEditor.java 中的MyEditText的定義。

下面有幾點要注意的地方：

1.      聲明（The Definition）

這個類是通過下面一行代碼來定義的：

publicstatic class MyEditText extends EditText

o               它是定義在NoteEditor activity類裡面的，但是它是共有的（public），因此如果有必要，它可以通過NoteEditor.MyEditText從NoteEditor外面來調用。

o               它是static類（靜態類），意味著不會出現所謂的通過父類訪問資料的“虛態方法”， 這樣就使該類成為一個可以不嚴重依賴NoteEditor的單獨類。對於不需要從外部類訪問的內聯類的建立，這是一個很清晰地思路，保證所產生的類很小，並且允許它可以被其他的類方便的調用。

o               它是EditText類的擴充，它是我們選擇的用來自訂的父類。當我們完成以後，新的類就可以作為一個普通的EditText來使用。

2.      類的初始化

一般來說，父類是首先調用的。進一步來說，這不是一個預設的建構函式，而是一個帶參數的建構函式。因為EditText是使用從XML布局檔案提取出來的參數進行建立，因此我們的建構函式也要取出參數並且將這些參數傳遞給父類。

3.      方法重載

在本例中，僅對onDraw()一個方法進行重載。但你可以很容易地為你的定製組件重載其他需要的方法。

對於記事本例子來說，通過重載onDraw()方法我們可以在EidtView的畫布（canvas）上繪製藍色的線條（canvas類是通過重寫的onDraw()方法傳遞）。該函數快要結束時要調用super.onDraw()函數。父類的方法是應該調用，但是在這個例子裡面，我們是在我們劃好了藍線之後調用的。

4.      使用定製組件

現在，我們已經有自己定製的組件了，但是應該怎樣使用它呢？在記事本例子中，定製的組件直接在預定義的布局檔案中使用，讓我們看一看res/layout目錄中的note_editor.xml檔案。

<view xmlns:android="http://schemas.android.com/apk/res/android"

 class="com.android.notepad.NoteEditor$MyEditText"

  id="@+id/note"

 android:layout_width="fill_parent"

 android:layout_height="fill_parent"

 android:background="@android:drawable/empty"

  android:padding="10dip"

  android:scrollbars="vertical"

 android:fadingEdge="vertical" />

o               該自訂群組件在XML中是作為一個一般的View類來建立的，並且是通過全路徑包來描述的。注意這裡內聯類是通過NoteEditor$MyEditText來表示的，這是Java編程中引用內聯類的標準方法。

o               在定義中的其他屬性和參數將傳遞給定製組件的建構函式，然後才傳到EditText建構函式中，因此這些參數也是你使用EditText組件的參數。注意，這裡你也可以增加你自己的參數，我們將在下面討論這個問題。

這就是你全部需要做的，誠然這是一個簡單的例子。但問題的關鍵是：你的需求有多複雜，那麼你的自訂群組件就有多麼複雜。

一個更為複雜的組件可能需要重載更多的on系列函數，並且還要很多特有的函數來充分實現自訂群組件的功能。唯一的限制就是你的想象力和你需要組件去執行什麼工作。

現在開始你的組件化之旅吧

如你所見，Android提供了一種精巧而又強大的組件模型，讓你儘可能的完成你的工作。從簡單的組件調整到組件混合，甚至完全自訂群組件，靈活的運用這些技術，你應該可以得到一個完全符合你外觀要求的的Android程式