public
class
ViewGroupOverlay
extends ViewOverlay
java.lang.Object | ||
↳ | android.view.ViewOverlay | |
↳ | android.view.ViewGroupOverlay |
A group overlay is an extra layer that sits on top of a ViewGroup (the "host view") which is drawn after all other content in that view (including the view group's children). Interaction with the overlay layer is done by adding and removing views and drawables.
ViewGroupOverlay is a subclass of ViewOverlay
, adding the ability to
manage views for overlays on ViewGroups, in addition to the drawable
support in ViewOverlay.
See also:
Public methods | |
---|---|
void
|
add(View view)
Adds a |
void
|
remove(View view)
Removes the specified |
Inherited methods | |
---|---|
From
class
android.view.ViewOverlay
| |
From
class
java.lang.Object
|
void add (View view)
Adds a View
to the overlay. The bounds of the added view should be
relative to the host view. Any view added to the overlay should be
removed when it is no longer needed or no longer visible.
Views in the overlay are visual-only; they do not receive input events and do not participate in focus traversal. Overlay views are intended to be transient, such as might be needed by a temporary animation effect.
If the view has a parent, the view will be removed from that parent before being added to the overlay. Also, if that parent is attached in the current view hierarchy, the view will be repositioned such that it is in the same relative location inside the activity. For example, if the view's current parent lies 100 pixels to the right and 200 pixels down from the origin of the overlay's host view, then the view will be offset by (100, 200).
View
s added with this API will be drawn in the order they were
added. Drawing of the overlay views will happen before drawing of any of the
Drawable
s added with add(Drawable)
API even if a call to
this API happened after the call to add(Drawable)
.
Passing null
parameter will result in an
IllegalArgumentException
being thrown.
Parameters | |
---|---|
view |
View :
The View to be added to the overlay. The added view will be
drawn when the overlay is drawn. |
See also:
void remove (View view)
Removes the specified View
from the overlay. Passing null
parameter
will result in an IllegalArgumentException
being thrown.
Parameters | |
---|---|
view |
View :
The View to be removed from the overlay. |
See also: