Android開發之自訂屬性(Define Custom Attributes)

為了在你使用者介面上添加Android內建的View，你可以在一個XML元素中指定這個View，並通過它相應的元素屬性控制該View的外觀和行為。

寫得好的自訂View一樣可以通過XML添加和設定樣式，為了能夠為您的自訂View添加這些行為，你必須：

1. <declare-styleable>資源元素中為你的View自訂屬性；

2.在你的XML布局中為這個屬性指定相應的值；

3.在程式運行時取回屬性值；

4.在你的View中使用你所取回的屬性值；

本節討論如何定義自訂屬性並指定他們的值。下一節則是有關在運行時取得並使用這些值。

為了自訂屬性，添加<declare-styleable>資源到你的項目中，一般這些資源通常放在 res/values/attrs.xml檔案中，

這裡有一個attrs.xml檔案的例子：

<resources>;
   <declare-styleable name="PieChart">
       <attr name="showText" format="boolean" />
       <attr name="labelPosition" format="enum">
           <enum name="left" value="0"/>
           <enum name="right" value="1"/>
       </attr>
   </declare-styleable>
</resources>這些代碼聲明了兩個自訂屬性:"showText"和"labelPosition"，他們屬於一個叫做PieChart的樣式實體。按照慣例，樣式實體的名字是和聲明的自訂view類名是相同的。儘管遵循這個慣例不是絕對必要的，但很多有名的代碼編寫者都基於這個命名慣例來提供聲明。
一旦您定義了自訂屬性，您可以在布局XML檔案中像內建屬性一樣使用它們。唯一的不同是，您的自訂屬性屬於不同的命名空間。它們屬於  以取代預設的  命名空間。下面例子顯示如何為PieChart使用這些定義過的屬性：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:custom="http://schemas.android.com/apk/res/com.example.customviews">
 <com.example.customviews.charting.PieChart
     custom:showText="true"
     custom:labelPosition="left" />
</LinearLayout>為了避免重複使用長的命名空間URI，本例使用了一個xmlns指示符。這個指示指定了別名custom為命名空間http://schemas.android.com/apk/res/com.example.customviews 您可以為您的命名空間選擇任意的別名。

注意您用來向布局中添加自訂view的XML標籤的名字。這是自訂view類的完全表述。如果您的view內是一個內部類，您必須使用外部類的名字進一步限定它。例如，PieChart類有一個叫做PieView的內部類。為了使用這個類中的自訂屬性，您必須使用標籤com.example.customviews.charting.PieChart$PieView。

應用自訂屬性：

當view從XML布局中建立了之後，XML標籤中所有的屬性都從資源套件中讀取出來並作為一個AttributeSet傳遞給view的建構函式。儘管從AttributeSet中直接讀取值是可以的，但是這樣做有一些缺點：
帶有值的資源引用沒有進行處理樣式並沒有得到允許取而代之的是，將AttributeSet傳遞給obtainStyledAttributes()方法。這個方法傳回了一個TypedArray數組，包含了已經解除引用和樣式化的值。
為了時能能夠更容易的調用obtainStyledAttributes()方法，Android資源編譯器做了大量的工作。res檔案夾中的每個<declare-styleable>資源，產生的R.java都定義了一個屬性ID的數組以及一套定義了指向數組中的每一個屬性的常量。您可以使用預定義的常量從TypedArray中讀取屬性。下例是PieChart類是如何讀取這些屬性的：

 

public PieChart(Context ctx, AttributeSet attrs) {
   super(ctx, attrs);
   TypedArray a = context.getTheme().obtainStyledAttributes(
        attrs,
        R.styleable.PieChart,
        0, 0);

   try {
       mShowText = a.getBoolean(R.styleable.PieChart_showText, false);
       mTextPos = a.getInteger(R.styleable.PieChart_labelPosition, 0);
   } finally {
       a.recycle();
   }
}注意:TypedArray對象是一個共用的資源，使用完畢必須回收它。