Developers
Most visited
Recently visited
DragAndDropPermissions
public
final
class
DragAndDropPermissions
extends Object
implements
Parcelable
| java.lang.Object | |
| ↳ | android.view.DragAndDropPermissions |
DragAndDropPermissions controls the access permissions for the content URIs associated
with a DragEvent.
Permission are granted when this object is created by Activity.requestDragAndDropPermissions.
Which permissions are granted is defined by the set of flags passed to View#startDragAndDrop(android.content.ClipData, View.DragShadowBuilder, Object, int) by the app that started the drag operation.
The lifecycle of the permissions is bound to the activity used to call requestDragAndDropPermissions. The
permissions are revoked when this activity is destroyed, or when release() is called,
whichever occurs first.
If you anticipate that your application will receive a large number of drops (e.g. document
editor), you should try to call release() on the obtained permissions as soon as they
are no longer required. Permissions can be added to your activity's
Activity#onSaveInstanceState bundle and later retrieved in order to manually release
the permissions once they are no longer needed.
Learn more about drag permissions in multi-window mode.
Summary
Inherited constants |
|---|
Fields | |
|---|---|
public
static
final
Creator<DragAndDropPermissions> |
CREATOR
|
Public methods | |
|---|---|
int
|
describeContents()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
void
|
release()
Revoke permissions explicitly. |
void
|
writeToParcel(Parcel destination, int flags)
Flatten this object in to a Parcel. |
Inherited methods | |
|---|---|
Fields
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 |
release
public void release ()
Revoke permissions explicitly.
writeToParcel
public void writeToParcel (Parcel destination, int flags)
Flatten this object in to a Parcel.
| Parameters | |
|---|---|
destination |
Parcel: The Parcel in which the object should be written. |
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 |