Android中ClipDrawable的使用

介绍

ClipDrawable是通过设置一个Drawable的当前显示比例来裁剪出另一张Drawable,你可以通过调节这个比例来控制裁剪的宽高,以及裁剪内容占整个容器的权重,通过ClipDrawable的setLevel()方法调节显示比例可以实现类似Progress进度条的效果。ClipDrawable的level值范围在[0,10000],level的值越大裁剪的内容越少,如果level为10000时则完全显示。

语法

下面来看一个ClipDrawable的示例文件clip.xml:

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

通过上面的示例我们来介绍一下他们几个属性:
1、android:drawable;表示该ClipDrawable引用的drawable资源(这个属性必须有)。
2、android:clipOrientation;表示裁剪的方向。horizontal:水平方向,vertical:垂直方向。
3、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配合使用,不同的组合,裁剪的效果也不同。

示例

下面我写了一个简单的Demo来测试一下它的效果,其中包括以下文件:
布局文件activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"    
  android:layout_height="match_parent">    
    <ImageView        
      android:id="@+id/image"        
      android:layout_width="wrap_content"        
      android:layout_height="wrap_content"        
      android:layout_centerInParent="true"        
      android:src="@drawable/clip"/>
</RelativeLayout>

处理文件MainActivity.java:

public class MainActivity extends Activity {    
  private Timer timer;    
  private TimerTask timerTask;    
  private ClipDrawable clipDrawable;    
  private Handler handler = new Handler(){        
    @Override        
    public void handleMessage(Message msg) {            
     clipDrawable.setLevel(msg.what);        
    }    
  };    

  @Override    
  protected void onCreate(Bundle savedInstanceState) {        
    super.onCreate(savedInstanceState);        
    setContentView(R.layout.activity_main);      

    ImageView imageview = (ImageView) findViewById(R.id.image);        
    clipDrawable = (ClipDrawable) imageview.getDrawable();        
    clipDrawable.setLevel(0);   
 
    timer = new Timer();        
    timerTask = new TimerTask() {            
      @Override            
      public void run() {                
        if (clipDrawable.getLevel() <= 10000){
          handler.sendEmptyMessage(clipDrawable.getLevel() + 50);                
        }else {                    
          if (timer != null) {                        
            timer.cancel();                        
            timer.purge();                        
            timer = null;                    
          }                
        }            
      }        
    };        
    timer.schedule(timerTask, 1000, 50);    
  }    

  @Override    
  protected void onDestroy() {        
    super.onDestroy();        
    if (timer != null) {            
      timer.cancel();            
      timer.purge();            
      timer = null;        
    }    
  }
}

上述代码主要是定义了一个定时器每50毫秒执行一次,同时修改ClipDrawable的setLevel()的值,直到其值到达10000则取消这个计时器,这个时候就可以看到一张图片一点点的展开。这个在我看来在制作某些进度条、水波等的时候还是挺有用的。下面是运行的效果图,当然你也可以换一张更好看的图。

example.gif

至此我的介绍就结束了,欢迎大家吐槽!

推荐阅读更多精彩内容