# ClipData.Item

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Item

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/content/ClipData.Item "View this page in Java")  

```
open class Item
```

|---|----------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                 ||
| ↳ | [android.content.ClipData.Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#) |

Description of a single item in a ClipData.

The types than an individual item can currently contain are:

- Text: a basic string of text. This is actually a CharSequence, so it can be formatted text supported by corresponding Android built-in style spans. (Custom application spans are not supported and will be stripped when transporting through the clipboard.)
- Intent: an arbitrary Intent object. A typical use is the shortcut to create when pasting a clipped item on to the home screen.
- Uri: a URI reference. This may be any URI (such as an http: URI representing a bookmark), however it is often a content: URI. Using content provider references as clips like this allows an application to share complex or large clips through the standard content provider facilities.

## Summary

|                                                          Nested classes                                                           ||
|---|--------------------------------------------------------------------------------------------------------------------------------|
|   | [Builder](https://developer.android.com/reference/kotlin/android/content/ClipData.Item.Builder) A builder for a ClipData Item. |

|                                                                                                                                                                                                                                                                                                                                 Public constructors                                                                                                                                                                                                                                                                                                                                  ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(android.content.Intent))`(`intent:` `[Intent](https://developer.android.com/reference/kotlin/android/content/Intent)!`)` Create an Item consisting of an arbitrary Intent.                                                                                                                                                                                                                                                                                                                                                                                                               |
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(android.net.Uri))`(`uri:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)!`)` Create an Item consisting of an arbitrary URI.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(kotlin.CharSequence))`(`text:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` Create an Item consisting of a single block of (possibly styled) text.                                                                                                                                                                                                                                                                                                                                                                                 |
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(kotlin.CharSequence,%20android.content.Intent,%20android.net.Uri))`(`text:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`, `intent:` `[Intent](https://developer.android.com/reference/kotlin/android/content/Intent)!`, `uri:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)!`)` Create a complex Item, containing multiple representations of text, Intent, and/or URI.                                                                                                                              |
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(kotlin.CharSequence,%20kotlin.String))`(`text:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`, `htmlText:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`)` Create an Item consisting of a single block of (possibly styled) text, with an alternative HTML formatted representation.                                                                                                                                                                                                            |
| [Item](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#Item(kotlin.CharSequence,%20kotlin.String,%20android.content.Intent,%20android.net.Uri))`(`text:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`, `htmlText:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `intent:` `[Intent](https://developer.android.com/reference/kotlin/android/content/Intent)!`, `uri:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)!`)` Create a complex Item, containing multiple representations of text, HTML text, Intent, and/or URI. |

|                                                                                                                                                                                                                                                                                                               Public methods                                                                                                                                                                                                                                                                                                               ||
|--------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!                        | [coerceToHtmlText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#coerceToHtmlText(android.content.Context))`(`context:` `[Context](https://developer.android.com/reference/kotlin/android/content/Context)!`)` Turn this item into HTML text, regardless of the type of data it actually contains.                                                                                                                                                                                            |
| open[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!           | [coerceToStyledText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#coerceToStyledText(android.content.Context))`(`context:` `[Context](https://developer.android.com/reference/kotlin/android/content/Context)!`)` Like[coerceToHtmlText(android.content.Context)](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#coerceToHtmlText(android.content.Context)), but any text that would be returned as HTML formatting will be returned as text with style spans. |
| open[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!           | [coerceToText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#coerceToText(android.content.Context))`(`context:` `[Context](https://developer.android.com/reference/kotlin/android/content/Context)!`)` Turn this item into text, regardless of the type of data it actually contains.                                                                                                                                                                                                         |
| open[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!                        | [getHtmlText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getHtmlText())`()` Retrieve the raw HTML text contained in this Item.                                                                                                                                                                                                                                                                                                                                                             |
| open[Intent](https://developer.android.com/reference/kotlin/android/content/Intent)!                         | [getIntent](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getIntent())`()` Retrieve the raw Intent contained in this Item.                                                                                                                                                                                                                                                                                                                                                                    |
| open[IntentSender](https://developer.android.com/reference/kotlin/android/content/IntentSender)?             | [getIntentSender](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getIntentSender())`()` Returns the[IntentSender](https://developer.android.com/reference/kotlin/android/content/IntentSender)in this Item.                                                                                                                                                                                                                                                                                    |
| open[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!           | [getText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getText())`()` Retrieve the raw text contained in this Item.                                                                                                                                                                                                                                                                                                                                                                          |
| open[TextLinks](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextLinks.html#)? | [getTextLinks](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#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.                                                                                                                                                                                                                                                      |
| open[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)!                             | [getUri](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getUri())`()` Retrieve the raw URI contained in this Item.                                                                                                                                                                                                                                                                                                                                                                             |
| open[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)                         | [toString](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#toString())`()` <br />                                                                                                                                                                                                                                                                                                                                                                                                               |

## Public constructors

### Item

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(intent: Intent!)
```

Create an Item consisting of an arbitrary Intent.  

### Item

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(uri: Uri!)
```

Create an Item consisting of an arbitrary URI.  

### Item

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(text: CharSequence!)
```

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

### Item

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(
    text: CharSequence!, 
    intent: Intent!, 
    uri: Uri!)
```

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

### Item

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(
    text: CharSequence!, 
    htmlText: String!)
```

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

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Item(
    text: CharSequence!, 
    htmlText: String!, 
    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.

## Public methods

### coerceToHtmlText

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun coerceToHtmlText(context: Context!): String!
```

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](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getHtmlText())is non-null, return that.
- If[getText](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getText())is non-null, return that, converting to valid HTML text. If this text contains style spans,[Html.toHtml(Spanned)](https://developer.android.com/reference/kotlin/android/text/Html.html#toHtml(android.text.Spanned))is used to convert them to HTML formatting.
- If[getUri](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#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](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getIntent())is non-null, convert that to an intent: URI and return as an HTML link.
- Otherwise, return an empty string.

|                                                                                      Parameters                                                                                       ||
|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `context` | [Context](https://developer.android.com/reference/kotlin/android/content/Context)!:The caller's Context, from which its ContentResolver and other things can be retrieved. |

|                                                               Return                                                               ||
|-----------------------------------------------------------------------------------|-------------------------------------------------|
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)! | Returns the item's representation as HTML text. |

### coerceToStyledText

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun coerceToStyledText(context: Context!): CharSequence!
```

Like[coerceToHtmlText(android.content.Context)](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#coerceToHtmlText(android.content.Context)), but any text that would be returned as HTML formatting will be returned as text with style spans.

|                                                                                      Parameters                                                                                       ||
|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `context` | [Context](https://developer.android.com/reference/kotlin/android/content/Context)!:The caller's Context, from which its ContentResolver and other things can be retrieved. |

|                                                                   Return                                                                   ||
|------------------------------------------------------------------------------------------------|--------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | Returns the item's textual representation. |

### coerceToText

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun coerceToText(context: Context!): CharSequence!
```

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](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getText())is non-null, return that.
- If[getUri](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#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](https://developer.android.com/reference/kotlin/android/content/ClipData.Item#getIntent())is non-null, convert that to an intent: URI and return it.
- Otherwise, return an empty string.

|                                                                                      Parameters                                                                                       ||
|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `context` | [Context](https://developer.android.com/reference/kotlin/android/content/Context)!:The caller's Context, from which its ContentResolver and other things can be retrieved. |

|                                                                   Return                                                                   ||
|------------------------------------------------------------------------------------------------|--------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | Returns the item's textual representation. |

### getHtmlText

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getHtmlText(): String!
```

Retrieve the raw HTML text contained in this Item.  

### getIntent

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getIntent(): Intent!
```

Retrieve the raw Intent contained in this Item.  

### getIntentSender

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getIntentSender(): IntentSender?
```

Returns the[IntentSender](https://developer.android.com/reference/kotlin/android/content/IntentSender)in this Item.

|                                                         Return                                                         ||
|----------------------------------------------------------------------------------------------|--------------------------|
| [IntentSender](https://developer.android.com/reference/kotlin/android/content/IntentSender)? | This value may be`null`. |

### getText

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getText(): CharSequence!
```

Retrieve the raw text contained in this Item.  

### getTextLinks

Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getTextLinks(): TextLinks?
```

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.  
**See Also**

- [android.content.ClipDescription#getConfidenceScore(String)](https://developer.android.com/reference/kotlin/android/content/ClipDescription#getConfidenceScore(kotlin.String))  

### getUri

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun getUri(): Uri!
```

Retrieve the raw URI contained in this Item.  

### toString

Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun toString(): String
```

|                                                          Return                                                          ||
|----------------------------------------------------------------------------------|----------------------------------------|
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | a string representation of the object. |