Android自定义组合控件【转】

http://dev.10086.cn/cmdn/wiki/index.php?doc-view-5787.html


目标：实现textview和ImageButton组合，可以通过Xml设置自定义控件的属性。

　　1.控件布局：以Linearlayout为根布局，一个TextView，一个ImageButton。

　　Xml代码 收藏代码

　　 < ?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>

　　< ?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继承：

　　Java代码 收藏代码

　　 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);

     }

　　 }

　　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中定义的布局解析出来。

　　3.在主界面布局xml中使用自定义控件：

　　Xml代码 收藏代码

　　 < com.demo.widget2.ImageBtnWithText

　　 android:id="@+id/widget"

　　 android:layout_width="fill_parent"

　　 android:layout_height="fill_parent" />

　　< 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代码设置，在控件代码中提供函数接口：

　　Java代码 收藏代码

　　 public void setButtonImageResource(int resId) {

　　 mBtn.setImageResource(resId);

　　 }

　　

　　 public void setTextViewText(String text) {

　　 mTv.setText(text);

　　 }

　　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代码 收藏代码

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

　 < resources>

　　 < declare-styleable name="ImageBtnWithText">

　　 < attr name="android:text"/>

　　 < attr name="android:src"/>

　　 < /declare-styleable>

　　 < /resources

　　< ?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中定义的属性

　　Java代码 收藏代码

　　 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()

　　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定义属性名

　　Xml代码 收藏代码

　　 < attr name="appendText" format="string"/>

　　< attr name="appendText" format="string"/>

　　和直接使用系统的attr不同的是要增加一个format属性，说明此属性是什么格式的。format可选项可参见注1

　　4.3.2使用自定义属性

　　Xml代码 收藏代码

　　 < ?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>

　　< ?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"