ClipDrawable详解-优快云博客

public class

ClipDrawable

extends Drawable
implements Drawable.Callback

java.lang.Object
?	android.graphics.drawable.Drawable
	?	android.graphics.drawable.ClipDrawable

ClassOverview

A Drawable that clips another Drawable based on this Drawable's current level value. You can control how much the child Drawable gets clipped in width and height based on the level, as well as a gravity to control where it is placed in its overall container. Most often used to implement things like progress bars, by increasing the drawable's level withsetLevel().

Note:The drawable is clipped completely and not visible when the level is 0 and fully revealed when the level is 10,000.

It can be defined in an XML file with the<clip>element. For more information, see the guide toDrawable Resources.

ClipDrawable是Drawable的子类，我通过它可以设置Drawable的clip.

构造函数： <div style="line-height:25px"> <table id="pubctors" style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:1em; margin-left:1em; padding-top:0px; padding-right:0px; padding-bottom:0px; padding-left:0px; border-top-width:0px; border-right-width:0px; border-bottom-width:0px; border-left-width:0px; border-style:initial; border-color:initial; font-size:0.9em; border-collapse:collapse; empty-cells:show; width:933px"><tbody style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:0px; padding-right:0px; padding-bottom:0px; padding-left:0px; border-top-width:0px; border-right-width:0px; border-bottom-width:0px; border-left-width:0px; border-style:initial; border-color:initial"> <tr style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:0px; padding-right:0px; padding-bottom:0px; padding-left:0px; border-top-width:0px; border-right-width:0px; border-bottom-width:0px; border-left-width:0px; border-style:initial; border-color:initial"> <th colspan="12" style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:6px; padding-right:12px; padding-bottom:6px; padding-left:12px; border-top-width:1px; border-right-width:1px; border-bottom-width:1px; border-left-width:1px; border-style:initial; border-color:initial; border-top-style:solid; border-right-style:solid; border-bottom-style:solid; border-left-style:solid; border-top-color:rgb(204,204,204); border-right-color:rgb(204,204,204); border-bottom-color:rgb(204,204,204); border-left-color:rgb(204,204,204); text-align:left; vertical-align:top; background-color:rgb(222,232,241)"> Public Constructors</th> </tr> <tr style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:0px; padding-right:0px; padding-bottom:0px; padding-left:0px; border-top-width:0px; border-right-width:0px; border-bottom-width:0px; border-left-width:0px; border-style:initial; border-color:initial; background-color:rgb(246,246,246)"> <td style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:6px; padding-right:12px; padding-bottom:6px; padding-left:12px; border-top-width:1px; border-right-width:1px; border-bottom-width:1px; border-left-width:1px; border-style:initial; border-color:initial; border-top-style:solid; border-right-style:solid; border-bottom-style:solid; border-left-style:solid; border-top-color:rgb(204,204,204); border-right-color:rgb(204,204,204); border-bottom-color:rgb(204,204,204); border-left-color:rgb(204,204,204); text-align:right; vertical-align:top; background-color:inherit"> </td> <td width="100%" style="line-height:21px; margin-top:0px; margin-right:0px; margin-bottom:0px; margin-left:0px; padding-top:6px; padding-right:12px; padding-bottom:6px; padding-left:12px; border-top-width:1px; border-right-width:1px; border-bottom-width:1px; border-left-width:1px; border-style:initial; border-color:initial; border-top-style:solid; border-right-style:solid; border-bottom-style:solid; border-left-style:solid; border-top-color:rgb(204,204,204); border-right-color:rgb(204,204,204); border-bottom-color:rgb(204,204,204); border-left-color:rgb(204,204,204); text-align:left; vertical-align:top; background-color:inherit"> <a rel="nofollow" href="http://developer.android.com/reference/android/graphics/drawable/ClipDrawable.html#ClipDrawable(android.graphics.drawable.Drawable,%20int,%20int)" style="color:rgb(0,102,153); line-height:21px; text-decoration:none">ClipDrawable</a>(<a rel="nofollow" href="http://developer.android.com/reference/android/graphics/drawable/Drawable.html" style="color:rgb(0,102,153); line-height:21px; text-decoration:none">Drawable</a>drawable, int gravity, int orientation) 参数 orientation Bitwise-or of HORIZONTAL and/or VERTICAL </td> </tr> </tbody></table> 主要函数有： publicfinalbooleansetLevel(intlevel) Since:APILevel1 Specifythelevelforthedrawable.Thisallowsadrawabletovaryitsimagerybasedonacontinuouscontroller, forexampletoshowprogressorvolumelevel. IfthenewlevelyouaresupplyingcausestheappearanceoftheDrawabletochange,thenitisresponsibleforcallinginvalidateSelf()inordertohaveitselfredrawn,andtruewillbereturnedfromthisfunction. Parameters levelThenewlevel,from0(minimum)to10000(maximum). Returns *ReturnstrueifthischangeinlevelhascausedtheappearanceoftheDrawabletochange(hencerequiringaninvalidate),otherwisereturnsfalse. 注意：必须使用setLevel来设置cliping,注意Thenewlevel,from0(minimum)to10000(maximum). </div> <div style="line-height:25px">该方法继承于Drawable。 ClipDrawable的使用 AdrawabledefinedinXMLthatclipsanotherdrawablebasedonthisDrawable'scurrentlevel.Youcancontrolhowmuchthechilddrawablegetsclippedinwidthandheightbasedonthelevel,aswellasagravitytocontrolwhereitisplacedinitsoverallcontainer.Mostoftenusedtoimplementthingslikeprogressbars. filelocation: res/drawable/filename.xml ThefilenameisusedastheresourceID. compiledresourcedatatype: ResourcepointertoaClipDrawable. resourcereference: InJava:R.drawable.filename InXML:@[package:]drawable/filename syntax: <?xmlversion="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： attributes: xmlns:android String.Required.DefinestheXMLnamespace,whichmustbe"http://schemas.android.com/apk/res/android". 名字空间是固定的"http://schemas.android.com/apk/res/android" android:drawable Drawableresource.Required.Referencetoadrawableresourcetobeclipped. clipped所操作的drawable资源 android:clipOrientation Keyword.Theorientationfortheclip. Mustbeoneofthefollowingconstantvalues: ValueDescription horizontalClipthedrawablehorizontally. verticalClipthedrawablevertically. clip区域可变化的方向horizontally或vertically android:gravity Keyword.Specifieswheretoclipwithinthedrawable. Mustbeoneormore(separatedby'|')ofthefollowingconstantvalues: topPuttheobjectatthetopofitscontainer,notchangingitssize. WhenclipOrientationis"vertical",clippingoccursatthebottomofthedrawable. Drawable采用上对齐的方式。Drawable的大小不变。如果clipOrientation为"vertical"的话，则clipping只能向下 bottomPuttheobjectatthebottomofitscontainer,notchangingitssize. WhenclipOrientationis"vertical",clippingoccursatthetopofthedrawable. Drawable采用下对齐的方式。Drawable的大小不变。如果clipOrientation为"vertical"的话，则clipping只能向上 leftPuttheobjectattheleftedgeofitscontainer,notchangingitssize.Thisisthedefault. WhenclipOrientationis"horizontal",clippingoccursattherightsideofthedrawable. Thisisthedefault. Drawable采用左对齐的方式。Drawable的大小不变。如果clipOrientation为"horizontal"的话，则clipping只能向右。它是默认的对齐方式。 rightPuttheobjectattherightedgeofitscontainer,notchangingitssize. WhenclipOrientationis"horizontal",clippingoccursattheleftsideofthedrawable. Drawable采用右对齐的方式。Drawable的大小不变。如果clipOrientation为"horizontal"的话，则clipping只能向左。 center_verticalPlaceobjectintheverticalcenterofitscontainer,notchangingitssize. Clippingbehavesthesameaswhengravityis"center". Drawable的vertical方向居中对齐。Drawable的大小不变。 Clipping行为和"center"在clipOrientation时"vertical"一样。 fill_verticalGrowtheverticalsizeoftheobjectifneededsoitcompletelyfillsitscontainer. WhenclipOrientationis"vertical",noclippingoccursbecausethedrawablefillstheverticalspace (unlessthedrawablelevelis0,inwhichcaseit'snotvisible). Drawable的vertical方向居中对齐。Drawable的大小会变化， 它在vertical方向要stretch,以便在vertical方向填充它所在的容器。 vertical方向没Clipping行为除非thedrawablelevelis0，这时它不可见。 center_horizontalPlaceobjectinthehorizontalcenterofitscontainer,notchangingitssize. Clippingbehavesthesameaswhengravityis"center". Drawable的horizontal方向居中对齐。Drawable的大小不变。 Clipping行为和"center"在clipOrientation时"horizontal"一样。 fill_horizontalGrowthehorizontalsizeoftheobjectifneededsoitcompletelyfillsitscontainer. WhenclipOrientationis"horizontal",noclippingoccursbecausethedrawablefillsthehorizontalspace (unlessthedrawablelevelis0,inwhichcaseit'snotvisible). Drawable的horizontal方向居中对齐。Drawable的大小会变化， 它在horizontal方向要stretch,以便在vertical方向填充它所在的容器。 horizontal方向没Clipping行为除非thedrawablelevelis0，这时它不可见。 centerPlacetheobjectinthecenterofitscontainerinboththeverticalandhorizontalaxis,notchangingitssize. WhenclipOrientationis"horizontal",clippingoccursontheleftandright. WhenclipOrientationis"vertical",clippingoccursonthetopandbottom. Drawable在horizontal和vertical方向都居中对齐。 当clipOrientation是"horizontal"时，clipping发生在左右方向。 当clipOrientation是"vertica"时，clipping发生在上下方向。 fillGrowthehorizontalandverticalsizeoftheobjectifneededsoitcompletelyfillsitscontainer. Noclippingoccursbecausethedrawablefillsthehorizontalandverticalspace (unlessthedrawablelevelis0,inwhichcaseit'snotvisible). Drawable在horizontal和vertical方向都就进行stretch以便填充它所在的容器。它没有clipping行为。 clip_verticalAdditionaloptionthatcanbesettohavethetopand/orbottomedgesof thechildclippedtoitscontainer'sbounds. Theclipisbasedontheverticalgravity:atopgravityclipsthebottomedge, abottomgravityclipsthetopedge,andneitherclipsbothedges. 附加选项 clip_horizontalAdditionaloptionthatcanbesettohavetheleftand/orrightedgesof thechildclippedtoitscontainer'sbounds.Theclipisbasedonthehorizontalgravity: aleftgravityclipstherightedge,arightgravityclipstheleftedge,andneitherclipsbothedges. 附加选项 注意1:在程序中使用fill_vertical和center_vertical，发现他们居然没差别，无论手动的画，还通过控件画。 fill_horizontal和center_horizontal同理。 注意2:上面关于ClipDrawable的大小的讨论（来自文档）在实际使用发现毫无意义， 在实际的程序中，系统是先把Drawable发到它的Bounds或容器大小时，才来讨论的clipping问题 example: XMLfilesavedatres/drawable/clip.xml: <?xmlversion="1.0"encoding="utf-8"?> <clipxmlns:android="http://schemas.android.com/apk/res/android" android:drawable="@drawable/android" android:clipOrientation="horizontal" android:gravity="left"> </clip> 在文档中居然是用的"shape",而非"clip".经验证"clip"才对，“shape”是错误的。 文档居然也有种低级错误。 ThefollowinglayoutXMLappliestheclipdrawabletoaView: <ImageView android:id="@+id/image" android:background="@drawable/clip" android:layout_height="wrap_content" android:layout_width="wrap_content"/> Thefollowingcodegetsthedrawableandincreasestheamountofclippinginordertoprogressivelyrevealtheimage: ImageViewimageview=(ImageView)findViewById(R.id.image); ClipDrawabledrawable=(ClipDrawable)imageview.getDrawable(); drawable.setLevel(drawable.getLevel()+1000); Increasingthelevelreducestheamountofclippingandslowlyrevealstheimage.Hereitisatalevelof7000: 示例2: loading.xml文件 <?xmlversion="1.0"encoding="utf-8"?> <clipxmlns:android="http://schemas.android.com/apk/res/android" android:drawable="@drawable/load" android:clipOrientation="horizontal" android:gravity="fill_vertical"> </clip> 代码1： ClipDrawableloadDrawable; intloadDrawableLevel=0; finalstaticintlevelMax=10000; 代码2： loadDrawable=(ClipDrawable)context.getResources().getDrawable(R.drawable.loading); 代码3： Rectbounds=null; if(loadDrawableLevel<levelMax) { loadDrawableLevel+=10;; loadDrawable.setLevel(loadDrawableLevel); bounds=newRect(0,0,Game.width,Game.height); loadDrawable.setBounds(bounds); } else loadDrawableLevel=0; loadDrawable.draw(canvas); 参考资料：http://developer.android.com/guide/topics/resources/drawable-resource.html </div>