原文地址:http://mypyg.iteye.com/blog/968646
目标:实现textview和ImageButton组合,可以通过Xml设置自定义控件的属性。
1.控件布局:以Linearlayout为根布局,一个TextView,一个ImageButton。
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- android:layout_width="fill_parent" android:layout_height="fill_parent"
- android:gravity="center_vertical">
- <TextView android:layout_height="wrap_content" android:id="@+id/text1"
- android:layout_width="wrap_content"></TextView>
- <ImageButton android:layout_width="wrap_content"
- android:layout_height="wrap_content" android:id="@+id/btn1"></ImageButton>
- </LinearLayout>
2.自定义控件代码,从LinearLayout继承:
- public class ImageBtnWithText extends LinearLayout {
- public ImageBtnWithText(Context context) {
- this(context, null);
- }
- public ImageBtnWithText(Context context, AttributeSet attrs) {
- super(context, attrs);
- LayoutInflater.from(context).inflate(R.layout.imagebtn_with_text, this, true);
- }
- }
在构造函数中将Xml中定义的布局解析出来。
PS:有时执行此句代码时eclipse会输出找不到资源,而无法预览自定义控件。经试验确定是新增的布局没有生成资源,但是clean project重新生成也不行,最后重启eclipse解决。
3.在主界面布局xml中使用自定义控件:
- <com.demo.widget2.ImageBtnWithText
- android:id="@+id/widget"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent" />
即使用完整的自定义控件类路径:com.demo.widget2.ImageBtnWithText定义一个元素。
运行可以看到控件已经能够被加载到界面上。
4.给按钮设置图片和文本
如果图片是固定不变的,那么直接在控件布局中设置ImageButton的src属性即可。
4.1通过Java代码设置,在控件代码中提供函数接口:
- public void setButtonImageResource(int resId) {
- mBtn.setImageResource(resId);
- }
- public void setTextViewText(String text) {
- mTv.setText(text);
- }
然后再在主界面的onCreate()通过函数调用设置即可。
4.2通过Xml设置属性
4.2.1首先定义Xml可以设置的属性集合,在values下创建attrs.xml,文件名可随意,一般都叫attrs.xml
- <?xml version="1.0" encoding="utf-8"?>
- <resources>
- <declare-styleable name="ImageBtnWithText">
- <attr name="android:text"/>
- <attr name="android:src"/>
- </declare-styleable>
- </resources
属性集合名字:ImageBtnWithText,自己可根据实际来定义;
集合中包含的属性列表,每行一个属性。
4.2.2修改自定义控件实现代码,以获取xml中定义的属性
- TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.ImageBtnWithText);
- CharSequence text = a.getText(R.styleable.ImageBtnWithText_android_text);
- if(text != null) mTv.setText(text);
- Drawable drawable = a.getDrawable(R.styleable.ImageBtnWithText_android_src);
- if(drawable != null) mBtn.setImageDrawable(drawable);
- a.recycle()
首先通过context.obtainStyledAttributes获得所有属性数组;
然后通过TypedArray类的getXXXX()系列接口获得相应的值。
4.2.3在主界面布局中设置自定义控件的属
android:text="ABC" android:src="@drawable/icon
4.3自定义名称属性:
在4.2中使用的属性名是android系统命名空间的,都以android开头,比如android:text等。
实际开发中会自定义一些属性名,这些属性名仍然定义在4.2.1提到的attrs.xml中:
4.3.1定义属性名
- <attr name="appendText" format="string"/>
和直接使用系统的attr不同的是要增加一个format属性,说明此属性是什么格式的。format可选项可参见注1
4.3.2使用自定义属性
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- xmlns:myspace="http://schemas.android.com/apk/res/com.demo.customwidget"
- android:orientation="vertical" android:layout_width="fill_parent"
- android:layout_height="fill_parent">
- <com.demo.widget2.ImageBtnWithText
- android:text="ABC" android:src="@drawable/icon" android:id="@+id/widget"
- android:layout_width="fill_parent" android:layout_gravity="center"
- android:layout_height="fill_parent" myspace:appendText="123456">
- </com.demo.widget2.ImageBtnWithText>
- </LinearLayout>
直接在主布局文件中使用此属性appendText="abc"是不会设置生效的,而是要在主布局xml中定义一个xml命名空间:
xmlns:myspace="http://schemas.android.com/apk/res/com.demo.customwidget"
命名空间的名字可以自己随便定义,此处为myspace,即xmlns:myspace;
后面的地址则有限制,其开始必须为:"http://schemas.android.com/apk/res/",后面则是包名com.demo.customwidget,
此处的包名与AndroidManifest.xml中<manifest>节点的属性package="com.demo.customwidget"一致,不是自定义控件Java代码所在的包,当然简单的程序自定义控件Java代码也一般在此包内。
注1:
注1:format可选项
"reference" //引用
"color" //颜色
"boolean" //布尔值
"dimension" //尺寸值
"float" //浮点值
"integer" //整型值
"string" //字符串
"fraction" //百分数,比如200%
枚举值,格式如下:
<attr name="orientation">
<enum name="horizontal" value="0" />
<enum name="vertical" value="1" />
</attr>
xml中使用时:
android:orientation = "vertical"
标志位,位或运算,格式如下:
<attr name="windowSoftInputMode">
<flag name = "stateUnspecified" value = "0" />
<flag name = "stateUnchanged" value = "1" />
<flag name = "stateHidden" value = "2" />
<flag name = "stateAlwaysHidden" value = "3" />
<flag name = "stateVisible" value = "4" />
<flag name = "stateAlwaysVisible" value = "5" />
<flag name = "adjustUnspecified" value = "0x00" />
<flag name = "adjustResize" value = "0x10" />
<flag name = "adjustPan" value = "0x20" />
<flag name = "adjustNothing" value = "0x30" />
</attr>
xml中使用时:
android:windowSoftInputMode = "stateUnspecified | stateUnchanged | stateHidden">
另外属性定义时可以指定多种类型值,比如:
<attr name = "background" format = "reference|color" />
xml中使用时:
android:background = "@drawable/图片ID|#00FF00"