public static class ClipData.Item
extends Object
java.lang.Object | |
↳ | android.content.ClipData.Item |
ClipData中单个项目的描述。
目前可以包含的类型不是单个项目,而是:
Public constructors |
|
---|---|
ClipData.Item(CharSequence text) 创建一个由单个块(可能为样式)文本组成的项目。 |
|
ClipData.Item(CharSequence text, String htmlText) 使用替代的HTML格式化表示形式创建一个项目,该项目由一个(可能为样式的)文本块组成。 |
|
ClipData.Item(Intent intent) 创建一个包含任意意图的项目。 |
|
ClipData.Item(Uri uri) 创建一个由任意URI组成的项目。 |
|
ClipData.Item(CharSequence text, Intent intent, Uri uri) 创建一个复杂的项目,其中包含文本,意图和/或URI的多个表示。 |
|
ClipData.Item(CharSequence text, String htmlText, Intent intent, Uri uri) 创建一个复杂的项目,其中包含文本,HTML文本,Intent和/或URI的多个表示。 |
Public methods |
|
---|---|
String |
coerceToHtmlText(Context context) 无论它实际包含的数据类型如何,都可以将此项目转换为HTML文本。 |
CharSequence |
coerceToStyledText(Context context) 像 |
CharSequence |
coerceToText(Context context) 无论其实际包含的数据类型如何,都可以将此项目转换为文本。 |
String |
getHtmlText() 检索此项目中包含的原始HTML文本。 |
Intent |
getIntent() 检索此项目中包含的原始Intent。 |
CharSequence |
getText() 检索此项目中包含的原始文本。 |
Uri |
getUri() 检索此Item中包含的原始URI。 |
String |
toString() 返回对象的字符串表示形式。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
ClipData.Item (CharSequence text)
创建一个由单个块(可能为样式)文本组成的项目。
Parameters | |
---|---|
text |
CharSequence
|
ClipData.Item (CharSequence text, String htmlText)
使用替代的HTML格式化表示形式创建一个项目,该项目由一个(可能为样式的)文本块组成。 除HTML文本外,您还必须提供纯文本表示形式; 强制不会从HTML格式的文本转换为纯文本。
Parameters | |
---|---|
text |
CharSequence
|
htmlText |
String
|
ClipData.Item (Intent intent)
创建一个包含任意意图的项目。
Parameters | |
---|---|
intent |
Intent
|
ClipData.Item (CharSequence text, Intent intent, Uri uri)
创建一个复杂的项目,其中包含文本,意图和/或URI的多个表示。
Parameters | |
---|---|
text |
CharSequence
|
intent |
Intent
|
uri |
Uri
|
ClipData.Item (CharSequence text, String htmlText, Intent intent, Uri uri)
创建一个复杂的项目,其中包含文本,HTML文本,Intent和/或URI的多个表示。 如果提供HTML文本,则还必须提供纯文本表示形式; 强制不会从HTML格式的文本转换为纯文本。
Parameters | |
---|---|
text |
CharSequence
|
htmlText |
String
|
intent |
Intent
|
uri |
Uri
|
String coerceToHtmlText (Context context)
无论它实际包含的数据类型如何,都可以将此项目转换为HTML文本。
决定返回什么文本的算法是:
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)
像 coerceToHtmlText(Context)
一样,但是任何将作为HTML格式返回的文本将作为带有样式跨度的文本返回。
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)
无论其实际包含的数据类型如何,都可以将此项目转换为文本。
决定返回什么文本的算法是:
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 toString ()
返回对象的字符串表示形式。 一般来说, toString
方法返回一个“文本表示”这个对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |