Android自訂屬性

 

Android自訂xml中控制項屬性的學習

 

前言： 

        在做大型應用開發的過程中，為了滿足各種UI風格，必須要求自己的應用程式有一套自己統一風格的介面風格。否則援用系統的風格時，會出現意想不到的效果。

       比如：button控制項，可能在android2.3是黑底白字，android2.4是白底黑字，那麼我們在UI設計的時候就無法去設計我的介面背景到底是採用黑底還是採用白底，於是就順其自然的會想設計自己的button UI 。即就有自己開發UI控制項的情況出現。在讀android api的時候總會看到方法的參數裡有AttributeSet attrs。這個屬性參數卻不知道是幹嘛的。從網上找來一些相關資料經過整理形成了該文檔。

 

 

一、在xml 檔案裡定義控制項的屬性

       我們已經習慣了android:attrs="" ,那麼我們能不能定義自己的屬效能，比如:test:attrs="" 呢？答案是肯定的.例如：　　

　　在res/values檔案下定義一個attrs.xml檔案.代碼如下:　　

       <?xml　version="1.0"　encoding="utf-8"?>　

            <resources>　

　　　　<declare-styleable　name="MyView">　

　　　　　　　　<attr　name="textColor"　format="color"　/>　

　　　　　　　　<attr　name="textSize"　format="dimension"　/>　

　　　　</declare-styleable>　

          </resources>　　

二、在java代碼中實現構造方法

　我們在MyView.java 代碼修改如下：

public　MyView(Context　context,AttributeSet　attrs)　　

　{　　

　　super(context,attrs);　　

　　mPaint　=　new　Paint();　　

　　　　

　　TypedArray　a　=　context.obtainStyledAttributes(attrs,　　

　　　　R.styleable.MyView);　　 　　　　

　　int　textColor　=　a.getColor(R.styleable.MyView_textColor,　　

　　　　0XFFFFFFFF);　　

　　float　textSize　=　a.getDimension(R.styleable.MyView_textSize,　36);　　

　　　　

　　mPaint.setTextSize(textSize);　　

　　mPaint.setColor(textColor);　　 　　　　

　　a.recycle();　

　}　　　

 

　MyView.java 全部代碼如下:

package　com.android.tutor;　　　　　

import　android.content.Context;　　　　　

import　android.content.res.TypedArray;　　　　　

import　android.graphics.Canvas;　　　　　

import　android.graphics.Color;　　　　　

import　android.graphics.Paint;　　　　　

import　android.graphics.Rect;　　　　　

import　android.graphics.Paint.Style;　　　　　

import　android.util.AttributeSet;　　　　　

import　android.view.View;　　　　　

public　class　MyView　extends　View　{　　　　　

　　　　private　Paint　mPaint;　　　　　

　　　　private　Context　mContext;　　　　　

　　　　private　static　final　String　mString　=　"Welcome　to　Mr　Wei's　blog";　　　　　

　　　　　　　　　

　　　　public　MyView(Context　context)　{　　　　　

　　　　　　　　super(context);　　　　　

　　　　　　　　mPaint　=　new　Paint();　　　　　

　　　　}　　　　　

　　　　public　MyView(Context　context,AttributeSet　attrs)　　　　　

　　　　{　　　　　

　　　　　　　　super(context,attrs);　　　　　

　　　　　　　　mPaint　=　new　Paint();　　　　　

　　　　　　　　　　　　　

　　　　　　　　TypedArray　a　=　context.obtainStyledAttributes(attrs,　　　　　

　　　　　　　　　　　　　　　　R.styleable.MyView);　　

　　　　　　　　int　textColor　=　a.getColor(R.styleable.MyView_textColor,　　　　　

　　　　　　　　　　　　　　　　0XFFFFFFFF);　　　　　

　　　　　　　　float　textSize　=　a.getDimension(R.styleable.MyView_textSize,　36);　　　　　

　　　　　　　　　　　　　

　　　　　　　　mPaint.setTextSize(textSize);　　　　　

　　　　　　　　mPaint.setColor(textColor);　　　　

　　　　　　　　a.recycle();　　　　　

　　　　}　　　　　

　　　　@Override　　　　

　　　　protected　void　onDraw(Canvas　canvas)　{　　　　　

　　　　　　　　//　TODO　Auto-generated　method　stub　　　　　

　　　　　　　　super.onDraw(canvas);　　　　　

　　　　　　　　//設定填充　　　　　

　　　　　　　　mPaint.setStyle(Style.FILL);　　　　　

　　　　　　　　//畫一個矩形,前倆個是矩形左上方座標，後面倆個是右下角座標　　　　　

　　　　　　　　canvas.drawRect(new　Rect(10,　10,　100,　100),　mPaint);　　　

　　　　　　　　mPaint.setColor(Color.BLUE);　　　　　

　　　　　　　　//繪製文字　　　　　

　　　　　　　　canvas.drawText(mString,　10,　110,　mPaint);　　　　　

　　　　}　　　　　

}　　　 

         我們擷取定義的屬性我們R.sytleable.MyView_textColor, 擷取方法中後面通常設定預設值(float textSize = a.getDimension(R.styleable.MyView_textSize, 36 ); )， 防止我們在xml 檔案中沒有定義.從而使用預設值!擷取MyView 就是定義在<declare-styleable name="MyView "></declare-styleable> 裡的名字,擷取裡面屬性用 名字_ 屬性 ；串連起來就可以.TypedArray
；通常最後調用 .recycle() 方法，為了保持以後使用該屬性一致性！

三、引用自訂屬性

       將我們自訂的MyView 加入布局main.xml 檔案中，平且使用自訂屬性,自訂屬性必須加上:

　　xmlns:test ="http://schemas.android.com/apk/res/com.android.tutor"藍色 是自訂屬性的首碼，紅色 是我們包名.

main.xml 全部代碼如下:

<?xml　　　　

version="1.0"　encoding="utf-8"?>　　　

<LinearLayout　　　　

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

xmlns:test="http://schemas.android.com/apk/res/com.android.tutor"　　

　　　　android:orientation="vertical"　　

　　　　android:layout_width="fill_parent"　　

　　　　android:layout_height="fill_parent"　　

　　　　>　　　

<TextView　　　　　

　　　　android:layout_width="fill_parent"　　　　

　　　　android:layout_height="wrap_content"　　　　

　　　　android:text="@string/hello"　　

　　　　/>　　　

<com.android.tutor.MyView　　　

　　　　android:layout_width="fill_parent"　　　　

　　　　android:layout_height="fill_parent"　　　　

　　　　test:textSize="20px"　　

　　　　test:textColor="#fff"　　

/>　　　

</LinearLayout>　　 

 

四、Android中自訂屬性的格式詳解

1. reference：參考某一資源ID。 

   （1）屬性定義： 

            <declare-styleable name = "名稱">

                   <attr name = "background" format = "reference" />

            </declare-styleable> 

    （2）屬性使用： 

             <ImageView

                     android:layout_width = "42dip"
                     android:layout_height = "42dip"
                     android:background = "@drawable/圖片ID"

                     />

 

2. color：顏色值。 

    （1）屬性定義： 

            <declare-styleable name = "名稱">

                   <attr name = "textColor" format = "color" />

            </declare-styleable> 

    （2）屬性使用： 

            <TextView

                     android:layout_width = "42dip"
                     android:layout_height = "42dip"
                     android:textColor = "#00FF00"

                     />

 

3. boolean：布爾值。 

    （1）屬性定義： 

            <declare-styleable name = "名稱">

                   <attr name = "focusable" format = "boolean" />

            </declare-styleable> 

    （2）屬性使用： 

            <Button

                    android:layout_width = "42dip"
                    android:layout_height = "42dip"

                    android:focusable = "true"

                    />

  

4. dimension：尺寸值。 

    （1）屬性定義： 

            <declare-styleable name = "名稱">

                   <attr name = "layout_width" format = "dimension" />

            </declare-styleable> 

    （2）屬性使用： 

            <Button

                    android:layout_width = "42dip"
                    android:layout_height = "42dip"

                    />

 

5. float：浮點值。 

    （1）屬性定義： 

            <declare-styleable name = "AlphaAnimation">

                   <attr name = "fromAlpha" format = "float" />
                   <attr name = "toAlpha" format = "float" />

            </declare-styleable> 

    （2）屬性使用： 

            <alpha
                   android:fromAlpha = "1.0"
                   android:toAlpha = "0.7"

                   />

 

6. integer：整型值。 

    （1）屬性定義： 

            <declare-styleable name = "AnimatedRotateDrawable">

                   <attr name = "visible" />
                   <attr name = "frameDuration" format="integer" />
                   <attr name = "framesCount" format="integer" />
                   <attr name = "pivotX" />
                   <attr name = "pivotY" />
                   <attr name = "drawable" />

            </declare-styleable> 

    （2）屬性使用： 

            <animated-rotate

                   xmlns:android = "http://schemas.android.com/apk/res/android" 
                   android:drawable = "@drawable/圖片ID" 
                   android:pivotX = "50%" 
                   android:pivotY = "50%" 
                   android:framesCount = "12" 
                   android:frameDuration = "100"             /> 

 

7. string：字串。 

   （1）屬性定義： 

            <declare-styleable name = "MapView">
                   <attr name = "apiKey" format = "string" />
            </declare-styleable> 

    （2）屬性使用： 

            <com.google.android.maps.MapView
                    android:layout_width = "fill_parent"
                    android:layout_height = "fill_parent"
                    android:apiKey = "0jOkQ80oD1JL9C6HAja99uGXCRiS2CGjKO_bc_g"

                    /> 

 

8. fraction：百分數。 

    （1）屬性定義： 

            <declare-styleable name="RotateDrawable">
                   <attr name = "visible" />
                   <attr name = "fromDegrees" format = "float" />
                   <attr name = "toDegrees" format = "float" />
                   <attr name = "pivotX" format = "fraction" />
                   <attr name = "pivotY" format = "fraction" />
                   <attr name = "drawable" />
            </declare-styleable> 

    （2）屬性使用： 

            <rotate

                   xmlns:android = "http://schemas.android.com/apk/res/android"
　　             android:interpolator = "@anim/動畫ID"

                   android:fromDegrees = "0"
　　             android:toDegrees = "360"

                   android:pivotX = "200%"

                   android:pivotY = "300%"
　　             android:duration = "5000"

                   android:repeatMode = "restart"

                   android:repeatCount = "infinite"

                   />

 

9. enum：枚舉值。 

    （1）屬性定義： 

            <declare-styleable name="名稱">
                   <attr name="orientation">
                          <enum name="horizontal" value="0" />
                          <enum name="vertical" value="1" />
                   </attr>            

            </declare-styleable> 

    （2）屬性使用： 

            <LinearLayout

                    xmlns:android = "http://schemas.android.com/apk/res/android"
                    android:orientation = "vertical"
                    android:layout_width = "fill_parent"
                    android:layout_height = "fill_parent"
                    >
            </LinearLayout> 

10. flag：位或運算。 

     （1）屬性定義： 

             <declare-styleable name="名稱">
                    <attr name="windowSoftInputMode">
                            <flag name = "stateUnspecified" value = "0" />
                            <flag name = "stateUnchanged" value = "1" />
                            <flag name = "stateHidden" value = "2" />
                            <flag name = "stateAlwaysHidden" value = "3" />
                            <flag name = "stateVisible" value = "4" />
                            <flag name = "stateAlwaysVisible" value = "5" />
                            <flag name = "adjustUnspecified" value = "0x00" />
                            <flag name = "adjustResize" value = "0x10" />
                            <flag name = "adjustPan" value = "0x20" />
                            <flag name = "adjustNothing" value = "0x30" />
                     </attr>         

             </declare-styleable>

     （2）屬性使用： 

            <activity

                   android:name = ".StyleAndThemeActivity"
                   android:label = "@string/app_name"
                   android:windowSoftInputMode = "stateUnspecified | stateUnchanged　|　stateHidden">
                   <intent-filter>
                          <action android:name = "android.intent.action.MAIN" />
                          <category android:name = "android.intent.category.LAUNCHER" />
                   </intent-filter>
             </activity>

 

     注意： 

     屬性定義時可以指定多種類型值。 

    （1）屬性定義： 

            <declare-styleable name = "名稱">

                   <attr name = "background" format = "reference|color" />

            </declare-styleable> 

    （2）屬性使用： 

             <ImageView

                     android:layout_width = "42dip"
                     android:layout_height = "42dip"
                     android:background = "@drawable/圖片ID|#00FF00"

                     />

 

五、參考資料 

　　1 . http://weizhulin.blog.51cto.com/1556324/311453

        2 .

http://blog.csdn.net/mayingcai1987/article/details/6216655