Rect Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Rect holds four integer coordinates for a rectangle.
[Android.Runtime.Register("android/graphics/Rect", DoNotGenerateAcw=true)]
public sealed class Rect : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/graphics/Rect", DoNotGenerateAcw=true)>]
type Rect = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Inheritance
- Attributes
- Implements
Remarks
Rect holds four integer coordinates for a rectangle. The rectangle is represented by the coordinates of its 4 edges (left, top, right bottom). These fields can be accessed directly. Use width() and height() to retrieve the rectangle's width and height. Note: most methods do not check to see that the coordinates are sorted correctly (i.e. left <= right and top <= bottom).
Note that the right and bottom coordinates are exclusive. This means a Rect being drawn untransformed onto a android.graphics.Canvas will draw into the column and row described by its left and top coordinates, but not those of its bottom and right.
Java documentation for android.graphics.Rect.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Constructors
| Name | Description |
|---|---|
| Rect() |
Create a new empty Rect. |
| Rect(Int32, Int32, Int32, Int32) |
Create a new rectangle with the specified coordinates. |
| Rect(Rect) |
Create a new rectangle, initialized with the values in the specified rectangle (which is left unmodified). |
Properties
| Name | Description |
|---|---|
| Bottom |
Gets or sets the rectangle's bottom edge coordinate. |
| Class |
Returns the runtime class of this |
| Creator |
Gets the parcel creator for integer rectangles. |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| IsEmpty |
Returns true if the rectangle is empty (left >= right or top >= bottom) |
| JniIdentityHashCode |
Gets the identity hash code assigned to this Java peer by the interop runtime. (Inherited from Object) |
| JniManagedPeerState |
Gets the state flags last assigned by the runtime. (Inherited from JavaObject) |
| JniPeerMembers |
Gets the JNI metadata used to access members of this Java binding. |
| Left |
Gets or sets the rectangle's left edge coordinate. |
| PeerReference |
Gets the JNI object reference for this Java peer. (Inherited from Object) |
| Right |
Gets or sets the rectangle's right edge coordinate. |
| ThresholdClass |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object) |
| ThresholdType |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object) |
| Top |
Gets or sets the rectangle's top edge coordinate. |
Methods
| Name | Description |
|---|---|
| CenterX() |
Calculates |
| CenterY() |
Calculates |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delegates construction of this peer to the runtime's value manager. (Inherited from JavaObject) |
| Contains(Int32, Int32, Int32, Int32) |
Returns true iff the 4 specified sides of a rectangle are inside or equal to this rectangle. |
| Contains(Int32, Int32) |
Returns true if (x,y) is inside the rectangle. |
| Contains(Rect) |
Returns true iff the specified rectangle r is inside or equal to this rectangle. |
| DescribeContents() |
Parcelable interface methods |
| Dispose() |
Releases the resources held by this Java peer. (Inherited from Object) |
| Dispose(Boolean) |
Releases the resources held by this Java peer. (Inherited from Object) |
| DisposeUnlessReferenced() |
Asks the value manager to dispose this peer unless its mapping retains this same managed instance. (Inherited from JavaObject) |
| Equals(Object) |
Tests whether another managed peer refers to the same Java object. (Inherited from JavaObject) |
| Equals(Object) |
Indicates whether some other object is "equal to" this one. (Inherited from Object) |
| ExactCenterX() |
Calculates |
| ExactCenterY() |
Calculates |
| FlattenToString() |
Return a string representation of the rectangle in a well-defined format. |
| GetHashCode() |
Returns a hash code value for the object. (Inherited from Object) |
| Height() |
Subtracts the top edge from the bottom edge. |
| Inset(Insets) |
Insets the rectangle on all sides specified by the dimensions of |
| Inset(Int32, Int32, Int32, Int32) |
Insets the rectangle on all sides specified by the insets. |
| Inset(Int32, Int32) |
Inset the rectangle by (dx,dy). |
| Intersect(Int32, Int32, Int32, Int32) |
If the rectangle specified by left,top,right,bottom intersects this rectangle, return true and set this rectangle to that intersection, otherwise return false and do not change this rectangle. |
| Intersect(Rect) |
If the specified rectangle intersects this rectangle, return true and set this rectangle to that intersection, otherwise return false and do not change this rectangle. |
| Intersects(Int32, Int32, Int32, Int32) |
Returns true if this rectangle intersects the specified rectangle. |
| Intersects(Rect, Rect) |
Returns true iff the two specified rectangles intersect. |
| JavaFinalize() |
Obsolete.
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object) |
| Notify() |
Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object) |
| NotifyAll() |
Wakes up all threads that are waiting on this object's monitor. (Inherited from Object) |
| Offset(Int32, Int32) |
Offset the rectangle by adding dx to its left and right coordinates, and adding dy to its top and bottom coordinates. |
| OffsetTo(Int32, Int32) |
Offset the rectangle to a specific (left, top) position, keeping its width and height the same. |
| ReadFromParcel(Parcel) |
Set the rectangle's coordinates from the data stored in the specified parcel. |
| Set(Int32, Int32, Int32, Int32) |
Set the rectangle's coordinates to the specified values. |
| Set(Rect) |
Copy the coordinates from src into this rectangle. |
| SetEmpty() |
Set the rectangle to (0,0,0,0) |
| SetHandle(IntPtr, JniHandleOwnership) |
Sets the Handle property. (Inherited from Object) |
| SetIntersect(Rect, Rect) |
If rectangles a and b intersect, return true and set this rectangle to that intersection, otherwise return false and do not change this rectangle. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Stores a reference value in the control block without creating a JNI reference copy. (Inherited from JavaObject) |
| Sort() |
Swap top/bottom or left/right if there are flipped (i. |
| ToArray<T>() |
Creates a managed array from this Java array wrapper. (Inherited from Object) |
| ToShortString() |
Return a string representation of the rectangle in a compact form. |
| ToString() |
Returns a string representation of the object. (Inherited from Object) |
| UnflattenFromString(String) |
Returns a Rect from a string of the form returned by |
| Union(Int32, Int32, Int32, Int32) |
Update this Rect to enclose itself and the specified rectangle. |
| Union(Int32, Int32) |
Update this Rect to enclose itself and the [x,y] coordinate. |
| Union(Rect) |
Update this Rect to enclose itself and the specified rectangle. |
| UnregisterFromRuntime() |
Unregisters this Java peer from the interop runtime. (Inherited from Object) |
| Wait() |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object) |
| Wait(Int64, Int32) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Wait(Int64) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Width() |
Subtracts the left edge from the right edge. |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Write this rectangle to the specified parcel. |
Explicit Interface Implementations
| Name | Description |
|---|---|
| IJavaPeerable.Disposed() |
Marks this peer as disposed and calls |
| IJavaPeerable.Finalized() |
Marks this peer as disposed and calls |
| IJavaPeerable.JniObjectReferenceControlBlock |
Gets the native control-block pointer used by this peer. (Inherited from JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Stores the identity hash code supplied by the runtime. (Inherited from JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Replaces the stored managed peer state flags. (Inherited from JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Updates the peer reference and releases a disposed peer's control block when the reference is invalid. (Inherited from JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Removes this instance from the runtime's Java object lookup. |
Extension Methods
| Name | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Gets the JNI name of the type of the instance |
| JavaAs<TResult>(IJavaPeerable) |
Try to coerce |
| JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
| JavaCast<TResult>(IJavaObject) |
Reuses a compatible managed peer or obtains a wrapper of the requested type. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Try to coerce |