public static class ClipData.Item
extends Object
java.lang.Object | |
↳ | android.content.ClipData.Item |
Description of a single item in a ClipData.
The types than an individual item can currently contain are:
Public constructors |
|
---|---|
ClipData.Item(CharSequence text) Create an Item consisting of a single block of (possibly styled) text. |
|
ClipData.Item(CharSequence text, String htmlText) Create an Item consisting of a single block of (possibly styled) text, with an alternative HTML formatted representation. |
|
ClipData.Item(Intent intent) Create an Item consisting of an arbitrary Intent. |
|
ClipData.Item(Uri uri) Create an Item consisting of an arbitrary URI. |
|
ClipData.Item(CharSequence text, Intent intent, Uri uri) Create a complex Item, containing multiple representations of text, Intent, and/or URI. |
|
ClipData.Item(CharSequence text, String htmlText, Intent intent, Uri uri) Create a complex Item, containing multiple representations of text, HTML text, Intent, and/or URI. |
Public methods |
|
---|---|
String |
coerceToHtmlText(Context context) Turn this item into HTML text, regardless of the type of data it actually contains. |
CharSequence |
coerceToStyledText(Context context) Like |
CharSequence |
coerceToText(Context context) Turn this item into text, regardless of the type of data it actually contains. |
String |
getHtmlText() Retrieve the raw HTML text contained in this Item. |
Intent |
getIntent() Retrieve the raw Intent contained in this Item. |
CharSequence |
getText() Retrieve the raw text contained in this Item. |
Uri |
getUri() Retrieve the raw URI contained in this Item. |
String |
toString() Returns a string representation of the object. |
Inherited methods |
|
---|---|
![]() java.lang.Object
|
ClipData.Item (CharSequence text)
Create an Item consisting of a single block of (possibly styled) text.
Parameters | |
---|---|
text |
CharSequence
|
ClipData.Item (CharSequence text, String htmlText)
Create an Item consisting of a single block of (possibly styled) text, with an alternative HTML formatted representation. You must supply a plain text representation in addition to HTML text; coercion will not be done from HTML formated text into plain text.
Parameters | |
---|---|
text |
CharSequence
|
htmlText |
String
|
ClipData.Item (Intent intent)
Create an Item consisting of an arbitrary Intent.
Parameters | |
---|---|
intent |
Intent
|
ClipData.Item (Uri uri)
Create an Item consisting of an arbitrary URI.
Parameters | |
---|---|
uri |
Uri
|
ClipData.Item (CharSequence text, Intent intent, Uri uri)
Create a complex Item, containing multiple representations of text, Intent, and/or URI.
Parameters | |
---|---|
text |
CharSequence
|
intent |
Intent
|
uri |
Uri
|
ClipData.Item (CharSequence text, String htmlText, Intent intent, Uri uri)
Create a complex Item, containing multiple representations of text, HTML text, Intent, and/or URI. If providing HTML text, you must supply a plain text representation as well; coercion will not be done from HTML formated text into plain text.
Parameters | |
---|---|
text |
CharSequence
|
htmlText |
String
|
intent |
Intent
|
uri |
Uri
|
String coerceToHtmlText (Context context)
Turn this item into HTML text, regardless of the type of data it actually contains.
The algorithm for deciding what text to return is:
getHtmlText()
is non-null, return that. getText()
is non-null, return that, converting to valid HTML text. If this text contains style spans, Html.toHtml(Spanned)
is used to convert them to HTML formatting. getUri()
is non-null, try to retrieve its data as a text stream from its content provider. If the provider can supply text/html data, that will be preferred and returned as-is. Otherwise, any text/* data will be returned and escaped to HTML. If it is not a content: URI or the content provider does not supply a text representation, HTML text containing a link to the URI will be returned. getIntent()
is non-null, convert that to an intent: URI and return as an HTML link. Parameters | |
---|---|
context |
Context : The caller's Context, from which its ContentResolver and other things can be retrieved. |
Returns | |
---|---|
String |
Returns the item's representation as HTML text. |
CharSequence coerceToStyledText (Context context)
Like coerceToHtmlText(Context)
, but any text that would be returned as HTML formatting will be returned as text with style spans.
Parameters | |
---|---|
context |
Context : The caller's Context, from which its ContentResolver and other things can be retrieved. |
Returns | |
---|---|
CharSequence |
Returns the item's textual representation. |
CharSequence coerceToText (Context context)
Turn this item into text, regardless of the type of data it actually contains.
The algorithm for deciding what text to return is:
getText()
is non-null, return that. getUri()
is non-null, try to retrieve its data as a text stream from its content provider. If this succeeds, copy the text into a String and return it. If it is not a content: URI or the content provider does not supply a text representation, return the raw URI as a string. getIntent()
is non-null, convert that to an intent: URI and return it. Parameters | |
---|---|
context |
Context : The caller's Context, from which its ContentResolver and other things can be retrieved. |
Returns | |
---|---|
CharSequence |
Returns the item's textual representation. |
String getHtmlText ()
Retrieve the raw HTML text contained in this Item.
Returns | |
---|---|
String |
Intent getIntent ()
Retrieve the raw Intent contained in this Item.
Returns | |
---|---|
Intent |
CharSequence getText ()
Retrieve the raw text contained in this Item.
Returns | |
---|---|
CharSequence |
String toString ()
Returns a string representation of the object. In general, the toString
method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@
', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |