public class Region
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.graphics.Region |
Nested classes |
|
---|---|
枚举 |
Region.Op
|
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<Region> |
CREATOR |
Public constructors |
|
---|---|
Region() 创建一个空白区域 |
|
Region(Region region) 返回指定区域的副本 |
|
Region(Rect r) 返回设置为指定矩形的区域 |
|
Region(int left, int top, int right, int bottom) 返回设置为指定矩形的区域 |
Public methods |
|
---|---|
boolean |
contains(int x, int y) 如果区域包含指定的点,则返回true |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
boolean |
equals(Object obj) 指示其他某个对象是否“等于”这一个。 |
boolean |
getBoundaryPath(Path path) 将路径设置为该区域的边界。 |
Path |
getBoundaryPath() 返回该区域的边界作为一个新的路径。 |
Rect |
getBounds() 将新的Rect集返回到区域的边界。 |
boolean |
getBounds(Rect r) 将Rect设置为区域的边界。 |
boolean |
isComplex() 如果区域包含多个矩形,则返回true |
boolean |
isEmpty() 如果此区域为空,则返回true |
boolean |
isRect() 如果区域包含单个矩形,则返回true |
boolean |
op(Region region1, Region region2, Region.Op op) 将此区域设置为在指定区域上执行Op的结果。 |
boolean |
op(Rect r, Region.Op op) 在该区域和指定的矩形上执行指定的操作。 |
boolean |
op(Rect rect, Region region, Region.Op op) 将此区域设置为在指定的矩形和区域上执行Op的结果。 |
boolean |
op(Region region, Region.Op op) 在该区域和指定的区域上执行指定的Op。 |
boolean |
op(int left, int top, int right, int bottom, Region.Op op) 在该区域和指定的矩形上执行指定的操作。 |
boolean |
quickContains(Rect r) 如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 |
boolean |
quickContains(int left, int top, int right, int bottom) 如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 |
boolean |
quickReject(Region rgn) 如果区域为空,或者指定的区域不与区域相交,则返回true。 |
boolean |
quickReject(Rect r) 如果区域为空,或者指定的矩形不与区域相交,则返回true。 |
boolean |
quickReject(int left, int top, int right, int bottom) 如果区域为空,或者指定的矩形不与区域相交,则返回true。 |
boolean |
set(int left, int top, int right, int bottom) 将区域设置为指定的矩形 |
boolean |
set(Region region) 将区域设置为指定的区域。 |
boolean |
set(Rect r) 将区域设置为指定的矩形 |
void |
setEmpty() 将区域设置为空白区域 |
boolean |
setPath(Path path, Region clip) 将区域设置为路径和剪辑描述的区域。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
translate(int dx, int dy, Region dst) 将dst区域设置为[dx,dy]翻译该区域的结果。 |
void |
translate(int dx, int dy) 用[dx,dy]翻译区域。 |
final boolean |
union(Rect r) |
void |
writeToParcel(Parcel p, int flags) 将区域及其像素写入宗地。 |
Protected methods |
|
---|---|
void |
finalize() 当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
Region (int left, int top, int right, int bottom)
返回设置为指定矩形的区域
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
boolean contains (int x, int y)
如果区域包含指定的点,则返回true
Parameters | |
---|---|
x |
int
|
y |
int
|
Returns | |
---|---|
boolean |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
boolean equals (Object obj)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. x
and y
, multiple invocations of x.equals(y)
consistently return true
or consistently return false
, provided no information used in equals
comparisons on the objects is modified. x
, x.equals(null)
should return false
. 类equals
方法Object
实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
指向同一对象( x == y
的值为true
)时,此方法返回true
。
请注意,无论何时覆盖此方法,通常都需要覆盖 hashCode
方法,以便维护 hashCode
方法的一般合同,该方法声明相等对象必须具有相同的哈希代码。
Parameters | |
---|---|
obj |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
boolean getBoundaryPath (Path path)
将路径设置为该区域的边界。 如果该区域为空,路径也将为空。
Parameters | |
---|---|
path |
Path
|
Returns | |
---|---|
boolean |
Path getBoundaryPath ()
返回该区域的边界作为一个新的路径。 如果该区域为空,路径也将为空。
Returns | |
---|---|
Path |
Rect getBounds ()
将新的Rect集返回到区域的边界。 如果该区域为空,则Rect将设置为[0,0,0,0]
Returns | |
---|---|
Rect |
boolean getBounds (Rect r)
将Rect设置为区域的边界。 如果该区域为空,则Rect将设置为[0,0,0,0]
Parameters | |
---|---|
r |
Rect
|
Returns | |
---|---|
boolean |
boolean op (Region region1, Region region2, Region.Op op)
将此区域设置为在指定区域上执行Op的结果。 如果结果不为空,则返回true。
Parameters | |
---|---|
region1 |
Region
|
region2 |
Region
|
op |
Region.Op
|
Returns | |
---|---|
boolean |
boolean op (Rect r, Region.Op op)
在该区域和指定的矩形上执行指定的操作。 如果op的结果不为空,则返回true。
Parameters | |
---|---|
r |
Rect
|
op |
Region.Op
|
Returns | |
---|---|
boolean |
boolean op (Rect rect, Region region, Region.Op op)
将此区域设置为在指定的矩形和区域上执行Op的结果。 如果结果不为空,则返回true。
Parameters | |
---|---|
rect |
Rect
|
region |
Region
|
op |
Region.Op
|
Returns | |
---|---|
boolean |
boolean op (Region region, Region.Op op)
在该区域和指定的区域上执行指定的Op。 如果op的结果不为空,则返回true。
Parameters | |
---|---|
region |
Region
|
op |
Region.Op
|
Returns | |
---|---|
boolean |
boolean op (int left, int top, int right, int bottom, Region.Op op)
在该区域和指定的矩形上执行指定的操作。 如果op的结果不为空,则返回true。
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
op |
Region.Op
|
Returns | |
---|---|
boolean |
boolean quickContains (Rect r)
如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 返回false不保证该区域不包含矩形,但返回true将保证该区域包含该矩形。
Parameters | |
---|---|
r |
Rect
|
Returns | |
---|---|
boolean |
boolean quickContains (int left, int top, int right, int bottom)
如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 返回false不保证该区域不包含矩形,但返回true将保证该区域包含该矩形。
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
Returns | |
---|---|
boolean |
boolean quickReject (Region rgn)
如果区域为空,或者指定的区域不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。
Parameters | |
---|---|
rgn |
Region
|
Returns | |
---|---|
boolean |
boolean quickReject (Rect r)
如果区域为空,或者指定的矩形不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。
Parameters | |
---|---|
r |
Rect
|
Returns | |
---|---|
boolean |
boolean quickReject (int left, int top, int right, int bottom)
如果区域为空,或者指定的矩形不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
Returns | |
---|---|
boolean |
boolean set (int left, int top, int right, int bottom)
将区域设置为指定的矩形
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
Returns | |
---|---|
boolean |
boolean set (Region region)
将区域设置为指定的区域。
Parameters | |
---|---|
region |
Region
|
Returns | |
---|---|
boolean |
boolean setPath (Path path, Region clip)
将区域设置为路径和剪辑描述的区域。 如果结果区域非空,则返回true。 这会产生一个与路径将绘制的像素相同的区域(没有抗锯齿功能)。
Parameters | |
---|---|
path |
Path
|
clip |
Region
|
Returns | |
---|---|
boolean |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”此对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void translate (int dx, int dy, Region dst)
将dst区域设置为[dx,dy]翻译该区域的结果。 如果此区域为空,则dst将被设置为空。
Parameters | |
---|---|
dx |
int
|
dy |
int
|
dst |
Region
|
void translate (int dx, int dy)
用[dx,dy]翻译区域。 如果该地区是空的,则什么也不做。
Parameters | |
---|---|
dx |
int
|
dy |
int
|
void writeToParcel (Parcel p, int flags)
将区域及其像素写入宗地。 可以通过调用CREATOR.createFromParcel()从该宗地重建区域。
Parameters | |
---|---|
p |
Parcel : Parcel object to write the region data into |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |
void finalize ()
当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 子类会覆盖finalize
方法以处置系统资源或执行其他清理。
的常规协定finalize
是,它被调用,如果当在Java TM虚拟机已确定不再有由该目的可以通过还没有死亡,除了作为一个动作的结果的任何线程访问的任何手段取决于某些其他可以完成的对象或类别的最终定稿。 finalize
方法可以采取任何行动,包括使这个对象再次可用于其他线程; 然而, finalize
的通常目的是在对象被不可撤销地丢弃之前执行清理操作。 例如,表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务,以在永久丢弃该对象之前中断连接。
类finalize
方法Object
执行特别的操作; 它只是正常返回。 Object
子类可能会覆盖此定义。
Java编程语言不保证哪个线程将为任何给定对象调用finalize
方法。 但是,保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常,则忽略该异常,并终止该对象的终止。
在针对某个对象调用了 finalize
方法之后,在Java虚拟机再次确定不再有任何方法可以通过尚未死亡的任何线程访问此对象,包括可能的操作通过准备完成的其他对象或类别,此时该对象可能被丢弃。
对于任何给定的对象,Java虚拟机从不会多次调用 finalize
方法。
finalize
方法引发的任何异常 finalize
导致终止此对象的终止,但会被忽略。
Throws | |
---|---|
Throwable |