ClipData Klasse

Referenz

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 eines abgeschnittenen 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 eines abgeschnittenen Daten in der Zwischenablage.

ClipData ist ein komplexer Typ, der eine oder mehrere Item-Instanzen enthält, von denen jede eine oder mehrere Darstellungen eines Datenelements enthalten kann. Für die Anzeige für den Benutzer hat es auch eine Bezeichnung.

Ein ClipData-Element enthält eine ClipDescription, die wichtige Metadaten zum Clip beschreibt. Insbesondere muss es ClipDescription#getMimeType(int) getDescription().getMimeType(int) korrekte MIME-Typen zurückgeben, die die Daten im Clip beschreiben. Wenn Sie Hilfe beim korrekten Erstellen eines Clips mit dem richtigen MIME-Typ benötigen, verwenden Sie #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)und #newIntent(CharSequence, Intent).

Jede Item-instance kann eine von drei Standard Datenklassen 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 Zwischenablageframeworks finden Sie im Entwicklerhandbuch 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 ihre Verwendung korrekt 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 Textdarstellung der abgeschnittenen Daten benötigen, können Sie die Convenience-Methode Item#coerceToText Item.coerceToTextverwenden. In diesem Fall müssen Sie sich im Allgemeinen keine Gedanken über die von gemeldeten ClipDescription#getMimeType(int) getDescription().getMimeType(int)MIME-Typen machen, da jedes Clipelement immer in eine Zeichenfolge konvertiert werden kann.

Komplizierterer 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 ordnungsgemäß zu tun.

Hier sehen Sie beispielsweise die Einfügefunktion einer einfachen EditorPad-Anwendung. Beim Abrufen der Daten aus der Zwischenablage kann es 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, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

ClipData(ClipData)	Erstellen Sie einen neuen Clip, bei dem es sich um eine Kopie eines anderen Clips handelt.
ClipData(ClipDescription, ClipData+Item)	Erstellen Sie einen neuen Clip, bei dem es sich um eine Kopie eines anderen Clips handelt.
ClipData(ICharSequence, String[], ClipData+Item)	Erstellen Sie einen neuen Clip, bei dem es sich um eine Kopie eines anderen Clips handelt.
ClipData(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime aufgerufen.
ClipData(String, String[], ClipData+Item)	Erstellen Sie einen neuen Clip.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
Creator
Description	Geben Sie die `ClipDescription` diesen Daten zugeordnete zurück, und beschreiben Sie, was sie enthalten.
Handle	Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
ItemCount	Gibt die Anzahl der Elemente in den Clipdaten zurück.
JniIdentityHashCode	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
JniPeerMembers	Darstellung eines abgeschnittenen Daten in der Zwischenablage.
PeerReference	Darstellung eines abgeschnittenen 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

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 dieses Parcelable enthalten sind.
Dispose()	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Dispose(Boolean)	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetItemAt(Int32)	Gibt ein einzelnes Element in den Clipdaten zurück.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Erstellen Sie eine neue ClipData-Datei mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Erstellen Sie eine neue ClipData-Datei mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Erstellen Sie eine neue ClipData-Datei mit einer Absicht mit dem MIME-Typ `ClipDescription#MIMETYPE_TEXT_INTENT`.
NewIntent(String, Intent)	Erstellen Sie eine neue ClipData-Datei mit einer Absicht mit dem MIME-Typ `ClipDescription#MIMETYPE_TEXT_INTENT`.
NewPlainText(ICharSequence, ICharSequence)	Erstellen Sie eine neue ClipData-Datei mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Erstellen Sie eine neue ClipData-Datei mit Daten des Typs `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Erstellen Sie einen neuen ClipData-Wert mit einem URI mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_URILIST`.
NewRawUri(String, Uri)	Erstellen Sie einen neuen ClipData-Wert mit einem URI mit MIME-Typ `ClipDescription#MIMETYPE_TEXT_URILIST`.
NewUri(ContentResolver, ICharSequence, Uri)	Erstellen Sie einen neuen ClipData-Wert mit einem URI.
NewUri(ContentResolver, String, Uri)	Erstellen Sie einen neuen ClipData-Wert mit einem URI.
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 eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Flachen Sie dieses Objekt in ein Paket ein.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.Finalized()	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Darstellung eines abgeschnittenen Daten in der Zwischenablage. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Darstellung eines abgeschnittenen Daten in der Zwischenablage.
GetJniTypeName(IJavaPeerable)	Darstellung eines abgeschnittenen Daten in der Zwischenablage.

Gilt für: