ClipData 類別

定義

命名空間:

Android.Content

組件:

Mono.Android.dll

剪貼簿上裁剪數據的表示。

[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類型，以描述剪輯中的數據。 如需正確建構具有正確 MIME 類型的剪輯的說明，請使用 #newPlainText(CharSequence, CharSequence)、 #newUri(ContentResolver, CharSequence, Uri)和 #newIntent(CharSequence, Intent)。

每個項目實例可以是三個主要數據類別之一：文字的簡單 CharSequence、單一 Intent 物件或 Uri。 如需詳細資訊，請參閱 Item。

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

如需使用剪貼簿架構的詳細資訊，請參閱 複製和貼上 開發人員指南。

</div>

“ImplementingPaste”><h3>實作 Paste 或 Drop</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 參考，則會將筆記的整個結構複製到新的附注中：否則，它只會強制剪輯為文字，並使用該做為新記事的內容。

{

的 android.content.ClipDataJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

ClipData(ClipData)	建立新的剪輯，這是另一個剪輯的複本。
ClipData(ClipDescription, ClipData+Item)	建立新的剪輯，這是另一個剪輯的複本。
ClipData(ICharSequence, String[], ClipData+Item)	建立新的剪輯，這是另一個剪輯的複本。
ClipData(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
ClipData(String, String[], ClipData+Item)	建立新的剪輯。

屬性

Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Creator
Description	ClipDescription傳回與此數據相關聯的 ，描述其包含的內容。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
ItemCount	傳回剪輯數據中的項目數。
JniIdentityHashCode	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
JniPeerMembers	剪貼簿上裁剪數據的表示。
PeerReference	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。

方法

AddItem(ClipData+Item)	將新專案新增至整體 ClipData 容器。
AddItem(ContentResolver, ClipData+Item)	將新專案新增至整體 ClipData 容器。
Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
DescribeContents()	描述此 Parcelable 封送處理表示中包含的特殊物件種類。
Dispose()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
Dispose(Boolean)	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetItemAt(Int32)	傳回剪輯數據內的單一專案。
JavaFinalize()	當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object)
NewHtmlText(ICharSequence, ICharSequence, String)	建立新的 ClipData 保存型 ClipDescription#MIMETYPE_TEXT_HTML別的數據。
NewHtmlText(String, String, String)	建立新的 ClipData 保存型 ClipDescription#MIMETYPE_TEXT_HTML別的數據。
NewIntent(ICharSequence, Intent)	建立具有MIME類型的 ClipDescription#MIMETYPE_TEXT_INTENT意圖的新 ClipData。
NewIntent(String, Intent)	建立具有MIME類型的 ClipDescription#MIMETYPE_TEXT_INTENT意圖的新 ClipData。
NewPlainText(ICharSequence, ICharSequence)	建立新的 ClipData 保存型 ClipDescription#MIMETYPE_TEXT_PLAIN別的數據。
NewPlainText(String, String)	建立新的 ClipData 保存型 ClipDescription#MIMETYPE_TEXT_PLAIN別的數據。
NewRawUri(ICharSequence, Uri)	建立具有MIME類型的 ClipDescription#MIMETYPE_TEXT_URILISTURI的新 ClipData。
NewRawUri(String, Uri)	建立具有MIME類型的 ClipDescription#MIMETYPE_TEXT_URILISTURI的新 ClipData。
NewUri(ContentResolver, ICharSequence, Uri)	建立保存 URI 的新 ClipData。
NewUri(ContentResolver, String, Uri)	建立保存 URI 的新 ClipData。
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
ToArray<T>()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	將中的這個物件扁平化為 Parcel。

明確介面實作

IJavaPeerable.Disposed()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.Finalized()	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	剪貼簿上裁剪數據的表示。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	剪貼簿上裁剪數據的表示。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	剪貼簿上裁剪數據的表示。
GetJniTypeName(IJavaPeerable)	剪貼簿上裁剪數據的表示。