自定义View之declare-styleable属性介绍

关于自定义view，相比大家已经很熟悉了。作者也是最近发现了一些好玩的自定义view时，才重新整理下这方面的知识，大部分来源于前辈们的文章。

一、需要使用xml来定义View的属性，即在res/values文件下定义一个attrs.xml文件，代码如下：

[java]  view plain  copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <resources>  
3.     <declare-styleable name="QQNaviView">  
4.         <attr name="bigIconSrc" format="reference"/>  
5.         <attr name="smallIconSrc" format="reference"/>  
6.         <attr name="iconWidth" format="dimension"/>  
7.         <attr name="iconHeight" format="dimension"/>  
8.         <attr name="range" format="float"/>  
9.     </declare-styleable>  
10. </resources  

[java]  view plain  copy

1.   

二、在布局中使用该属性：

[html]  view plain  copy

1. <com.robog.library.QQNaviView  
2.             android:id="@+id/qq_view_bubble"  
3.             android:layout_width="0dp"  
4.             android:layout_height="wrap_content"  
5.             android:layout_weight="1"  
6.             android:onClick="onClick"  
7.             android:gravity="center"  
8.             android:orientation="horizontal"  
9.             app:bigIconSrc="@drawable/pre_bubble_big"  
10.             app:smallIconSrc="@drawable/pre_bubble_small"  
11.             app:iconWidth="50dp"  
12.             app:iconHeight="50dp"  
13.             app:range="1.2">  
14.         </com.robog.library.QQNaviView>  

三、在代码中获取自定义的值：

[java]  view plain  copy

1. <span style="white-space:pre">  </span>TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.QQNaviView, defStyleAttr, 0);  
2.         mBigIconSrc = ta.getResourceId(R.styleable.QQNaviView_bigIconSrc, R.drawable.big);  
3.         mSmallIconSrc = ta.getResourceId(R.styleable.QQNaviView_smallIconSrc, R.drawable.small);  
4.         mIconWidth = ta.getDimension(R.styleable.QQNaviView_iconWidth, dp2px(context, 60));  
5.         mIconHeight = ta.getDimension(R.styleable.QQNaviView_iconHeight, dp2px(context, 60));  
6.         mRange = ta.getFloat(R.styleable.QQNaviView_range, 1);  
7.         ta.recycle();  

就这么简单的三步，即可完成对自定义属性的使用。
*********************************************************************
好了，基本用法已经讲完了，现在来看看一些注意点和知识点吧。
首先来看看attrs.xml文件。
该文件是定义属性名和格式的地方，需要用<declare-styleable name="QQNaviView"></declare-styleable>包围所有属性。其中name为该属性集的名字，主要用途是标识该属性集。那在


什么地方会用到呢？主要是在第三步。看到没？在获取某属性标识时，用到"R.styleable.QQNaviView_buttonNum"，很显然，他在每个属性前面都加了"QQNaviView_"。
在来看看各种属性都有些什么类型吧：string , integer , dimension , reference , color , enum......
前面几种的声明方式都是一致的，例如：<attr name="buttonNum" format="integer"/>。 
只有enum是不同的，用法举例：

[html]  view plain  copy

1. <attr name="testEnum">   
2.     <enum name="fill_parent" value="-1"/>   
3.     <enum name="wrap_content" value="-2"/>   
4. </attr>  

如果该属性可同时传两种不同的属性，则可以用“|”分割开即可。
 
让我们再来看看布局xml中需要注意的事项。
首先得声明一下：xmlns:toolbar=http://schemas.android.com/apk/res/com.robog.library.QQNaviView

注意，“ QQNaviView ”可以换成其他的任何名字，后面的url地址必须最后一部分必须用上自定义组件的包名。自定义属性了，在属性名前加上“ QQNaviView ”即可。
 
最后来看看java代码中的注意事项。
在自定义组件的构造函数中，用
TypedArray a = context.obtainStyledAttributes(attrs,R.styleable. QQNaviView );
来获得对属性集的引用，然后就可以用“a”的各种方法来获取相应的属性值了。这里需要注意的是，如果使用的方法和获取值的类型不对的话，则会返回默认值。因此，如果一个属


性是带两个及以上不用类型的属性，需要做多次判断，知道读取完毕后才能判断应该赋予何值。当然，在取完值的时候别忘了回收资源哦！

自定义属性数据类型简介：

一、reference：参考指定Theme中资源ID。

1.定义：
    <declare-styleable name="My">
        <attr name="label" format="reference" >
    </declare-styleable>

2.使用：
    <Buttonzkx:label="@string/label" >

二、Color：颜色

1.定义：

    <declare-styleable name="My">
        <attr name="textColor" format="color" />
    </declare-styleable>

2.使用：
    <Button zkx:textColor="#ff0000"/>

三、boolean：布尔值

1.定义：
    <declare-styleable name="My">
        <attr name="isVisible" format="boolean" />
    </declare-styleable>

2.使用：
    <Button zkx:isVisible="false"/>

四、dimension：尺寸值

1.定义：
    <declare-styleable name="My">
        <attr name="myWidth" format="dimension" />
    </declare-styleable>

2.使用：

    <Button zkx:myWidth="100dip"/>

五、float：浮点型

1.定义：
    <declare-styleable name="My">
        <attr name="fromAlpha" format="float" />
    </declare-styleable>

2.使用：
    <alpha zkx:fromAlpha="0.3"/>

六、integer：整型

1.定义：
    <declare-styleable name="My">
        <attr name="frameDuration" format="integer" />
    </declare-styleable>
2.使用：
    <animated-rotate zkx:framesCount="22"/>

七、string：字符串

1.定义：
    <declare-styleable name="My">
        <attr name="Name" format="string" />
    </declare-styleable>
2.使用：
    <rotate zkx:pivotX="200%"/>

八、fraction：百分数

1.定义：
    <declare-styleable name="My">
        <attr name="pivotX" format="fraction" />
    </declare-styleable>
2.使用：
    <rotate zkx:Name="My name is zhang kun xiang"/>

九、enum：枚举

1.定义：
    <declare-styleable name="My">
        <attr name="language">
            <enum name="English" value="1"/>
        </attr>
    </declare-styleable>
2.使用：
    <Button zkx:language="English"/>

十、flag：位或运算

1.定义：
   <declare-styleable name="My">
        <attr name="windowSoftInputMode">
    <flag name="stateUnspecified" value="1" />
    <flag name = "adjustNothing" value = "0x30" />
        </attr>
   </declare-styleable>
2.使用：
    <activity Android:windowSoftInputMode="stateUnspecified | adjustNothing">
属性定义时可以指定多种类型值：
    <declare-styleable name = "名称">    
<attr name="background" format="reference|color" />
    </declare-styleable>
使用：
    <ImageView android:background = "@drawable/图片ID|#00FF00"/>