Most visited

Recently visited

Added in API level 1

Region

public class Region
extends Object implements Parcelable

java.lang.Object
   ↳ android.graphics.Region


Summary

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

Fields

CREATOR

Added in API level 1
Creator<Region> CREATOR

Public constructors

Region

Added in API level 1
Region ()

创建一个空白区域

Region

Added in API level 1
Region (Region region)

返回指定区域的副本

Parameters
region Region

Region

Added in API level 1
Region (Rect r)

返回设置为指定矩形的区域

Parameters
r Rect

Region

Added in API level 1
Region (int left, 
                int top, 
                int right, 
                int bottom)

返回设置为指定矩形的区域

Parameters
left int
top int
right int
bottom int

Public methods

contains

Added in API level 1
boolean contains (int x, 
                int y)

如果区域包含指定的点,则返回true

Parameters
x int
y int
Returns
boolean

describeContents

Added in API level 1
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.

equals

Added in API level 1
boolean equals (Object obj)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values 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.
  • For any non-null reference value x, x.equals(null) should return false.

equals方法Object实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值xy ,当且仅当xy指向同一对象( 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.

getBoundaryPath

Added in API level 1
boolean getBoundaryPath (Path path)

将路径设置为该区域的边界。 如果该区域为空,路径也将为空。

Parameters
path Path
Returns
boolean

getBoundaryPath

Added in API level 1
Path getBoundaryPath ()

返回该区域的边界作为一个新的路径。 如果该区域为空,路径也将为空。

Returns
Path

getBounds

Added in API level 1
Rect getBounds ()

将新的Rect集返回到区域的边界。 如果该区域为空,则Rect将设置为[0,0,0,0]

Returns
Rect

getBounds

Added in API level 1
boolean getBounds (Rect r)

将Rect设置为区域的边界。 如果该区域为空,则Rect将设置为[0,0,0,0]

Parameters
r Rect
Returns
boolean

isComplex

Added in API level 1
boolean isComplex ()

如果区域包含多个矩形,则返回true

Returns
boolean

isEmpty

Added in API level 1
boolean isEmpty ()

如果此区域为空,则返回true

Returns
boolean

isRect

Added in API level 1
boolean isRect ()

如果区域包含单个矩形,则返回true

Returns
boolean

op

Added in API level 1
boolean op (Region region1, 
                Region region2, 
                Region.Op op)

将此区域设置为在指定区域上执行Op的结果。 如果结果不为空,则返回true。

Parameters
region1 Region
region2 Region
op Region.Op
Returns
boolean

op

Added in API level 1
boolean op (Rect r, 
                Region.Op op)

在该区域和指定的矩形上执行指定的操作。 如果op的结果不为空,则返回true。

Parameters
r Rect
op Region.Op
Returns
boolean

op

Added in API level 1
boolean op (Rect rect, 
                Region region, 
                Region.Op op)

将此区域设置为在指定的矩形和区域上执行Op的结果。 如果结果不为空,则返回true。

Parameters
rect Rect
region Region
op Region.Op
Returns
boolean

op

Added in API level 1
boolean op (Region region, 
                Region.Op op)

在该区域和指定的区域上执行指定的Op。 如果op的结果不为空,则返回true。

Parameters
region Region
op Region.Op
Returns
boolean

op

Added in API level 1
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

quickContains

Added in API level 1
boolean quickContains (Rect r)

如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 返回false不保证该区域不包含矩形,但返回true将保证该区域包含该矩形。

Parameters
r Rect
Returns
boolean

quickContains

Added in API level 1
boolean quickContains (int left, 
                int top, 
                int right, 
                int bottom)

如果区域是单个矩形(不是复杂的)并且包含指定的矩形,则返回true。 返回false不保证该区域不包含矩形,但返回true将保证该区域包含该矩形。

Parameters
left int
top int
right int
bottom int
Returns
boolean

quickReject

Added in API level 1
boolean quickReject (Region rgn)

如果区域为空,或者指定的区域不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。

Parameters
rgn Region
Returns
boolean

quickReject

Added in API level 1
boolean quickReject (Rect r)

如果区域为空,或者指定的矩形不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。

Parameters
r Rect
Returns
boolean

quickReject

Added in API level 1
boolean quickReject (int left, 
                int top, 
                int right, 
                int bottom)

如果区域为空,或者指定的矩形不与区域相交,则返回true。 返回错误并不是它们相交的保证,但返回正确是他们没有的保证。

Parameters
left int
top int
right int
bottom int
Returns
boolean

set

Added in API level 1
boolean set (int left, 
                int top, 
                int right, 
                int bottom)

将区域设置为指定的矩形

Parameters
left int
top int
right int
bottom int
Returns
boolean

set

Added in API level 1
boolean set (Region region)

将区域设置为指定的区域。

Parameters
region Region
Returns
boolean

set

Added in API level 1
boolean set (Rect r)

将区域设置为指定的矩形

Parameters
r Rect
Returns
boolean

setEmpty

Added in API level 1
void setEmpty ()

将区域设置为空白区域

setPath

Added in API level 1
boolean setPath (Path path, 
                Region clip)

将区域设置为路径和剪辑描述的区域。 如果结果区域非空,则返回true。 这会产生一个与路径将绘制的像素相同的区域(没有抗锯齿功能)。

Parameters
path Path
clip Region
Returns
boolean

toString

Added in API level 1
String toString ()

返回对象的字符串表示形式。 通常, toString方法返回一个“文本表示”此对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

translate

Added in API level 1
void translate (int dx, 
                int dy, 
                Region dst)

将dst区域设置为[dx,dy]翻译该区域的结果。 如果此区域为空,则dst将被设置为空。

Parameters
dx int
dy int
dst Region

translate

Added in API level 1
void translate (int dx, 
                int dy)

用[dx,dy]翻译区域。 如果该地区是空的,则什么也不做。

Parameters
dx int
dy int

union

Added in API level 1
boolean union (Rect r)

Parameters
r Rect
Returns
boolean

writeToParcel

Added in API level 1
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.

Protected methods

finalize

Added in API level 1
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

Hooray!