Android(安卓)中自定义控件和属性(attr.xml,declare-styleable,TypedArray)的方法和使用
分类:Android 2011-04-23 12:16 14502人阅读 评论(9) 收藏 举报 android layout encoding xml reference integer
目录(?)[+]
今天我们的教程是根据前面一节扩展进行的,如果你没有看,请点击Android高手进阶教程(三)查看第三课,这样跟容易方便你的理解!
在xml文件里定义控件的属性,我们已经习惯了android:attrs="",那么我们能不能定义自己的属性能,比如:test:attrs=""呢?答案是肯定的.
进入主题。大致以下步骤:
一、在res/values文件下定义一个attrs.xml文件.代码如下:
- <?xmlversion="1.0"encoding="utf-8"?>
- <resources>
- <declare-styleablename="MyView">
- <attrname="textColor"format="color"/>
- <attrname="textSize"format="dimension"/>
- </declare-styleable>
- </resources>
二、我们在MyView.java代码编写如下,其中下面的构造方法是重点,我们获取定义的属性R.sytleable.MyView_textColor,获取方法中后面通常设定默认值(float textSize = a.getDimension(R.styleable.MyView_textSize,36);),防止我们在xml文件中没有定义.从而使用默认值!
MyView就是定义在<declare-styleable name="MyView"></declare-styleable>里的 名字,获取里面属性用名字_ 属性连接起来就可以.TypedArray通常最后调用.recycle()方法,为了保持以后使用该属性一致性!
- publicMyView(Contextcontext,AttributeSetattrs)
- {
- super(context,attrs);
- mPaint=newPaint();
- TypedArraya=context.obtainStyledAttributes(attrs,
- R.styleable.MyView);
- inttextColor=a.getColor(R.styleable.MyView_textColor,
- 0XFFFFFFFF);
- floattextSize=a.getDimension(R.styleable.MyView_textSize,36);
- mPaint.setTextSize(textSize);
- mPaint.setColor(textColor);
- a.recycle();
- }
MyView.javaMyView控件全部代码如下:
- packagecom.android.tutor;
- importandroid.content.Context;
- importandroid.content.res.TypedArray;
- importandroid.graphics.Canvas;
- importandroid.graphics.Color;
- importandroid.graphics.Paint;
- importandroid.graphics.Rect;
- importandroid.graphics.Paint.Style;
- importandroid.util.AttributeSet;
- importandroid.view.View;
- publicclassMyViewextendsView{
- privatePaintmPaint;
- privateContextmContext;
- privatestaticfinalStringmString="WelcometoMrWei'sblog";
- publicMyView(Contextcontext){
- super(context);
- mPaint=newPaint();
- }
- publicMyView(Contextcontext,AttributeSetattrs)
- {
- super(context,attrs);
- mPaint=newPaint();
- TypedArraya=context.obtainStyledAttributes(attrs,
- R.styleable.MyView);
- inttextColor=a.getColor(R.styleable.MyView_textColor,
- 0XFFFFFFFF);
- floattextSize=a.getDimension(R.styleable.MyView_textSize,36);
- mPaint.setTextSize(textSize);
- mPaint.setColor(textColor);
- a.recycle();
- }
- @Override
- protectedvoidonDraw(Canvascanvas){
- //TODOAuto-generatedmethodstub
- super.onDraw(canvas);
- //设置填充
- mPaint.setStyle(Style.FILL);
- //画一个矩形,前俩个是矩形左上角坐标,后面俩个是右下角坐标
- canvas.drawRect(newRect(10,10,100,100),mPaint);
- mPaint.setColor(Color.BLUE);
- //绘制文字
- canvas.drawText(mString,10,110,mPaint);
- }
- }
三、将我们自定义的MyView加入布局main.xml文件中,并且使用自定义属性,自定义属性必须加上:
"xmlns:test="http://schemas.android.com/apk/res/com.android.tutor" ,test是自定义属性的前缀, 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 自定义View 己经不是什么新鲜话题,Android Api提供了一大堆基础组件给我们,需要什么特定功能还需要我们继承它们然后定制更加丰富的功能。前面有篇文章也说过为自定义VIEW添加属性,但只是一笔带过,这里就拿这点来说说吧。
第一种添加属性的方法,之前我也是经常使用这种写法,代码如下:
packagecom.terry.attrs;importandroid.content.Context;
importandroid.util.AttributeSet;
importandroid.widget.EditText;
importandroid.widget.LinearLayout;
importandroid.widget.TextView;
publicclassEditTextExt1extendsLinearLayout{
privateStringText="";
publicEditTextExt1(Contextcontext){
this(context,null);
//TODOAuto-generatedconstructorstub
}
publicEditTextExt1(Contextcontext,AttributeSetattrs){
super(context,attrs);
//TODOAuto-generatedconstructorstub
intresouceId=-1;
TextViewtv=newTextView(context);
EditTextet=newEditText(context);
resouceId=attrs.getAttributeResourceValue(null,"Text",0);
if(resouceId>0){
Text=context.getResources().getText(resouceId).toString();
}else{
Text="";
}
tv.setText(Text);
addView(tv);
addView(et,newLinearLayout.LayoutParams(LayoutParams.FILL_PARENT,
LayoutParams.WRAP_CONTENT));
this.setGravity(LinearLayout.VERTICAL);
}
}
这种写法,简单明了,不需要额外XML的配置,就可以在我们的VIEW文件下使用。
以上代码通过构造函数中引入的AttributeSet 去查找XML布局的属性名称,然后找到它对应引用的资源ID去找值。使用也时分方便。所以一直以来我也是很喜欢这种写法。
如上,自定好VIEW文件就可以在XML布局下如此使用:
<com.terry.attrs.EditTextExt1android:id="@+id/ss3"android:layout_width="wrap_content"android:layout_height="wrap_content"
Text="@string/app_name"></com.terry.attrs.EditTextExt1>
好了,这是第一种为VIEW注册属性的写法,比较简单就不多介绍。
下面是第二为VIEW注册属性的写法,这里也要重点说说第二种注册 属性的写法和使用要点,先看一下JAVA代码要如何编写:
packagecom.terry.attrs;importandroid.content.Context;
importandroid.content.res.TypedArray;
importandroid.util.AttributeSet;
importandroid.widget.EditText;
importandroid.widget.LinearLayout;
importandroid.widget.TextView;
publicclassEditTextExtextendsLinearLayout{
publicEditTextExt(Contextcontext){
this(context,null);
//TODOAuto-generatedconstructorstub
}
publicEditTextExt(Contextcontext,AttributeSetattrs){
super(context,attrs);
//TODOAuto-generatedconstructorstub
intresouceId=-1;
TypedArraytypeArray=context.obtainStyledAttributes(attrs,
R.styleable.EditTextExt);
TextViewtv=newTextView(context);
EditTextet=newEditText(context);
intN=typeArray.getIndexCount();
for(inti=0;i<N;i++){
intattr=typeArray.getIndex(i);
switch(attr){
caseR.styleable.EditTextExt_Oriental:
resouceId=typeArray.getInt(R.styleable.EditTextExt_Oriental,
0);
this.setOrientation(resouceId==1?LinearLayout.HORIZONTAL
:LinearLayout.VERTICAL);
break;
caseR.styleable.EditTextExt_Text:
resouceId=typeArray.getResourceId(
R.styleable.EditTextExt_Text,0);
tv.setText(resouceId>0?typeArray.getResources().getText(
resouceId):typeArray
.getString(R.styleable.EditTextExt_Text));
break;
}
}
addView(tv);
addView(et);
typeArray.recycle();
}
}
如上代码,跟前面代码一样。还是用的一个EDITTEXT和TEXTVIEW做基础组件。下面我们一步步分析上面的代码:
R.styleable.EditTextExt 代码的是一个attrs指向的一个declare-styleable 的标签,如下代码:
<?xmlversion="1.0"encoding="UTF-8"?><resources>
<declare-styleablename="EditTextExt">
<attrname="Text"format="reference|string"></attr>
<attrname="Oriental">
<enumname="Horizontal"value="1"></enum>
<enumname="Vertical"value="0"></enum>
</attr>
</declare-styleable>
</resources>
这个文件位于,values下的attrs.xml目录下面,我比较喜欢一个自定义View 对应一个declare-styleable标签。
Tip:一个自定义View 第一部分的代码,
TypedArraytypeArray=context.obtainStyledAttributes(attrs,R.styleable.EditTextExt);
指定为一个declare-styleable,而在declare-styleable 下的attr (即各属性)Android 的ADT 将会自动生成为declare-styleable的name 名字加上“_”加上对应attr(即属性名称)的名称,如上(EditTextExt_Text)我们要得到Text 就需要R.styleable.EditTextExt_Text,这一点的话可以看看R.java生成文件:
publicstaticfinalclassstyleable{/**AttributesthatcanbeusedwithaEditTextExt.
<p>Includesthefollowingattributes:</p>
<table>
<colgroupalign="left"/>
<colgroupalign="left"/>
<tr><th>Attribute</th><th>Description</th></tr>
<tr><td><code>{@link#EditTextExt_Orientalcom.terry.attrs:Oriental}</code></td><td></td></tr>
<tr><td><code>{@link#EditTextExt_Textcom.terry.attrs:Text}</code></td><td></td></tr>
</table>
@see#EditTextExt_Oriental
@see#EditTextExt_Text
*/
publicstaticfinalint[]EditTextExt={
0x7f010000,0x7f010001
};
/**
<p>Thissymbolistheoffsetwherethe{@linkcom.terry.attrs.R.attr#Oriental}
attribute'svaluecanbefoundinthe{@link#EditTextExt}array.
<p>Mustbeoneofthefollowingconstantvalues.</p>
<table>
<colgroupalign="left"/>
<colgroupalign="left"/>
<colgroupalign="left"/>
<tr><th>Constant</th><th>Value</th><th>Description</th></tr>
<tr><td><code>Horizontal</code></td><td>1</td><td></td></tr>
<tr><td><code>Vertical</code></td><td>0</td><td></td></tr>
</table>
@attrnameandroid:Oriental
*/
publicstaticfinalintEditTextExt_Oriental=1;
/**
<p>Thissymbolistheoffsetwherethe{@linkcom.terry.attrs.R.attr#Text}
attribute'svaluecanbefoundinthe{@link#EditTextExt}array.
<p>Maybeareferencetoanotherresource,intheform"<code>@[+][<i>package</i>:]<i>type</i>:<i>name</i></code>"
ortoathemeattributeintheform"<code>?[<i>package</i>:][<i>type</i>:]<i>name</i></code>".
<p>Maybeastringvalue,using'//;'toescapecharacterssuchas'//n'or'//uxxxx'foraunicodecharacter.
@attrnameandroid:Text
*/
publicstaticfinalintEditTextExt_Text=0;
};
好了,上述的代码写完,我们要在XML布局如何使用呢?这个会跟Android 提供的基础组件的使用方法是一致的。首先,我们要为其提供一个引用包名如下:
xmlns:android="http://schemas.android.com/apk/res/android"xmlns:terry="http://schemas.android.com/apk/res/com.terry.attrs"
上面提供的是android 基础组件的包名,和我们自己组件的包名。
写好了包名。就可以像使用andriod 基础组件一样使用了,如下全部XML布局源码:
<?xmlversion="1.0"encoding="utf-8"?><LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
xmlns:terry="http://schemas.android.com/apk/res/com.terry.attrs"
android:orientation="vertical"android:layout_width="fill_parent"
android:layout_height="fill_parent">
<TextViewandroid:layout_width="fill_parent"
android:layout_height="wrap_content"android:text="@string/hello"/>
<com.terry.attrs.EditTextExtandroid:id="@+id/ss"
android:layout_width="fill_parent"android:layout_height="wrap_content"
terry:Text="fdsafda"terry:Oriental="Vertical"></com.terry.attrs.EditTextExt>
<com.terry.attrs.EditTextExt1android:id="@+id/ss3"
android:layout_width="wrap_content"android:layout_height="wrap_content"
Text="@string/app_name"></com.terry.attrs.EditTextExt1>
</LinearLayout>
运行效果如下:
这是这两种为Android 注册 属性的使用方法,那么两者有什么区别呢?
在这里我认为起码有五点,大家可以找找看还有什么区别:
- 第二种可以编译时报错,如果编程人员随便输入什么第一种是不会报错的,第二种可以支持代码检测功能。
- 第二种写法,跟Android 属性标准写法是一致的,而且可以统一书法规则。
- 第二种写法,可以支持数据格式的验证,比如我们在attrs上注明只支持integer 那么就不可以使用字符串,这是第一种达不到的。
- 第二种写法,可以为VIEW提供选择操作,比如如上我们使用的ENUM让VIEW对应的属性支持ENUM列表,或者为其提供BOOL等只有双项选择的操作。
- 第一种写法,所有的属性必须是引用自资源(不大确定,如果朋友有什么好的DEMO麻烦共享),第二种写法,可以即支持引用资源又可以直接输入做操作,为编程带来更多的方便性。
种种都说明,第二种写法更具规范性,功能更性,代码编写 也更优雅,但个人有个人的使用习惯,我两种都喜欢用,具体看需求吧。呵呵。。。
更多相关文章
- 详解android:scaleType属性
- Android应用实例之----基于Service与ContentProvider的音乐播放
- Android(安卓)EditText按下输入法软件的enter按键,实现跳到下一个
- andorid padding margin
- 我眼中的Android(安卓)IDE
- Android(安卓)L添加kk版的OOBE开机向导
- 05Android(安卓)Studio使用插件推荐
- Android(安卓)Configuration属性解析
- 基于ffmpeg的Android播放器开源代码