ClipData.Item

Item

public Item (CharSequence text)

Create an Item consisting of a single block of (possibly styled) text.

Item

public 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 formatted text into plain text.

Warning: Use content: URI for sharing large clip data. ClipData.Item doesn't accept an HTML text if it's larger than 800KB.

Item

public Item (Intent intent)

Create an Item consisting of an arbitrary Intent.

Item

public Item (Uri uri)

Create an Item consisting of an arbitrary URI.

Item

public Item (CharSequence text, 
                Intent intent, 
                Uri uri)

Create a complex Item, containing multiple representations of text, Intent, and/or URI.

Item

public 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 formatted text into plain text.

coerceToHtmlText

public 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:

• If getHtmlText() is non-null, return that.
• If 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.
• If 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.
• If getIntent() is non-null, convert that to an intent: URI and return as an HTML link.
• Otherwise, return an empty string.

coerceToStyledText

public CharSequence coerceToStyledText (Context context)

Like coerceToHtmlText(android.content.Context), but any text that would be returned as HTML formatting will be returned as text with style spans.

coerceToText

public 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:

• If getText() is non-null, return that.
• If 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.
• If getIntent() is non-null, convert that to an intent: URI and return it.
• Otherwise, return an empty string.

getHtmlText

public String getHtmlText ()

Retrieve the raw HTML text contained in this Item.

getIntent

public Intent getIntent ()

Retrieve the raw Intent contained in this Item.

getIntentSender

public IntentSender getIntentSender ()

Returns the IntentSender in this Item.

getText

public CharSequence getText ()

Retrieve the raw text contained in this Item.

getTextLinks

public TextLinks getTextLinks ()

Returns the results of text classification run on the raw text contained in this item, if it was performed, and if any entities were found in the text. Classification is generally only performed on the first item in clip data, and only if the text is below a certain length.

Returns null if classification was not performed, or if no entities were found in the text.

getUri

public Uri getUri ()

Retrieve the raw URI contained in this Item.

toString

public String toString ()

Returns a string representation of the object.