ClipData 類別

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

剪貼板上截斷資料的表示。

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

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

繼承: Object

JavaObject

Object
ClipData

屬性: RegisterAttribute

實作: IParcelable IJavaObject IJavaPeerable IDisposable

備註

剪貼板上截斷資料的表示。

ClipData 是一種複雜型態，包含一個或多個 Item 實例，每個 Item 實例可包含一個或多個資料的表示。為了讓使用者看到，它也有標籤。

剪輯資料包含一個 ClipDescription，用以描述關於剪輯的重要元資料。特別是，必須 ClipDescription#getMimeType(int) getDescription().getMimeType(int) 回傳正確的 MIME 類型，描述該片段中的資料。若要正確構建具有正確 MIME 類型的片段，請使用 #newPlainText(CharSequence, CharSequence)、 #newUri(ContentResolver, CharSequence, Uri)、 #newIntent(CharSequence, Intent)和。

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

<div class=“特殊參考”><h3>開發者指南</h3>

想了解更多關於使用剪貼簿框架的資訊，請閱讀複製貼上開發者指南。

</div>

「ImplementingPaste」><h3>實作貼上或 drop</h3>

若要將 ClipData 物件貼上或丟入應用程式，應用程式必須正確解讀該資料以便使用。如果 Item 它包含簡單的文字或意圖，則幾乎沒什麼可做的：文字只能被解讀為文字，意圖通常用於建立捷徑（例如在主畫面放置圖示）或其他動作。

如果你只想要剪裁資料的文字表示，可以使用方便法 Item#coerceToText Item.coerceToText。在這種情況下，通常不需要擔心由 ClipDescription#getMimeType(int) getDescription().getMimeType(int)報告的 MIME 類型，因為任何剪輯項目都可以轉換成字串。

更複雜的交換則會透過 URI，特別是「內容：」URI。內容 URI 允許 ClipData 項目的接收者與持有資料的內容提供者密切互動，以協商資料的傳輸。片段還必須填滿可用的 MIME 類型; #newUri(ContentResolver, CharSequence, Uri) 我會處理正確的操作。

舉例來說，這裡有一個簡單的記事本應用程式的貼上功能。從剪貼簿擷取資料時，它可以做兩種事：如果夾板包含對現有音符的 URI 參考，則會將該音符的整個結構複製到新的音符中;否則，它會強制將片段壓縮成文字，並以此作為新筆記的內容。

{

Java 文件 android.content.ClipData。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
ClipData(ClipData)	建立一個新片段，複製另一個片段。
ClipData(ClipDescription, ClipData+Item)	建立一個新片段，複製另一個片段。
ClipData(ICharSequence, String[], ClipData+Item)	建立一個新片段，複製另一個片段。
ClipData(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
ClipData(String, String[], ClipData+Item)	建立一個新片段。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Creator
Description	回傳與此資料相關的內容 `ClipDescription` ，描述其內容。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
ItemCount	回傳剪輯資料中的項目數量。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
AddItem(ClipData+Item)	在整個 ClipData 容器中新增一個項目。
AddItem(ContentResolver, ClipData+Item)	在整個 ClipData 容器中新增一個項目。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
DescribeContents()	描述此 Parcelable 的組建表示中包含的特殊物件種類。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
Equals(Object)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
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)	建立一個新的 ClipData，儲存一個帶有 MIME 類型的 `ClipDescription#MIMETYPE_TEXT_INTENT`Intent。
NewIntent(String, Intent)	建立一個新的 ClipData，儲存一個帶有 MIME 類型的 `ClipDescription#MIMETYPE_TEXT_INTENT`Intent。
NewPlainText(ICharSequence, ICharSequence)	建立一個新的 ClipData，儲存型別 `ClipDescription#MIMETYPE_TEXT_PLAIN`為的資料。
NewPlainText(String, String)	建立一個新的 ClipData，儲存型別 `ClipDescription#MIMETYPE_TEXT_PLAIN`為的資料。
NewRawUri(ICharSequence, Uri)	建立一個新的 ClipData，儲存一個 MIME 類型的 `ClipDescription#MIMETYPE_TEXT_URILIST`URI。
NewRawUri(String, Uri)	建立一個新的 ClipData，儲存一個 MIME 類型的 `ClipDescription#MIMETYPE_TEXT_URILIST`URI。
NewUri(ContentResolver, ICharSequence, Uri)	建立一個新的 ClipData，儲存一個 URI。
NewUri(ContentResolver, String, Uri)	建立一個新的 ClipData，儲存一個 URI。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	把這個物體壓扁成一個包裹。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	剪貼板上截斷資料的表示。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	剪貼板上截斷資料的表示。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	剪貼板上截斷資料的表示。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於