文档章节

declare-styleable:自定义控件的属性

Jonson
 Jonson
发布于 2015/01/30 16:20
字数 1082
阅读 409
收藏 4

做Android布局是件很享受的事,这得益于他良好的xml方式。使用xml可以快速有效的为软件定义界面。可是有时候我们总感觉官方定义的一些基本组件不够用,自定义组件就不可避免了。那么如何才能做到像官方提供的那些组件一样用xml来定义他的属性呢?现在我们就来讨论一下他的用法。

一、在res/values文件下定义一个attrs.xml文件,代码如下:

<?xml version="1.0" encoding="utf-8"?> 
<resources> 
    <declare-styleable name="ToolBar"> 
        <attr name="buttonNum" format="integer"/> 
        <attr name="itemBackground" format="reference|color"/> 
    </declare-styleable> 
</resources>

二、在布局xml中如下使用该属性:

<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    xmlns:toolbar="http://schemas.android.com/apk/res/cn.zzm.toolbar" 
    android:orientation="vertical" 
    android:layout_width="fill_parent" 
    android:layout_height="fill_parent" 
    > 
    <cn.zzm.toolbar.ToolBar android:id="@+id/gridview_toolbar" 
        android:layout_width="fill_parent" 
        android:layout_height="wrap_content" 
        android:layout_alignParentBottom="true" 
        android:background="@drawable/control_bar" 
        android:gravity="center" 
        toolbar:buttonNum="5" 
        toolbar:itemBackground="@drawable/control_bar_item_bg"/> 
</RelativeLayout>

三、在自定义组件中,可以如下获得xml中定义的值:

TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar); 
buttonNum = a.getInt(R.styleable.ToolBar_buttonNum, 5); 
itemBg = a.getResourceId(R.styleable.ToolBar_itemBackground, -1);

a.recycle();

就这么简单的三步,即可完成对自定义属性的使用。

*********************************************************************

好了,基本用法已经讲完了,现在来看看一些注意点和知识点吧。

首先来看看attrs.xml文件。

该文件是定义属性名和格式的地方,需要用<declare-styleable name="ToolBar"></declare-styleable>包围所有属性。其中name为该属性集的名字,主要用途是标识该属性集。那在什么地方会用到呢?主要是在第三步。看到没?在获取某属性标识时,用到"R.styleable.ToolBar_buttonNum",很显然,他在每个属性前面都加了"ToolBar_"。

在来看看各种属性都有些什么类型吧:string , integer , dimension , reference , color , enum......

前面几种的声明方式都是一致的,例如:<attr name="buttonNum" format="integer"/>。 
只有enum是不同的,用法举例:

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

如果该属性可同时传两种不同的属性,则可以用“|”分割开即可。

 

让我们再来看看布局xml中需要注意的事项。

首先得声明一下:xmlns:toolbar=http://schemas.android.com/apk/res/cn.zzm.toolbar 
注意,“toolbar”可以换成其他的任何名字,后面的url地址必须最后一部分必须用上自定义组件的包名。自定义属性了,在属性名前加上“toolbar”即可。

 

最后来看看java代码中的注意事项。

在自定义组件的构造函数中,用

TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar);

来获得对属性集的引用,然后就可以用“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.使用:

1

    <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.使用:

1

    <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.使用:

1

    <rotate zkx:pivotX="200%"/>

八、fraction:百分数

1.定义:


    <declare-styleable name="My">

        <attr name="pivotX" format="fraction" />

    </declare-styleable>

2.使用:

1

    <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.使用:

1

    <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.使用:

1

    <activity android:windowSoftInputMode="stateUnspecified | adjustNothing">

属性定义时可以指定多种类型值:


    <declare-styleable name = "名称">    

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

    </declare-styleable>

使用:

1

    <ImageView android:background = "@drawable/图片ID|#00FF00"/>


本文转载自:http://blog.csdn.net/congqingbin/article/details/7

Jonson
粉丝 21
博文 131
码字总数 19433
作品 0
肇庆
私信 提问
Android 自定义属性用法详解

最近项目中经常需要用到自定义控件,因此自定义属性也是经常要用到的,在此说明一下自定义属性的用法: 自定义属性都存在于/value/attr.xml文件中,以如下格式存在。 <resource> <declare-st...

TedYin
2014/04/12
888
0
Android自定义控件以及控件属性的自定义

自定义控件在android中无处不见,自定义控件给了我们很大的方便。比如说,一个视图为imageview ,imagebutton ,textview 等诸多控件的组合,用的地方有很多,我们不可能每次都来写3个的组合,...

蜗牛崛起
2015/08/14
19
0
番外篇2:自定义View属性全解

前言 在android自定义view的过程中,偶尔会涉及到设置外部资源的问题。那么今天就来讲讲自定义view属性的问题吧。 今天涉及的知识有: 创建 attrs.xml文件及其属性讲解 在自定义view中调用及...

奔跑的佩恩
04/17
0
0
【我的Android进阶之旅】解决Android Studio在XML中使用自定义View输入自定义属性的时候没有任何提示的问题

版权声明:本文为【欧阳鹏】原创文章,欢迎转载,转载请注明出处! 【http://blog.csdn.net/ouyang_peng】 https://blog.csdn.net/qq446282412/article/details/81744295 一、问题描述 这两天...

欧阳鹏
2018/08/16
0
0
android 自定义控件 属性介绍

一、控件自定义属性介绍 以下示例中代码均在values/attrs.xml 中定义,属性均可随意命名。 1. reference:参考某一资源ID。 示例: [java] 代码如下: <declare-styleable name = "名称"> <a...

一寨之主
2014/02/10
30
0

没有更多内容

加载失败,请刷新页面

加载更多

linux负载均衡总结性说明 四层负载和七层负载有什么区别

这篇文章主要为大家详细介绍了linux负载均衡的相关资料,什么是负载均衡?四层负载和七层负载有什么区别?具有一定的参考价值,感兴趣的小伙伴们可以参考一下 在常规运维工作中,经常会运用到...

天子剑毅
7分钟前
1
0
mysql in与or效率比较

在网上一直看到的是or和in的效率没啥区别,一直也感觉是这样,前几天刚好在看《mysql数据库开发的36条军规》的文章,里面提到了or和in的效率问题,文中提到or的效率为O(n),而in的效率为O(l...

whatwhowhy
7分钟前
1
0
使用docker 基于pxc镜像搭建mysql高可用集群

前置条件 docker已安装: 第一步:拉取镜像 docker pull percona/percona-xtradb-cluster:5.7.21 第二步:复制重命名镜像(可选) docker tag percona/percona-xtradb-cluster:5.7.21 pxc 第...

小海bug
13分钟前
2
0
windows安装nginx负载均衡

第一步:下载安装nginx 地址:http://nginx.org/en/docs/windows.html 下载完成,比如放在C盘根目录下: cd c:\ unzip nginx-1.15.3.zip //解压文件 cd nginx-1.15.3 //进入目录 start ngin...

你好夜故事
16分钟前
1
0
Jenkins CLI,助你轻松管理 Jenkins

本文首发于:Jenkins 中文社区 作者:Donghui Wang Jenkins CLI,简称 jcli,一个使用 Golang 开发的开源的 Jenkins 命令行工具。 它可以帮忙你轻松地管理 Jenkins。 无论你是 Jenkins 插件开...

Jenkins中文社区
18分钟前
1
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部