android clip

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

轉自:http://blog.csdn.net/lonelyroamer/article/details/8244777