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,图片相当于没裁剪,完全可见。
参考: