View.Invalidate Method
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.
Overloads
Invalidate() |
Invalidate the whole view. |
Invalidate(Rect) |
Mark the area defined by dirty as needing to be drawn. |
Invalidate(Int32, Int32, Int32, Int32) |
Mark the area defined by the rect (l,t,r,b) as needing to be drawn. |
Invalidate()
Invalidate the whole view.
[Android.Runtime.Register("invalidate", "()V", "GetInvalidateHandler")]
public virtual void Invalidate ();
[<Android.Runtime.Register("invalidate", "()V", "GetInvalidateHandler")>]
abstract member Invalidate : unit -> unit
override this.Invalidate : unit -> unit
- Attributes
Remarks
Invalidate the whole view. If the view is visible, #onDraw(android.graphics.Canvas)
will be called at some point in the future.
This must be called from a UI thread. To call from a non-UI thread, call #postInvalidate()
.
Java documentation for android.view.View.invalidate()
.
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.
Applies to
Invalidate(Rect)
Mark the area defined by dirty as needing to be drawn.
[Android.Runtime.Register("invalidate", "(Landroid/graphics/Rect;)V", "GetInvalidate_Landroid_graphics_Rect_Handler")]
public virtual void Invalidate (Android.Graphics.Rect? dirty);
[<Android.Runtime.Register("invalidate", "(Landroid/graphics/Rect;)V", "GetInvalidate_Landroid_graphics_Rect_Handler")>]
abstract member Invalidate : Android.Graphics.Rect -> unit
override this.Invalidate : Android.Graphics.Rect -> unit
Parameters
- dirty
- Rect
the rectangle representing the bounds of the dirty region
- Attributes
Remarks
Mark the area defined by dirty as needing to be drawn. If the view is visible, #onDraw(android.graphics.Canvas)
will be called at some point in the future.
This must be called from a UI thread. To call from a non-UI thread, call #postInvalidate()
.
<b>WARNING:</b> In API 19 and below, this method may be destructive to dirty
.
This member is deprecated. The switch to hardware accelerated rendering in API 14 reduced the importance of the dirty rectangle. In API 21 the given rectangle is ignored entirely in favor of an internally-calculated area instead. Because of this, clients are encouraged to just call #invalidate()
.
Java documentation for android.view.View.invalidate(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.
Applies to
Invalidate(Int32, Int32, Int32, Int32)
Mark the area defined by the rect (l,t,r,b) as needing to be drawn.
[Android.Runtime.Register("invalidate", "(IIII)V", "GetInvalidate_IIIIHandler")]
public virtual void Invalidate (int l, int t, int r, int b);
[<Android.Runtime.Register("invalidate", "(IIII)V", "GetInvalidate_IIIIHandler")>]
abstract member Invalidate : int * int * int * int -> unit
override this.Invalidate : int * int * int * int -> unit
Parameters
- l
- Int32
the left position of the dirty region
- t
- Int32
the top position of the dirty region
- r
- Int32
the right position of the dirty region
- b
- Int32
the bottom position of the dirty region
- Attributes
Remarks
Mark the area defined by the rect (l,t,r,b) as needing to be drawn. The coordinates of the dirty rect are relative to the view. If the view is visible, #onDraw(android.graphics.Canvas)
will be called at some point in the future.
This must be called from a UI thread. To call from a non-UI thread, call #postInvalidate()
.
This member is deprecated. The switch to hardware accelerated rendering in API 14 reduced the importance of the dirty rectangle. In API 21 the given rectangle is ignored entirely in favor of an internally-calculated area instead. Because of this, clients are encouraged to just call #invalidate()
.
Java documentation for android.view.View.invalidate(int, int, int, int)
.
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.