android自定義控制項命名空間

『壹』 如何在android style文件中使用自定義屬性

在android style文件中使用自定義屬性是為了方便，只需要這里寫一次就可以在布局文件中多次調用，使用方法如下圖：

1、首先使用android studio打開一個項目，如下圖：

『貳』 android自定義控制項，一般遵循什麼樣的原則

開發自定義控制項的步驟:
1、了解View的工作原理
2、 編寫繼承自View的子類
3、 為自定義View類增加屬性
4、 繪制控制項
5、 響應用戶消息
6 、自定義回調函數

一、View結構原理
Android系統的視圖結構的設計也採用了組合模式，即View作為所有圖形的基類，Viewgroup對View繼承擴展為視圖容器類。

View定義了繪圖的基本操作
基本操作由三個函數完成：measure()、layout()、draw()，其內部又分別包含了onMeasure()、onLayout()、onDraw()三個子方法。具體操作如下：
1、measure操作
measure操作主要用於計算視圖的大小，即視圖的寬度和長度。在view中定義為final類型，要求子類不能修改。measure()函數中又會調用下面的函數：
（1）onMeasure()，視圖大小的將在這里最終確定，也就是說measure只是對onMeasure的一個包裝，子類可以覆寫onMeasure()方法實現自己的計算視圖大小的方式，並通過setMeasuredDimension(width, height)保存計算結果。

2、layout操作
layout操作用於設置視圖在屏幕中顯示的位置。在view中定義為final類型，要求子類不能修改。layout()函數中有兩個基本操作：
（1）setFrame（l,t,r,b），l,t,r,b即子視圖在父視圖中的具體位置，該函數用於將這些參數保存起來；
（2）onLayout()，在View中這個函數什麼都不會做，提供該函數主要是為viewGroup類型布局子視圖用的；

3、draw操作
draw操作利用前兩部得到的參數，將視圖顯示在屏幕上，到這里也就完成了整個的視圖繪制工作。子類也不應該修改該方法，因為其內部定義了繪圖的基本操作：
（1）繪制背景；
（2）如果要視圖顯示漸變框，這里會做一些准備工作；
（3）繪制視圖本身，即調用onDraw()函數。在view中onDraw()是個空函數，也就是說具體的視圖都要覆寫該函數來實現自己的顯示（比如TextView在這里實現了繪制文字的過程）。而對於ViewGroup則不需要實現該函數，因為作為容器是「沒有內容「的，其包含了多個子view，而子View已經實現了自己的繪制方法，因此只需要告訴子view繪制自己就可以了，也就是下面的dispatchDraw()方法;
（4）繪制子視圖，即dispatchDraw()函數。在view中這是個空函數，具體的視圖不需要實現該方法，它是專門為容器類准備的，也就是容器類必須實現該方法；
（5）如果需要（應用程序調用了setVerticalFadingEdge或者setHorizontalFadingEdge），開始繪制漸變框；
（6）繪制滾動條；
從上面可以看出自定義View需要最少覆寫onMeasure()和onDraw()兩個方法。

二、View類的構造方法

創建自定義控制項的3種主要實現方式:
1）繼承已有的控制項來實現自定義控制項: 主要是當要實現的控制項和已有的控制項在很多方面比較類似, 通過對已有控制項的擴展來滿足要求。
2）通過繼承一個布局文件實現自定義控制項，一般來說做組合控制項時可以通過這個方式來實現。
注意此時不用onDraw方法，在構造廣告中通過inflater載入自定義控制項的布局文件，再addView(view)，自定義控制項的圖形界面就載入進來了。
3）通過繼承view類來實現自定義控制項，使用GDI繪制出組件界面，一般無法通過上述兩種方式來實現時用該方式。

View(Context context)
Simple constructor to use when creating a view from code.
View(Context context, AttributeSet attrs)
Constructor that is called when inflating a view from XML.
View(Context context, AttributeSet attrs, int defStyle)
Perform inflation from XML and apply a class-specific base style.

三、自定義View增加屬性的兩種方法：
1）在View類中定義。通過構造函數中引入的AttributeSet 去查找XML布局的屬性名稱，然後找到它對應引用的資源ID去找值。
案例：實現一個帶文字的圖片（圖片、文字是onDraw方法重繪實現）

public class MyView extends View {

private String mtext;
private int msrc;

public MyView(Context context) {
super(context);
// TODO Auto-generated constructor stub
}

public MyView(Context context, AttributeSet attrs) {
super(context, attrs);
// TODO Auto-generated constructor stub
int resourceId = 0;

int textId = attrs.getAttributeResourceValue(null, "Text",0);
int srcId = attrs.getAttributeResourceValue(null, "Src", 0);

mtext = context.getResources().getText(textId).toString();

msrc = srcId;

}

@Override
protected void onDraw(Canvas canvas) {
// TODO Auto-generated method stub

Paint paint = new Paint();
paint.setColor(Color.RED);
InputStream is = getResources().openRawResource(msrc);

Bitmap mBitmap = BitmapFactory.decodeStream(is);

int bh = mBitmap.getHeight();
int bw = mBitmap.getWidth();

canvas.drawBitmap(mBitmap, 0,0, paint);

//canvas.drawCircle(40, 90, 15, paint);
canvas.drawText(mtext, bw/2, 30, paint);
}

}

布局文件：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >

<com.example.myimageview2.MyView
android:id="@+id/myView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
Text="@string/hello_world"
Src="@drawable/xh"/>

</LinearLayout>

屬性Text, Src在自定義View類的構造方法中讀取。

2）通過XML為View注冊屬性。與Android提供的標准屬性寫法一樣。
案例: 實現一個帶文字說明的ImageView (ImageView+TextView組合，文字說明，可在布局文件中設置位置)

public class MyImageView extends LinearLayout {

public MyImageView(Context context) {
super(context);
// TODO Auto-generated constructor stub
}

public MyImageView(Context context, AttributeSet attrs) {
super(context, attrs);
// TODO Auto-generated constructor stub
int resourceId = -1;
TypedArray typedArray = context.obtainStyledAttributes(attrs,
R.styleable.MyImageView);
ImageView iv = new ImageView(context);
TextView tv = new TextView(context);

int N = typedArray.getIndexCount();
for (int i = 0; i < N; i++) {
int attr = typedArray.getIndex(i);

switch (attr) {
case R.styleable.MyImageView_Oriental:
resourceId = typedArray.getInt(
R.styleable.MyImageView_Oriental, 0);
this.setOrientation(resourceId == 1 ? LinearLayout.HORIZONTAL
: LinearLayout.VERTICAL);
break;

case R.styleable.MyImageView_Text:
resourceId = typedArray.getResourceId(
R.styleable.MyImageView_Text, 0);
tv.setText(resourceId > 0 ? typedArray.getResources().getText(
resourceId) : typedArray
.getString(R.styleable.MyImageView_Text));
break;

case R.styleable.MyImageView_Src:
resourceId = typedArray.getResourceId(
R.styleable.MyImageView_Src, 0);
iv.setImageResource(resourceId > 0 ?resourceId:R.drawable.ic_launcher);

break;

}

}

addView(iv);
addView(tv);
typedArray.recycle();

}

}

attrs.xml進行屬性聲明， 文件放在values目錄下
<?xml version="1.0" encoding="utf-8"?>
<resources>

<declare-styleable name="MyImageView">
<attr name="Text" format="reference|string"></attr>
<attr name="Oriental" >
<enum name="Horizontal" value="1"></enum>
<enum name="Vertical" value="0"></enum>
</attr>
<attr name="Src" format="reference|integer"></attr>
</declare-styleable>

</resources>

MainActivity的布局文件：先定義命名空間 xmlns:uview="http://schemas.android.com/apk/res/com.example.myimageview2"
然後可以像使用系統的屬性一樣使用：uview:Oriental="Vertical"

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:uview="http://schemas.android.com/apk/res/com.example.myimageview2"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context=".MainActivity" >

<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/hello_world" />

<com.example.myimageview2.MyImageView
android:id="@+id/myImageView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
uview:Text="這是一個圖片說明"
uview:Src="@drawable/tw"
uview:Oriental="Vertical">
</com.example.myimageview2.MyImageView>

</LinearLayout>

四、控制項繪制 onDraw()

五、

六、自定義View的方法
onFinishInflate() 回調方法，當應用從XML載入該組件並用它構建界面之後調用的方法
onMeasure() 檢測View組件及其子組件的大小
onLayout() 當該組件需要分配其子組件的位置、大小時
onSizeChange() 當該組件的大小被改變時
onDraw() 當組件將要繪制它的內容時
onKeyDown 當按下某個鍵盤時
onKeyUp 當松開某個鍵盤時
onTrackballEvent 當發生軌跡球事件時
onTouchEvent 當發生觸屏事件時
onWindowFocusChanged(boolean) 當該組件得到、失去焦點時
onAtrrachedToWindow() 當把該組件放入到某個窗口時
onDetachedFromWindow() 當把該組件從某個窗口上分離時觸發的方法
onWindowVisibilityChanged(int): 當包含該組件的窗口的可見性發生改變時觸發的方法

『叄』 Android自定義屬性TypedArray詳解

大家好，我是程序員雙木L，後續會發專題類的文章，這是自定義控制項的第一篇，之後也會陸續更新相關的文章，歡迎關注。

自定義屬性在自定義控制項過程中屬於比較常見的操作，我們可以回想一下這樣的場景：自定義view的過程中，我們需要在不同的情況下設置不同的文字大小，那麼我們是不是就需要提供對外的方法來設置，這樣就比較靈活操作。而我們自定義對外的方法，就是我們自定義的屬性啦，那我們來分析一下其原理及作用。

下面我們根據例子來進行分析：

1、首先我們需要在res->values目錄下新建attrs.xml文件，該文件就是用來聲明屬性名及其接受的數據格式的，如下：

attr名詞解析：

name表示屬性名，上面的屬性名是我自己定義的。

format表示接受的輸入格式，format格式集合如下：

2、自定義屬性的使用，這里我們使用兩種方式進行對比解析

最最最原始的使用方式

(1)、自定義文件如下：

我們可以在TestAttrsView方法的參數AttributeSet是個xml解析工具類，幫助我們從布局的xml里提取屬性名和屬性值。

(2)、在布局文件xml中的使用

這里使用自定義屬性需要聲明xml的命名空間，其中app是命名空間，用來加在自定義屬性前面。

xmlns:app=" http://schemas.android.com/apk/res-auto "
聲明xml命名空間，xmlns意思為「xml namespace」.冒號後面是給這個引用起的別名。
schemas是xml文檔的兩種約束文件其中的一種，規定了xml中有哪些元素(標簽)、
元素有哪些屬性及各元素的關系，當然從面向對象的角度理解schemas文件可以
認為它是被約束的xml文檔的「類」或稱為「模板」。

(3)、將屬性名與屬性值列印結果如下：

從列印結果我們可以看出，AttributeSet將布局文件xml下的屬性全部列印出來了，細心的童鞋可能已經看出來：

這個屬性我們設置的是一個整數尺寸，可最後列印出來的是資源編號。

那如果我們想要輸出我們設置的整數尺寸，需要怎麼操作呢？

這個時候就該我們這篇的主角出場了，使用TypedArray方式。

(1)、這里我們需要將attrs.xml使用「declare-styleable」標簽進行改造，如下：

從改造後的attrs文件可以看出，我們將屬性聲明歸結到TestStyleable裡面，也就意味著這些屬性是屬於TestStyleable下的。

(2)、屬性的解析：

這里我直接列印出解析結果，這里可以獲取我們想要的自定義屬性，而系統有的屬性可以忽略。

(3)、運行結果如下

從解析的結果可以看出，尺寸的結果已經轉換為實際值了:

這個時候有童鞋又問了，我設置的是15dp，為啥最後列印是41.25了呢？其實解析出來的值單位是px，所以這里輸出的是轉換後的值。

解析的過程中用到了這個方法：

我們來看一下這個方法的源碼：

源碼中我們可以看到這個方法有兩個參數：

obtainStyledAttributes方法返回值類型為TypedArray。該類型記錄了獲取到的屬性值集合，而通過數組下標索引即可找到對應的屬性值。索引下標通過R.styleable.TestStyleable_xx獲取，"xx"表示屬性名，一般命名為"styleable名" + "_" + "屬性名"。

而TypedArray提供了各種Api，如getInteger，getString，getDimension等方法來獲取屬性值，這些方法都需要傳入對應屬性名在obtainStyledAttributes中的int數組的位置索引，通過下標獲取數組里屬性值。

這個TypedArray的作用就是資源的映射作用，把自定義屬性在xml設置值映射到class，這樣怎麼獲取都很簡單啦。

到這里就分析完啦！

『肆』 android中xml中有些控制項的屬性裡面有 "app:.." ，此處的app:是什麼意思和一般的android:有什麼區別

xmlns:Android=」http://schemas.android.com/apk/res/android」

xmlns:app=」http://schemas.android.com/apk/res-auto」

xmlns:cutstom="http://schemas.android.com/apk/res/com.example.customview"

android 和 app 都是xml 裡面的命名空間，android 是系統默認的，app是自定義的，你改成其它名字也可以，常用於自定義控制項的自定義屬性，res-auto會自動查找項目下的自定義屬性，也可以在後面跟上包名

--------------------
<?xmlversion="1.0"encoding="utf-8"?>
<resources>
<!--這里的name跟xmlns裡面的app沒關系,只是在自定義view裡面通過這個取自定義屬性-->
<declare-styleablename="CustomText">
<attrname="tsize"format="dimension"/>
<attrname="tcolor"format="color"/>
</declare-styleable>
</resources>
---------------------
xmlns:app=」http://schemas.android.com/apk/res-auto」

<com.example.customview.CustomTextView
app:tsize="5dp"
android:text="123"
>
</com.example.customview.CustomTextView>