Android Drawable之ClipDrawable

最新推荐文章于 2021-05-28 14:58:25 发布

收复火星

最新推荐文章于 2021-05-28 14:58:25 发布

阅读量268

点赞数

分类专栏： Android

Android 专栏收录该内容

67 篇文章 0 订阅

订阅专栏

Overview

ClipDrawable可以根据设置的level值和方向对当前Drawable剪切后显示。它根据level的属性值，决定剪切区域的大小，level的取值范围从0到10000，level为0时完全不显示，为10000时完全显示。(The drawable is clipped completely and not visible when the level is 0 and fully revealed when the level is 10,000。)
ClipDrawable常用来实现进度条，通过设置不同的level显示不同的进度。

创建和使用

在xml文件中使用<clip>作为根节点定义ClipDrawable
语法：

<?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"] />
 
 1
2
3
4
5
6
7
8
 
 1
2
3
4
5
6
7
8

元素：
<clip>定义这是个ClipDrawable，必须作为根元素。

android:drawable Drawable资源。必须。表示该ClipDrawable引用的drawable资源。
android:clipOrientation 裁剪的方向。 horizontal:水平方向 vertical:垂直方向
android:gravity 指定从哪个地方裁剪。必须是下面一个或多个值（多个值之间用”|”分隔）
- top 将这个对象放在容器的顶部，不改变其大小，当clipOrientation 是”vertical”，从底部(bottom)开始裁剪
- bottom 将这个对象放在容器的底部，不改变其大小。当clipOrientation 是 “vertical”，从顶部(top)开始裁剪
- left 将这个对象放在容器的左部，不改变其大小。当clipOrientation 是 “horizontal”，从右边（right）开始裁剪。这也是默认情况。
- right 将这个对象放在容器的右部，不改变其大小。当clipOrientation 是 “horizontal”，从左边（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，则裁剪右边，否则则左右两边都要裁剪。
android:gravity需要和android:clipOrientation配合使用，不同的组合，裁剪的效果也不同。

示例：
文件保存在 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" />
 
 1
2
3
4
5
 
 1
2
3
4
5

在layout xml文件中使用：

<ImageView
    android:id="@+id/image"
    android:background="@drawable/clip"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />
 
 1
2
3
4
5
 
 1
2
3
4
5

下面的代码实现了从左到右逐渐显示完整图片的功能：

public class MainActivity extends Activity {
    private ImageView imageview;
    private ClipDrawable drawable;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTheme(android.R.style.Theme_NoTitleBar_Fullscreen);
        setContentView(R.layout.activity_main);
        imageview = (ImageView) findViewById(R.id.image);
        drawable = (ClipDrawable) imageview.getDrawable();
        mHandler.post(mRunnable);
    }
    private Handler mHandler = new Handler(new Handler.Callback() {
        @Override
        public boolean handleMessage(Message msg) {
            if (msg.what == 0x01) {
                drawable.setLevel(drawable.getLevel() + 200);
            }
            return true;
        }
    });
    private Runnable mRunnable = new Runnable() {
        @Override
        public void run() {
            if (drawable.getLevel() >= 10000) {
                mHandler.removeCallbacks(mRunnable);
            } else {
                mHandler.postDelayed(mRunnable, 200);
            }
            mHandler.sendEmptyMessage(0x01);
        }
    };
}
 
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33