自定义View构造函数参数理解

最新推荐文章于 2022-08-23 15:50:10 发布

swust_chenpeng

最新推荐文章于 2022-08-23 15:50:10 发布

阅读量4.2k

点赞数 7

分类专栏： Android android开发

本文链接：https://blog.csdn.net/swust_chenpeng/article/details/48577049

版权

Android 同时被 2 个专栏收录

92 篇文章 0 订阅

订阅专栏

android开发

2 篇文章 0 订阅

订阅专栏

View自定义的属性时的流程

通过<declare-styleable>为自定义View添加属性
在运行时(一般为构造函数)获取属性值
获取到得属性值并应用到View

自定义View的属性和Style

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

    <declare-styleable name="Customize">
        <attr name="attr_one" format="string" />
        <attr name="attr_two" format="string" />
        <attr name="attr_three" format="string" />
        <attr name="attr_four" format="string" />
    </declare-styleable>

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

</resources>

上述的attrs.xml中我们声明了Customize与CustomizeStyle，其中Customize包含了attr_one、attr_two、attr_three与attr_four四个attribute，CustomizeStyle也是一个attribute，但是没有声明在declare-styleable中。
定义在declare-styleable中与直接用attr定义没有实质上的不同，上述attrs.xml中，无论attr_one~attr_four是否声明在declare-styleable中，系统都会为我们在R.attr中生成5个attribute。
attr class：

public static final class attr {
        public static final int CustomizeStyle = 2130771968;
        public static final int attr_four = 2130771972;
        public static final int attr_one = 2130771969;
        public static final int attr_three = 2130771971;
        public static final int attr_two = 2130771970;

        public attr() {
        }
    }

不同的是，如果在declare-styleable中，系统还会为我们在R.styleable中生成相关的属性。
styleable class：

public static final class styleable {
        public static final int[] Customize = new int[]{2130771969, 2130771970, 2130771971, 2130771972};
        public static final int Customize_attr_four = 3;
        public static final int Customize_attr_one = 0;
        public static final int Customize_attr_three = 2;
        public static final int Customize_attr_two = 1;

        public styleable() {
        }
    }

如上所示，R.styleable.Customize是一个int[]，里面的元素的值正好与R.attr.attr_one~ R.attr.attr_four相对应，而R.styleabe.Customize_attr_one等4个值就是R.attr.attr_one~R.attr.attr_four在R.styleable.Customize数组中的索引。这个数组和索引在下面运行时获得索性值时会用到，将attr分组在declare-styleable中的作用就是系统会自动为我们生成这些东西，如果不声明在declare-styleabe中，我们完全可以在需要的时候自己构建这个数组，由于数组是自己构建的，每个属性的下标索引也就很清楚了，只是比较麻烦。

在xml中为相应地属性声明属性值

在xml中为属性赋值的几种不同方式

直接在layout中使用属性
在xml layout中使用自定义属性与使用系统属性差不多，不过属性所属的namespace不同。

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:ad="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <com.angeldevil.customstyle.CustomTextView
        style="@style/ThroughStyle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello_world"
        ad:attr_one="attr one in xml" />

</RelativeLayout>

像layout_width等属性属于android的namespace，自定义的属性属于当前程序的namespace，只需要像声明android的namespace一样声明当前程序的namespace就好，只需要把android换成res-auto，应用属性的时候也需要注意属性的namespace。
2. 设置style并在style中设置属性
在上面xml中，我们为CustomTextView声明了一个style：ThroughStyle，这个Style很简单，只是指定了两个属性的值

<style name="ThroughStyle">
        <item name="attr_one">attr one from style</item>
        <item name="attr_two">attr two from style</item>
        <item name="android:text">text123</item>
    </style>

注意，在style中我们声明了attr_one的值，同时在xml中也直接像attr_one赋了值，最终用哪一个，有个优先级的问题，后面会在运行时获取属性值中在说。
3. theme中指定在当前Application或Activity中属性的默认值

<!-- Application theme. -->
    <style name="AppTheme" parent="AppBaseTheme">

        <!-- All customizations that are NOT specific to a particular API-level can go here. -->
        <item name="attr_one">attr one from theme</item>
        <item name="attr_two">attr two from theme</item>
        <item name="attr_three">attr three from theme</item>
        <item name="CustomizeStyle">@style/CustomizeStyleInTheme</item>
    </style>

    <style name="CustomizeStyleInTheme">
        <item name="attr_one">attr one from theme reference</item>
        <item name="attr_two">attr two from theme reference</item>
        <item name="attr_three">attr three from theme reference</item>
    </style>

在上述xml中，我们在AppTheme中为attr_one、attr_two与attr_three指定了值，但是同时也为CustomizeStyle指定了一个reference，而在这个reference中也为attr_one、attr_two与attr_three指定了值，CustomizeStyle就是我们之前在attrs.xml中定义的一个属性。在theme中为属性设置值的方式有两种，直接在theme中定义或通过另一个attribute引用一个style，这两种方式还是有区别的，我们可以在下面的获取属性值中可以看到。

在运行时获取属性值

在styles.xml中，我们同时定义一个DefaultCustomizeStyle的style，它的作用等下可以看到。

    <style name="DefaultCustomizeStyle">
        <item name="attr_one">attr one from defalut style res</item>
        <item name="attr_two">attr two from defalut style res</item>
        <item name="attr_three">attr three from defalut style res</item>
        <item name="attr_four">attr four from defalut style res</item>
    </style>

先看下CustomTextView的代码

public class CustomTextView extends TextView {

    private static final String TAG = CustomTextView.class.getSimpleName();

    public CustomTextView(Context context) {
        super(context);
    }

    public CustomTextView(Context context, AttributeSet attrs) {
        this(context, attrs, R.attr.CustomizeStyle);
    }

    public CustomTextView(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);

        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.Customize, defStyle,
                R.style.DefaultCustomizeStyle);
        String one = a.getString(R.styleable.Customize_attr_one);
        String two = a.getString(R.styleable.Customize_attr_two);
        String three = a.getString(R.styleable.Customize_attr_three);
        String four = a.getString(R.styleable.Customize_attr_four);
        Log.i(TAG, "one:" + one);
        Log.i(TAG, "two:" + two);
        Log.i(TAG, "three:" + three);
        Log.i(TAG, "four:" + four);
        a.recycle();
    }
}

主要的代码都在第三个函数中，这里也没做什么，只是通过Context的obtainStyledAttributes获得了前面定义的4个属性的值并打印了出来。

View的第三个构造函数的第三个参数defStyle

如果在Code中实例化一个View会调用第一个构造函数，如果在xml中定义会调用第二个构造函数，而第三个函数系统是不调用的，要由View（我们自定义的或系统预定义的View，如此处的CustomTextView和Button）显示调用，比如在这里我们在第二个构造函数中调用了第三个构造函数，并将R.attr.CustomizeStyle传给了第三个参数。
第三个参数的意义就如同它的名字所说，是默认的Style，只是这里没有说清楚，这里的默认Style是指他在当前Application或Activity所用的Theme中的默认Style，以系统中的Button为例说明。

public Button(Context context) {
        this(context, null);
    }

    public Button(Context context, AttributeSet attrs) {
        this(context, attrs, com.android.internal.R.attr.buttonStyle);
    }

    public Button(Context context, AttributeSet attrs, int defStyleAttr) {
        this(context, attrs, defStyleAttr, 0);
    }

在Code中实例化View会调用第一个构造函数，在XML中定义会调用第二个构造函数，在Button的实现中都调用了第三个构造函数，并且defStyle的值是com.android.internal.R.attr.buttonStyle。buttonStyle是系统中定义的一个attribute，系统默认有一个Theme，比如4.0中是Theme.Holo。

下面是系统默认的Theme，为buttonStyle指定了一个Style

<style name="Widget.DeviceDefault.Button" parent="Widget.Holo.Button" >
</style>

<style name="Widget.Holo.Button" parent="Widget.Button">
<item name="android:background">@android:drawable/btn_default_holo_dark</item>
    <item name="android:textAppearance">?android:attr/textAppearanceMedium</item>
    <item name="android:textColor">@android:color/primary_text_holo_dark</item>
    <item name="android:minHeight">48dip</item>
    <item name="android:minWidth">64dip</item>
</style>

这个Style定义了系统中Button的默认属性，如background等。
从文档中第三个构造函数的说明中也可以看到，这个构造函数的作用是View的子类提供这个类的基础样式

View(Context context, AttributeSet attrs, int defStyleAttr)
Perform inflation from XML and apply a class-specific base style.

上面说的都比较抽象，还是直接看实例代码来的清楚明白，实验用的代码上面全都贴完了，这里直接看结果，但在这之前要先看一个函数：obtainStyledAtributes。
obtainStyledAtributes。

我们要获取的属性值都是通过这个函数返回的TypedArray获得的，这是官方说明：obtainStyledAttributes，以下是函数原型：

public TypedArray obtainStyledAttributes (AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)

4个参数的意思分别是：

set：属性值的集合
attrs：我们要获取的属性的资源ID的一个数组，如同ContextProvider中请求数据库时的Projection数组，就是从一堆属性中我们希望查询什么属性的值
defStyleAttr：这个是当前Theme中的一个attribute，是指向style的一个引用，当在layout xml中和style中都没有为View指定属性时，会从Theme中这个attribute指向的Style中查找相应的属性值，这就是defStyle的意思，如果没有指定属性值，就用这个值，所以是默认值，但这个attribute要在Theme中指定，且是指向一个Style的引用，如果这个参数传入0表示不向Theme中搜索默认值
defStyleRes：这个也是指向一个Style的资源ID，但是仅在defStyleAttr为0或defStyleAttr不为0但Theme中没有为defStyleAttr(在这个例子中：定义的reference：CustomizeStyle)属性赋值时起作用

链接中对这个函数说明勉强过得去，这里简要概括一下。对于一个属性可以在多个地方指定它的值，如XML中指定，style，Theme，而这些位置定义的值有一个优先级，按优先级从高到低依次是：

直接在XML中定义 > xml中style定义 > 由defStyleAttr和defStyleRes指定的默认值 > 直接在Theme中指定的值（不是style，只是theme中定义的attr_one, attr_two…）

看这个关系式就比较明白了，defStyleAttr和defStyleRes在前面的参数说明中已经说了，“直接在Theme中指定的值”的意思在下面的示代码中可以看到。

在Code中是这样获取属性的

public CustomTextView(Context context, AttributeSet attrs) {
    this(context, attrs, R.attr.CustomizeStyle);
}

public CustomTextView(Context context, AttributeSet attrs, int defStyle) {
    super(context, attrs, defStyle);

    TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.Customize, defStyle,
                R.style.DefaultCustomizeStyle);
    ...
}

从代码中可以看到，R.attr.CustomizeStyle就是前面提到的defStyleAttr，R.style.DefaultCustomizeStyle就是defStyleRes。

在Styles.xml中我们为App定义了一个Theme：AppTheme，在这个Theme中直接为attr_one、attr_two、attr_three定义了属性值，这个就是前面关系式中说的直接在Theme中指定的值。

我们回到顶部最初的代码片段，在AppTheme中同时定义了CustomizeStyle，引用了一个Style，在CustomTextView的构造函数中分别打印了attr_one、attr_two、attr_three、attr_four的值，所以下面我们就可以通过Log输出验证一下前面的关系式，如果一个attribute在多个位置都定义了值，究竟哪一个起作用。
如上图所示：

attr_one同时在xml、style、defStyleAttr、defStyleRes与Theme中直接定义了值，但起作用的是在xml中的定义
attr_two同时在style、defStyleAttr、defStyleRes与Theme中直接定义了值，但起用的是在style中的定义
attr_three同时在defStyleAttr、defStyleRes与Theme中直接定义了值，但起作用的是defStyleAttr
attr_four在defStyleRes中定了，但结果仍然是0。
这可以说明：

直接在XML中定义 > style定义 > 由defStyleAttr定义的值 > defStyleRes指定的默认值、直接在Theme中指定的值
defStyleAttr（即defStyle）不为0且在当前Theme中可以找到这个attribute的定义时，defStyleRes不起作用，所以attr_four虽然在defStyleRes（DefaultCustomizeStyle）中定义了，但取到的值仍为null
为了看一下defStyleRes的作用，1. 我们在AppTheme中加上attr_four的定义，2. 向obtainStyledAttributes的第三个参数传入0，或者移除AppTheme中CustomizeStyle的定义，结果是一样的

<style name="AppTheme" parent="AppBaseTheme">
    <item name="attr_one">attr one from theme</item>
    <item name="attr_two">attr two from theme</item>
    <item name="attr_three">attr three from theme</item>
    <item name="attr_four">attr four from theme</item>
</style>

由于defStyleAttr为0，或者defStyleAttr不为0但是我们没有为这个属性赋值，所以defStyleRes起作用，当一个属性没有在XML和Style中赋值时，系统会在defStyleRes（此处为DefaultCustomizeStyle）查找属性的值。

我们看到attr_three的值来自defStyleRes，而attr_four的值来自Theme中的直接定义（DefaultCustomizeStyle定义了attr_one、atrr_two、attr_three），这就说明

defStyleAttr即defStyle为0或Theme中没有定义defStyle时，defStyleRes才起作用
defStyleRes > 在Theme中直接定义

结论

要为自定义View自定义属性，可以通过declare-styleable声明需要的属性
为了在Theme设置View的默认样式，可以同时定义一个format为reference的属性att_style，在定义Theme时为这个attribute指定一个Style，并且在View的第二个构造函数中将R.attr.attr_style 作为第三个参数调用第三个构造函数
可以定义一个Style作为Theme中没有定义attr_style时View属性的默认值。
可以在Theme中直接为属性赋值，但优先级最低
当defStyleAttr（即View的构造函数的第三个参数）不为0且在Theme中有为这个attr_style赋值时，defStyleRes（通过obtainStyledAttributes的第四个参数指定）不起作用
属性值定义的优先级：xml > xml style属性 > Theme中的默认Sytle > 默认Style（通过obtainStyledAttributes的第四个参数指定）> 在Theme中直接指定属性值

swust_chenpeng

关注

7
点赞
踩
5

收藏

觉得还不错? 一键收藏
1
评论
自定义View构造函数参数理解

自定义的属性使用1、通过&lt;declare-styleable&gt;为自定义View添加属性 2、在xml中为相应的属性值 3、在运行时(一般为构造函数)获取属性值 4、将获取到得属性值应用到View自定义Style&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;&lt;resources&gt; &lt;declare-
复制链接

扫一扫