ClipData 类

定义

[Android.Runtime.Register("android/content/ClipData", DoNotGenerateAcw=true)]
public class ClipData : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/ClipData", DoNotGenerateAcw=true)>]
type ClipData = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

继承

Object

Object

ClipData

属性

RegisterAttribute

实现

IParcelable IJavaObject IJavaPeerable IDisposable

注解

剪贴板上剪裁的数据的表示形式。

ClipData 是包含一个或多个项实例的复杂类型，每个实例可以保存一个或多个数据项的表示形式。 若要向用户显示，它还具有标签。

ClipData 包含一个 ClipDescription描述有关剪辑的重要元数据。 具体而言，它 ClipDescription#getMimeType(int) getDescription().getMimeType(int) 必须返回正确的 MIME 类型（s）来描述剪辑中的数据。 有关正确构造具有正确 MIME 类型、使用 #newPlainText(CharSequence, CharSequence)和 #newUri(ContentResolver, CharSequence, Uri)的 #newIntent(CharSequence, Intent)剪辑的帮助。

每个项实例可以是三个主要数据类之一：文本的简单 CharSequence、单个意向对象或 Uri。 有关详细信息，请参阅 Item。

<div class=“special reference”><h3>Developer Guides</h3>

有关使用剪贴板框架的详细信息，请阅读 复制和粘贴 开发人员指南。

</Div>

“ImplementingPaste”><h3>实现粘贴或删除</h3>

若要在应用程序中实现 ClipData 对象的粘贴或删除，应用程序必须正确解释数据以供其使用。 Item如果它包含的是简单文本或意向，则没有什么可完成的：文本只能解释为文本，并且意向通常用于创建快捷方式（如在主屏幕上放置图标）或其他操作。

如果需要的是剪切数据的文本表示形式，则可以使用便捷方法 Item#coerceToText Item.coerceToText。 在这种情况下，通常无需担心所 ClipDescription#getMimeType(int) getDescription().getMimeType(int)报告的 MIME 类型，因为始终可以将任何剪辑项转换为字符串。

更复杂的交换将通过 URI 完成，特别是“内容：”URI。 内容 URI 允许 ClipData 项目的接收方与包含数据的 ContentProvider 密切交互，以便协商数据传输。 剪辑还必须用可用的 MIME 类型填充; #newUri(ContentResolver, CharSequence, Uri) 将负责正确执行此操作。

例如，下面是简单记事本应用程序的粘贴函数。 从剪贴板检索数据时，它可以执行以下两项操作：如果剪贴板包含对现有笔记的 URI 引用，则会将笔记的整个结构复制到新笔记中;否则，它只需将剪辑强制转换为文本，并将其用作新笔记的内容。

{ }

Java文档android.content.ClipData。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。