Android中attr自定义属性详解控件自定义

1.自定义属性格式

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

    <declare-styleable name="MyButton">
              <attr name="attr1" />
              <attr name="attr2" format="dimension" />
     </declare-styleable>

    <declare-styleable name="MyButton1">
              <attr name="attr1" />
              <attr name="attr3" format="dimension" />
     </declare-styleable>

</resources>

生成的R.java中的内容
public static final class attr {
public static final int attr1=0x7f01000f;
public static final int attr2=0x7f01001f;

public static final int attr3=0x7f01002f;

}

public static final class styleable {
public static final int[] MyButton = {
0x7f01000f, 0x7f01001f
};

public static final int MyButton_attr1 = 0;
public static final int MyButton_attr2 = 1;

public static final int[] MyButton1 = {
0x7f01000f, 0x7f01002f
};

public static final int MyButton1_attr1 = 0;
public static final int MyButton1_attr3= 1;

}

attr子元素:

定义具体的属性,format表示这个属性的值的类型,类型有以下几种:
1.reference:参考指定Theme中资源ID,这个类型意思就是你传的值可以是引用资源
2.string:字符串,如果你想别人既能直接写值也可以用类似"@string/test"引用资源的方式,可以写

成format="string|reference"
     3.Color：颜色
     4.boolean：布尔值
     5.dimension：尺寸值
     6.float：浮点型
     7.integer：整型
     8.fraction：百分数
     9.enum：枚举 ,如果你提供的属性只能让别人选择,不能随便传入,就可以写成这样
        <attr name="language">
                   <enum name="china" value="1"/>
                   <enum name="English" value="2"/>
            </attr>
     10.flag：位或运算

declare-styleable子元素:

定义一个styleable对象,每个styleable对象就是一组attr属性的集合注意:这里的name属性并不是一定

要和自定义类名相同,只是为了好区分对应类的属性而已。多个declare-styleable公用属性要抽出不然会报重复定义。

注意:上面的属性资源文件定义了该属性之后，至于到底是哪个自定义View组件中来使用该属性,该属性到

底能发挥什么作用, 就不归该属性资源文件管了,也就是说这个属性资源文件是个公共的,大家都可以用，

但是为了方便管理，一般都是一个自定义View里的属性写成一个declare-styleable集合.属性资源所定义

的属性到底可以返回什么作用,取决于自定义组件的代码实现。从生成的R文件也能发现这个规律。

2.xml中使用
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:textbutton="http://schemas.android.com/apk/res/com.easymorse.textbutton"
    android:orientation="vertical" android:layout_width="fill_parent"
    android:layout_height="fill_parent" android:background="@drawable/background_color">

        <com.easymorse.textbutton.MyButton
            android:layout_width="fill_parent" android:layout_height="fill_parent"
            textbutton:attr1="#ff0000
     textbutton:attr1="10dp"/>

</LinearLayout>

这里在根标签中增加了：
xmlns:textbutton=http://schemas.android.com/apk/res/com.easymorse.textbutton
声明了textbutton这个名字空间，textbutton是任意的名称，自己可以随便起名，后面的：
http://schemas.android.com/apk/res/是固定的。再后面接的是应用的包名。

在下面自定义按钮中的：textbutton:attr1，就是使用attr1这个变量了，给变量赋值。

3.代码中获得属性值
public MyButton(final Context context, AttributeSet attrs) {
    this(context, attrs, 0);
    TypedArray typedArray=context.obtainStyledAttributes(attrs, R.styleable.button);
    int attr2=typedArray.getDimensionPixelSize(R.styleable.MyButton_attr2, 15);
    typedArray.recycle();
}

这样就取得了attr2的在xml中的值，让后可以程序中应用。

obtainStyledAttributes参数说明

我们在自定义View 时，一般都会用到

TypedArray obtainStyledAttributes(

AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)；对于它的前面2个参数可能大家都知道，对于后面两个参数一直不明白怎么用。

于是今天查了下。

context obtainStyledAttributes 最终会调到Resources.Theme.obtainStyledAttributes(AttributeSet set,
int[] attrs, int defStyleAttr, int defStyleRes)

再看一下参数解释：

         * @param set The base set of attribute values. May be null.
   * @param attrs The desired attributes to be retrieved.
         * @param defStyleAttr An attribute in the current theme that contains a
         *                     reference to a style resource that supplies
         *                     defaults values for the TypedArray. Can be
         *                     0 to not look for defaults.
         * @param defStyleRes A resource identifier of a style resource that
         *                    supplies default values for the TypedArray,
         *                    used only if defStyleAttr is 0 or can not be found
         *                    in the theme. Can be 0 to not look for defaults.

defStyleAttr 指向当前theme 某个item 描述的style 该style指定了一些默认值为这个TypedArray

defStyleRes 当defStyleAttr 找不到或者为0，可以直接指定某个style

不是很理解，搜了一下源码：

发现用的地方不多。如CalendarView

TypedArray attributesArray = context.obtainStyledAttributes(attrs, R.styleable.CalendarView,
R.attr.calendarViewStyle, 0)；

CalendarView 在 attrs.xml 中定义如下：

<declare-styleable name="CalendarView">
        
        <attr name="firstDayOfWeek" format="integer" />
        
        <attr name="showWeekNumber" format="boolean" />
        
        <attr name="minDate" />
        
        <attr name="maxDate" />
        
        <attr name="shownWeekCount" format="integer"/>
        
        <attr name="selectedWeekBackgroundColor" format="color|reference" />
        
        <attr name="focusedMonthDateColor" format="color|reference" />
        
        <attr name="unfocusedMonthDateColor" format="color|reference" />
        
        <attr name="weekNumberColor" format="color|reference" />
        
        <attr name="weekSeparatorLineColor" format="color|reference" />
        
        <attr name="selectedDateVerticalBar" format="reference" />
        
        <attr name="weekDayTextAppearance" format="reference" />
        
        <attr name="dateTextAppearance" format="reference" />
    </declare-styleable>

默认 defStyleAttr 为 calendarViewStyle

也定义在attrs.xml

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

再看看在theme.xml 中它指向：

<!-- CalendarView style--Defalut>
<item name="calendarViewStyle">@style/Widget.CalendarView</item>

。。。。

<!-- CalendarView style--Holo>
<item name="calendarViewStyle">@style/Widget.Holo.CalendarView</item>

。。。

<!-- CalendarView style-HOLOLight->
<item name="calendarViewStyle">@style/Widget.Holo.Light.CalendarView</item>

不同的theme 指向不同的style

如style.xml 中的

指定了CalendarView 的atrrs 中的一些默认值。

自此我们明白了defStyleAttr的用法。如果某个stylable 定义了一些item ，但是使用者并不一定对所有的item 在xml 使用时设置。我们需要给他设定一些默认值

这些值可以在不同的theme 中不一样。

defStyleRes 使用则更简单。可以直接某个style, 当defStyleAttr不起作用时。

Android中attr自定义属性详解 控件自定义

猜你喜欢

Android中attr自定义属性详解控件自定义