Most visited

Recently visited

Added in API level 11

ClipData.Item

public static class ClipData.Item
extends Object

java.lang.Object
   ↳ android.content.ClipData.Item


ClipData中单个项目的描述。

目前可以包含的类型不是单个项目,而是:

Summary

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)

coerceToHtmlText(Context)一样,但是任何将作为HTML格式返回的文本都将作为带有样式跨度的文本返回。

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

Public constructors

ClipData.Item

Added in API level 11
ClipData.Item (CharSequence text)

创建一个由单个块(可能为样式)文本组成的项目。

Parameters
text CharSequence

ClipData.Item

Added in API level 16
ClipData.Item (CharSequence text, 
                String htmlText)

使用替代的HTML格式化表示形式创建一个项目,该项目由一个(可能为样式的)文本块组成。 除HTML文本外,您还必须提供纯文本表示形式; 强制不会从HTML格式的文本转换为纯文本。

Parameters
text CharSequence
htmlText String

ClipData.Item

Added in API level 11
ClipData.Item (Intent intent)

创建一个包含任意意图的项目。

Parameters
intent Intent

ClipData.Item

Added in API level 11
ClipData.Item (Uri uri)

创建一个由任意URI组成的项目。

Parameters
uri Uri

ClipData.Item

Added in API level 11
ClipData.Item (CharSequence text, 
                Intent intent, 
                Uri uri)

创建一个复杂的项目,其中包含文本,意图和/或URI的多个表示。

Parameters
text CharSequence
intent Intent
uri Uri

ClipData.Item

Added in API level 16
ClipData.Item (CharSequence text, 
                String htmlText, 
                Intent intent, 
                Uri uri)

创建一个复杂的项目,其中包含文本,HTML文本,Intent和/或URI的多个表示。 如果提供HTML文本,则还必须提供纯文本表示形式; 强制不会从HTML格式的文本转换为纯文本。

Parameters
text CharSequence
htmlText String
intent Intent
uri Uri

Public methods

coerceToHtmlText

Added in API level 16
String coerceToHtmlText (Context context)

无论它实际包含的数据类型如何,都可以将此项目转换为HTML文本。

决定返回什么文本的算法是:

  • 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.

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.

coerceToStyledText

Added in API level 16
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.

coerceToText

Added in API level 11
CharSequence coerceToText (Context context)

无论其实际包含的数据类型如何,都可以将此项目转换为文本。

决定返回什么文本的算法是:

  • 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.

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.

getHtmlText

Added in API level 16
String getHtmlText ()

检索此项目中包含的原始HTML文本。

Returns
String

getIntent

Added in API level 11
Intent getIntent ()

检索此项目中包含的原始Intent。

Returns
Intent

getText

Added in API level 11
CharSequence getText ()

检索此项目中包含的原始文本。

Returns
CharSequence

getUri

Added in API level 11
Uri getUri ()

检索此Item中包含的原始URI。

Returns
Uri

toString

Added in API level 11
String toString ()

返回对象的字符串表示形式。 一般来说, toString方法返回一个“文本表示”这个对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

Hooray!