Android Drawable Resource學習（九）、ClipDrawable

ClipDrawable 是對一個Drawable進行剪下操作，可以控制這個drawable的剪下地區，以及相相對於容器的對齊，android中的進度條就是使用一個ClipDrawable實現效果的，它根據level的屬性值，決定剪下地區的大小。

        需要注意的是ClipDrawable是根據level的大小控製圖片剪下操作的，官方文檔的note中提到：The drawable is clipped completely and not visible when the level is 0 and fully revealed when the level is 10,000。也就是level的大小從0到10000，level為0時完全不顯示，為10000時完全顯示。是用Drawable提供的setLevel（int level）方法來設定剪下地區。

檔案位置：

res/drawable/filename.xml
檔案名稱即資源ID

編譯資源類型：

指向 ClipDrawable的指標

資源引用：

In Java: R.drawable.filename
In XML: @[package:]drawable/filename

文法

<?xml version="1.0" encoding="utf-8"?><clip    xmlns:android="http://schemas.android.com/apk/res/android"    android:drawable="@drawable/drawable_resource"    android:clipOrientation=["horizontal" | "vertical"]    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |                     "fill_vertical" | "center_horizontal" | "fill_horizontal" |                     "center" | "fill" | "clip_vertical" | "clip_horizontal"] />

元素：

<clip>

定義這是個ClipDrawable，必須作為根項目。

屬性：

xmlns:android

String類型。必須的，定義XML檔案的命名空間，必須是 "http://schemas.android.com/apk/res/android".

android:drawable

Drawable資源。 必須的。表示該ClipDrawable引用的drawable資源。

android:clipOrientation

關鍵字。 裁剪的方向。

必須是下面兩種的數值之一：

值	描述
horizontal	水平方向裁剪
vertical	垂直方向裁剪

android:gravity

關鍵字。指定從哪個地方裁剪。

必須是下面一個或多個值（多個值之間用“|”分隔）：

值	描述
top	將這個對象放在容器的頂部，不改變其大小。當clipOrientation 是"vertical"，裁剪髮生在drawable的底部（bottom）
bottom	將這個對象放在容器的底部，不改變其大小。當clipOrientation 是 "vertical"，裁剪髮生在drawable的頂部（top）
left	將這個對象放在容器的左部，不改變其大小。當clipOrientation 是 "horizontal"，裁剪髮生在drawable的右邊（right）。預設的是這種情況。
right	將這個對象放在容器的右部，不改變其大小。當clipOrientation 是 "horizontal"，裁剪髮生在drawable的左邊（left）。
center_vertical	將對象放在垂直中間，不改變其大小。裁剪的情況和”center“一樣。
fill_vertical	垂直方向上不發生裁剪。（除非drawable的level是 0，才會不可見，表示全部裁剪完）
center_horizontal	將對象放在水平中間，不改變其大小。裁剪的情況和”center“一樣。
fill_horizontal	水平方向上不發生裁剪。（除非drawable的level是 0，才會不可見，表示全部裁剪完）
center	將這個對象放在水平垂直座標的中間，不改變其大小。當clipOrientation 是 "horizontal"裁剪髮生在左右。當clipOrientation是"vertical",裁剪髮生在上下。
fill	填充整個容器，不會發生裁剪。(除非drawable的level是 0，才會不可見，表示全部裁剪完)。
clip_vertical	額外的選項，它能夠把它的容器的上下邊界，設定為子物件的上下邊緣的裁剪邊界。裁剪要基於對象垂直重力設定：如果重力設定為top，則裁剪下邊，如果設定為bottom，則裁剪上邊，否則則上下兩邊都要裁剪。
clip_horizontal	額外的選項，它能夠把它的容器的左右邊界，設定為子物件的左右邊緣的裁剪邊界。裁剪要基於對象垂直重力設定：如果重力設定為right，則裁剪左邊，如果設定為left，則裁剪右邊，否則則左右兩邊都要裁剪。

樣本：

檔案儲存在 res/drawable/clip.xml：

<?xml version="1.0" encoding="utf-8"?><clip xmlns:android="http://schemas.android.com/apk/res/android"    android:drawable="@drawable/android"    android:clipOrientation="horizontal"    android:gravity="left" />

在layout   xml檔案中使用：

<ImageView    android:id="@+id/image"    android:background="@drawable/clip"    android:layout_height="wrap_content"    android:layout_width="wrap_content" />

下面的代碼或得到clipDrawable對象，並且增加裁剪區逐步顯示圖片：

ImageView imageview = (ImageView) findViewById(R.id.image);ClipDrawable drawable = (ClipDrawable) imageview.getDrawable();drawable.setLevel(drawable.getLevel() + 1000);

逐步增加裁剪地區，逐步顯示圖片。這個裁剪區是7000：

注意：預設的level是0，表示全部裁剪掉了，圖片不可見，但是顯示的時候，依然會佔據位置。當level是10,000，圖片相當於沒裁剪，完全可見。

參考：

• ClipDrawable