RemoteResponse
open class RemoteResponse
Class representing a response to an action performed on any element of a RemoteViews.
Summary
Public constructors
RemoteResponse
RemoteResponse()
Public methods
addSharedElement
open fun addSharedElement(
viewId: Int,
sharedElementName: String
): RemoteViews.RemoteResponse
Adds a shared element to be transferred as part of the transition between Activities using cross-Activity scene animations. The position of the first element will be used as the epicenter for the exit Transition. The position of the associated shared element in the launched Activity will be the epicenter of its entering Transition.
Parameters |
viewId |
Int: The id of the view to be shared as part of the transition |
sharedElementName |
String: The shared element name for this view This value cannot be null . |
fromFillInIntent
open static fun fromFillInIntent(fillIntent: Intent): RemoteViews.RemoteResponse
When using collections (eg. ListView
, StackView
etc.) in widgets, it is very costly to set PendingIntents on the individual items, and is hence not recommended. Instead a single PendingIntent template can be set on the collection, see android.widget.RemoteViews#setPendingIntentTemplate(int,android.app.PendingIntent)
, and the individual on-click action of a given item can be distinguished by setting a fillInIntent on that item. The fillInIntent is then combined with the PendingIntent template in order to determine the final intent which will be executed when the item is clicked. This works as follows: any fields which are left blank in the PendingIntent template, but are provided by the fillInIntent will be overwritten, and the resulting PendingIntent will be used. The rest of the PendingIntent template will then be filled in with the associated fields that are set in fillInIntent. See Intent#fillIn(Intent, int)
for more details. Creates a response which sends a pending intent as part of the response. The source bounds (Intent#getSourceBounds()
) of the intent will be set to the bounds of the target view in screen space. Note that any activity options associated with the mPendingIntent may get overridden before starting the intent.
Parameters |
fillIntent |
Intent: The intent which will be combined with the parent's PendingIntent in order to determine the behavior of the response This value cannot be null . |
fromPendingIntent
open static fun fromPendingIntent(pendingIntent: PendingIntent): RemoteViews.RemoteResponse
Creates a response which sends a pending intent as part of the response. The source bounds (Intent#getSourceBounds()
) of the intent will be set to the bounds of the target view in screen space. Note that any activity options associated with the mPendingIntent may get overridden before starting the intent.