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 是包含一或多個 Item 實例的複雜類型，每個實例都可以保存一或多個資料項目目的表示。 若要向使用者顯示，它也具有標籤。

ClipData 包含 ClipDescription ，描述有關剪輯的重要中繼資料。 特別是，其 ClipDescription#getMimeType(int) getDescription().getMimeType(int) 必須傳回正確的 MIME 類型 (s) 描述剪輯中的資料。 如需正確建構具有正確 MIME 類型的剪輯的說明，請使用 #newPlainText(CharSequence, CharSequence) 、 #newUri(ContentResolver, CharSequence, Uri) 和 #newIntent(CharSequence, Intent) 。

每個 Item 實例可以是三個主要資料類別的其中一個：簡單的文字 CharSequence、單一 Intent 物件或 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 參考，它會將筆記的整個結構複製到新的附注中;否則，它只會將剪輯強制轉換成文字，並使用它做為新記事的內容。

{

的 android.content.ClipData JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。

建構函式

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 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。

方法

AddItem(ClipData+Item)	將新專案新增至整體 ClipData 容器。
AddItem(ContentResolver, ClipData+Item)	將新專案新增至整體 ClipData 容器。
Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
DescribeContents()	描述這個可封送處理標記法中包含的特殊物件種類。
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_URILIST URI 的新 ClipData。
NewRawUri(String, Uri)	建立含有 MIME 類型的 ClipDescription#MIMETYPE_TEXT_URILIST URI 的新 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)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	將這個 物件壓平合併至一個檔案。

明確介面實作

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)	剪貼簿上裁剪資料的標記法。