ClipData Klasse

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Darstellung einer beschnittenen Daten in der Zwischenablage.

[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

Vererbung: Object

Object
ClipData

Attribute: RegisterAttribute

Implementiert: IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Darstellung einer beschnittenen Daten in der Zwischenablage.

ClipData ist ein komplexer Typ, der eine oder mehrere Elementinstanzen enthält, von denen jede eine oder mehrere Darstellungen eines Datenelements enthalten kann. Für die Anzeige für den Benutzer verfügt er auch über eine Bezeichnung.

Ein ClipData enthält eine ClipDescription, die wichtige Metadaten über den Clip beschreibt. Insbesondere müssen die richtigen MIME-Typen zurückgegeben werden, ClipDescription#getMimeType(int) getDescription().getMimeType(int) die die Daten im Clip beschreiben. Hilfe beim ordnungsgemäßen Erstellen eines Clips mit dem richtigen MIME-Typ, verwendung #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)und #newIntent(CharSequence, Intent).

Jede Item-Instanz kann eine von drei Hauptklassen von Daten sein: eine einfache CharSequence von Text, ein einzelnes Intent-Objekt oder ein URI. Weitere Informationen finden Sie unter Item.

<div class="special reference"><h3>Developer Guides</h3>

Weitere Informationen zur Verwendung des Frameworks für die Zwischenablage finden Sie im Entwicklerhandbuch zum Kopieren und Einfügen .

</div>

"ImplementingPaste"><h3>Implementing Paste or Drop</h3>

Um ein Einfügen oder Ablegen eines ClipData-Objekts in eine Anwendung zu implementieren, muss die Anwendung die Daten für die Verwendung richtig interpretieren. Wenn es Item sich um einfachen Text oder eine Absicht handelt, gibt es wenig zu tun: Text kann nur als Text interpretiert werden, und eine Absicht wird in der Regel zum Erstellen von Verknüpfungen (z. B. Platzieren von Symbolen auf dem Startbildschirm) oder anderen Aktionen verwendet.

Wenn Sie nur die textbezogene Darstellung der beschnittenen Daten wünschen, können Sie die Komfortmethode Item#coerceToText Item.coerceToTextverwenden. In diesem Fall ist es in der Regel nicht erforderlich, sich um die mime-Typen zu kümmern, die ClipDescription#getMimeType(int) getDescription().getMimeType(int)gemeldet werden, da jedes Clipelement immer in eine Zeichenfolge konvertiert werden kann.

Komplexerer Austausch erfolgt über URIs, insbesondere "content:"-URIs. Ein Inhalts-URI ermöglicht es dem Empfänger eines ClipData-Elements, eng mit dem ContentProvider zu interagieren, der die Daten enthält, um die Übertragung dieser Daten auszuhandeln. Der Clip muss auch mit den verfügbaren MIME-Typen ausgefüllt werden; #newUri(ContentResolver, CharSequence, Uri) kümmert sich darum, dies richtig zu tun.

Hier ist beispielsweise die Einfügefunktion einer einfachen Editor-Anwendung. Beim Abrufen der Daten aus der Zwischenablage kann dies zwei Dinge tun: Wenn die Zwischenablage einen URI-Verweis auf eine vorhandene Notiz enthält, kopiert sie die gesamte Struktur der Notiz in eine neue Notiz; andernfalls wird der Clip einfach in Text umgewandelt und als Inhalt der neuen Notiz verwendet.

{

Java Dokumentation für android.content.ClipData.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
ClipData(ClipData)	Erstellen Sie einen neuen Clip, der eine Kopie eines anderen Clips ist.
ClipData(ClipDescription, ClipData+Item)	Erstellen Sie einen neuen Clip, der eine Kopie eines anderen Clips ist.
ClipData(ICharSequence, String[], ClipData+Item)	Erstellen Sie einen neuen Clip, der eine Kopie eines anderen Clips ist.
ClipData(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.
ClipData(String, String[], ClipData+Item)	Erstellen Sie einen neuen Clip.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Creator
Description	Geben Sie die `ClipDescription` zugeordneten Daten zurück, die beschreiben, was sie enthält.
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
ItemCount	Gibt die Anzahl der Elemente in den Clipdaten zurück.
JniIdentityHashCode	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
JniPeerMembers	Darstellung einer beschnittenen Daten in der Zwischenablage.
PeerReference	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
AddItem(ClipData+Item)	Fügen Sie dem gesamten ClipData-Container ein neues Element hinzu.
AddItem(ContentResolver, ClipData+Item)	Fügen Sie dem gesamten ClipData-Container ein neues Element hinzu.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
DescribeContents()	Beschreiben Sie die Arten von speziellen Objekten, die in der Marshalldarstellung dieser Paketable enthalten sind.
Dispose()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Dispose(Boolean)	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetItemAt(Int32)	Gibt ein einzelnes Element innerhalb der Clipdaten zurück.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Erstellen Sie eine neue ClipData mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Erstellen Sie eine neue ClipData mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Erstellen Sie einen neuen ClipData mit einem Intent-Typ mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_INTENT`.
NewIntent(String, Intent)	Erstellen Sie einen neuen ClipData mit einem Intent-Typ mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_INTENT`.
NewPlainText(ICharSequence, ICharSequence)	Erstellen Sie eine neue ClipData mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Erstellen Sie eine neue ClipData mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Erstellen Sie einen neuen ClipData mit einem URI mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_URILIST`.
NewRawUri(String, Uri)	Erstellen Sie einen neuen ClipData mit einem URI mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_URILIST`.
NewUri(ContentResolver, ICharSequence, Uri)	Erstellen Sie einen neuen ClipData-Objekt, der einen URI enthält.
NewUri(ContentResolver, String, Uri)	Erstellen Sie einen neuen ClipData-Objekt, der einen URI enthält.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Flachen Sie dieses Objekt in ein Paket.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.Finalized()	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Darstellung einer beschnittenen Daten in der Zwischenablage. (Geerbt von Object)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `TResult`zu `self` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Darstellung einer beschnittenen Daten in der Zwischenablage.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `TResult`zu `self` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: