AppWidgetEvent
public
final
class
AppWidgetEvent
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.appwidget.AppWidgetEvent |
An immutable class that describes the event data for an app widget interaction event.
Summary
Inherited constants |
---|
Fields | |
---|---|
public
static
final
Creator<AppWidgetEvent> |
CREATOR
Parcelable.Creator that instantiates AppWidgetEvent objects |
Public methods | |
---|---|
int
|
describeContents()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
int
|
getAppWidgetId()
The app widget ID of the widget that generated this event. |
int[]
|
getClickedIds()
This returns the set of View IDs of the views which have been clicked during the event time range. |
Instant
|
getEnd()
Describes the end of the time range that this event contains data for. |
Rect
|
getPosition()
This rect with describes the global coordinates of the widget at the end of the event time range. |
int[]
|
getScrolledIds()
This returns the set of View IDs of the views which have been scrolled during the event time range. |
Instant
|
getStart()
Describes the start of the time range that this event contains data for. |
Duration
|
getVisibleDuration()
Describes the total duration of time during which the widget was visible. |
String
|
toString()
Returns a string representation of the object. |
void
|
writeToParcel(Parcel out, int flags)
Flatten this object in to a Parcel. |
Inherited methods | |
---|---|
Fields
CREATOR
public static final Creator<AppWidgetEvent> CREATOR
Parcelable.Creator that instantiates AppWidgetEvent objects
Public methods
describeContents
public int describeContents ()
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation. For example, if the object will
include a file descriptor in the output of writeToParcel(android.os.Parcel, int)
,
the return value of this method must include the
CONTENTS_FILE_DESCRIPTOR
bit.
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled
by this Parcelable object instance.
Value is either 0 or CONTENTS_FILE_DESCRIPTOR |
getAppWidgetId
public int getAppWidgetId ()
The app widget ID of the widget that generated this event.
Returns | |
---|---|
int |
See also:
getClickedIds
public int[] getClickedIds ()
This returns the set of View IDs of the views which have been clicked during the event time
range. Use RemoteViews.setAppWidgetEventTag(int, int)
to set a custom
integer tag on a view for reporting clicks. If the tag is set, it will be used here instead
of the View ID.
Returns | |
---|---|
int[] |
This value may be null . |
getEnd
public Instant getEnd ()
Describes the end of the time range that this event contains data for.
Returns | |
---|---|
Instant |
This value cannot be null . |
getPosition
public Rect getPosition ()
This rect with describes the global coordinates of the widget at the end of the event time range.
Returns | |
---|---|
Rect |
This value may be null . |
getScrolledIds
public int[] getScrolledIds ()
This returns the set of View IDs of the views which have been scrolled during the event time
range. Use RemoteViews.setAppWidgetEventTag(int, int)
to set a custom
integer tag on a view for reporting scrolls. If the tag is set, it will be used here instead
of the View ID.
Returns | |
---|---|
int[] |
This value may be null . |
getStart
public Instant getStart ()
Describes the start of the time range that this event contains data for.
Returns | |
---|---|
Instant |
This value cannot be null . |
getVisibleDuration
public Duration getVisibleDuration ()
Describes the total duration of time during which the widget was visible. This may be
different than the event time range (between getStart()
and getEnd()
if the
widget was hidden and shown multiple times during the event time range.
Returns | |
---|---|
Duration |
This value cannot be null . |
toString
public String toString ()
Returns a string representation of the object.
Returns | |
---|---|
String |
a string representation of the object. |
writeToParcel
public void writeToParcel (Parcel out, int flags)
Flatten this object in to a Parcel.
Parameters | |
---|---|
out |
Parcel : This value cannot be null . |
flags |
int : Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE .
Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE , and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |