Canvas的clipRect方法

clipRect方法：设置裁剪区


【功能说明】该方法用于裁剪画布，也就是设置画布的显示区域。在使用时，可以使用Rect对象来指定裁剪区，也可以通过指定矩形的4条边来指定裁剪区。该方法主要用于部分显示以及对画布中的部分对象进行操作的场合。


【基本语法】clipRect方法有如下几种形式：


public boolean clipRect (Rect rect)


public boolean clipRect (float left, float top, float right, float bottom)


public boolean clipRect (int left, int top, int right, int bottom)


参数说明


rect：Rect对象，用于定义裁剪区的范围。


left：矩形裁剪区的左边位置，可以是浮点型或者整型。


top：矩形裁剪区的上边位置，可以是浮点型或者整型。


right：矩形裁剪区的右边位置，可以是浮点型或者整型。


bottom：矩形裁剪区的下边位置，可以是浮点型或者整型。


【实例演示】下面通过代码来演示如何设置画笔的显示区域。


protected void onDraw(Canvas canvas) {  
    // TODO Auto-generated method stub  
    super.onDraw(canvas);  
    paint.setAntiAlias(true);                           //设置画笔为无锯齿  
    paint.setColor(Color.BLACK);                        //设置画笔颜色  
    paint.setTextSize((float) 30.0);                    //设置字体大小  
 
    canvas.clipRect(100, 100, 350, 600);                //设置显示范围  
    canvas.drawColor(Color.WHITE);                      //白色背景  
    canvas.drawText("Hello Android!", 150, 300, paint); //绘制字符串  
}  
在这段代码中，首先设置了画笔的颜色和字体大小，然后通过clipRect方法设置了显示范围，并通过drawColor方法设置背景颜色为白色。
最后，调用drawText方法在画布上绘制字符串。
读者运行这段代码，可以在手机屏幕上看到如图8.25所示的显示效果。
通过这个程序发现，白色区域是画布的区域。但绘制操作是针对整个屏幕的，处于显示区域之外的将不显示。