InputContentInfo
public
final
class
InputContentInfo
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.view.inputmethod.InputContentInfo |
A container object with which input methods can send content files to the target application.
Summary
Inherited constants |
---|
Fields | |
---|---|
public
static
final
Creator<InputContentInfo> |
CREATOR
Used to make this class parcelable. |
Public constructors | |
---|---|
InputContentInfo(Uri contentUri, ClipDescription description)
Constructs |
|
InputContentInfo(Uri contentUri, ClipDescription description, Uri linkUri)
Constructs |
Public methods | |
---|---|
int
|
describeContents()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
Uri
|
getContentUri()
|
ClipDescription
|
getDescription()
|
Uri
|
getLinkUri()
|
void
|
releasePermission()
Releases a temporary read-only access permission for content URI associated with this object. |
void
|
requestPermission()
Requests a temporary |
void
|
writeToParcel(Parcel dest, int flags)
Used to package this object into a |
Inherited methods | |
---|---|
Fields
CREATOR
public static final Creator<InputContentInfo> CREATOR
Used to make this class parcelable.
Public constructors
InputContentInfo
public InputContentInfo (Uri contentUri, ClipDescription description)
Constructs InputContentInfo
object only with mandatory data.
Parameters | |
---|---|
contentUri |
Uri : Content URI to be exported from the input method.
This cannot be null . |
description |
ClipDescription : A ClipDescription object that contains the metadata of
contentUri such as MIME type(s). This object cannot be null . Also
ClipDescription.getLabel() should be describing the content specified by
contentUri for accessibility reasons. |
InputContentInfo
public InputContentInfo (Uri contentUri, ClipDescription description, Uri linkUri)
Constructs InputContentInfo
object with additional link URI.
Parameters | |
---|---|
contentUri |
Uri : Content URI to be exported from the input method.
This cannot be null . |
description |
ClipDescription : A ClipDescription object that contains the metadata of
contentUri such as MIME type(s). This object cannot be null . Also
ClipDescription.getLabel() should be describing the content specified by
contentUri for accessibility reasons. |
linkUri |
Uri : An optional http or https URI. The editor author may provide
a way to navigate the user to the specified web page if this is not null . |
Throws | |
---|---|
InvalidParameterException |
if any invalid parameter is specified. |
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 |
getContentUri
public Uri getContentUri ()
Returns | |
---|---|
Uri |
Content URI with which the content can be obtained.
This value cannot be null . |
getDescription
public ClipDescription getDescription ()
Returns | |
---|---|
ClipDescription |
ClipDescription object that contains the metadata of #getContentUri()
such as MIME type(s). ClipDescription.getLabel() can be used for accessibility
purpose.
This value cannot be null . |
getLinkUri
public Uri getLinkUri ()
Returns | |
---|---|
Uri |
An optional http or https URI that is related to this content.
This value may be null . |
releasePermission
public void releasePermission ()
Releases a temporary read-only access permission for content URI associated with this object.
Does nothing if the temporary permission is not granted.
requestPermission
public void requestPermission ()
Requests a temporary read-only
access permission for the content URI associated with this object.
The lifecycle of the permission granted here is tied to this object instance. If the
permission is not released explicitly via releasePermission()
, it will be
released automatically when there are no more references to this object.
Does nothing if the temporary permission is already granted.
writeToParcel
public void writeToParcel (Parcel dest, int flags)
Used to package this object into a Parcel
.
Parameters | |
---|---|
dest |
Parcel : The Parcel to be written. |
flags |
int : The flags used for parceling. |