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對象是一個共享的資源，使用完畢必須回收它。