java.lang.Object | |
↳ | android.support.v4.widget.EdgeEffectCompat |
Helper for accessing EdgeEffect
introduced after
API level 4 in a backwards compatible fashion.
This class is used to access EdgeEffect
on platform versions
that support it. When running on older platforms it will result in no-ops. It should
be used by views that wish to use the standard Android visual effects at the edges
of scrolling containers.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construct a new EdgeEffect themed using the given context.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Draw into the provided canvas.
| |||||||||||
Immediately finish the current animation.
| |||||||||||
Reports if this EdgeEffectCompat's animation is finished.
| |||||||||||
Call when the effect absorbs an impact at the given velocity.
| |||||||||||
A view should call this when content is pulled away from an edge by the user.
| |||||||||||
This method is deprecated.
use
onPull(float, float)
| |||||||||||
Call when the object is released after being pulled.
| |||||||||||
Set the size of this edge effect in pixels.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Construct a new EdgeEffect themed using the given context.
Note: On platform versions that do not support EdgeEffect, all operations on the newly constructed object will be mocked/no-ops.
context | Context to use for theming the effect |
---|
Draw into the provided canvas. Assumes that the canvas has been rotated accordingly and the size has been set. The effect will be drawn the full width of X=0 to X=width, beginning from Y=0 and extending to some factor < 1.f of height.
canvas | Canvas to draw into |
---|
Immediately finish the current animation.
After this call isFinished()
will return true.
Reports if this EdgeEffectCompat's animation is finished. If this method returns false
after a call to draw(Canvas)
the host widget should schedule another
drawing pass to continue the animation.
Call when the effect absorbs an impact at the given velocity. Used when a fling reaches the scroll boundary.
When using a Scroller
or OverScroller
,
the method getCurrVelocity
will provide a reasonable approximation
to use here.
velocity | Velocity at impact in pixels per second. |
---|
A view should call this when content is pulled away from an edge by the user.
This will update the state of the current visual effect and its associated animation.
The host view should always invalidate()
if this method
returns true and draw the results accordingly.
deltaDistance | Change in distance since the last call. Values may be 0 (no change) to 1.f (full length of the view) or negative values to express change back toward the edge reached to initiate the effect. |
---|---|
displacement | The displacement from the starting side of the effect of the point initiating the pull. In the case of touch this is the finger position. Values may be from 0-1. |
This method is deprecated.
use onPull(float, float)
A view should call this when content is pulled away from an edge by the user.
This will update the state of the current visual effect and its associated animation.
The host view should always invalidate()
if this method
returns true and draw the results accordingly.
deltaDistance | Change in distance since the last call. Values may be 0 (no change) to 1.f (full length of the view) or negative values to express change back toward the edge reached to initiate the effect. |
---|
Call when the object is released after being pulled.
This will begin the "decay" phase of the effect. After calling this method
the host view should invalidate()
if this method
returns true and thereby draw the results accordingly.
Set the size of this edge effect in pixels.
width | Effect width in pixels |
---|---|
height | Effect height in pixels |