ClipData Classe

Riferimento

Definizione

Spazio dei nomi:: Android.Content

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresentazione di dati ritagliati negli Appunti.

[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

Ereditarietà: Object

Object
ClipData

Attributi: RegisterAttribute

Implementazioni: IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

Rappresentazione di dati ritagliati negli Appunti.

ClipData è un tipo complesso contenente una o più istanze di Item, ognuna delle quali può contenere una o più rappresentazioni di un elemento di dati. Per la visualizzazione all'utente, ha anche un'etichetta.

ClipData contiene un ClipDescriptionoggetto , che descrive i metadati importanti relativi alla clip. In particolare, ClipDescription#getMimeType(int) getDescription().getMimeType(int) deve restituire tipi MIME corretti che descrivono i dati nel clip. Per informazioni sulla corretta costruzione di un clip con il tipo MIME corretto, usare #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)e #newIntent(CharSequence, Intent).

Ogni istanza di Item può essere una delle tre classi principali di dati: una semplice charSequence di testo, un singolo oggetto Intent o un Uri. Per informazioni dettagliate, vedere Item.

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

Per altre informazioni sull'uso del framework degli Appunti, vedere la guida per sviluppatori Copia e incolla .

</Div>

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

Per implementare un'operazione incolla o drop di un oggetto ClipData in un'applicazione, l'applicazione deve interpretare correttamente i dati per l'uso. Se contiene Item è testo semplice o intento, è necessario eseguire poco: il testo può essere interpretato solo come testo e in genere verrà usato un intento per la creazione di tasti di scelta rapida (ad esempio l'inserimento di icone nella schermata iniziale) o altre azioni.

Se tutto quello che si desidera è la rappresentazione testuale dei dati ritagliati, è possibile usare il metodo Item#coerceToText Item.coerceToTextdi praticità . In questo caso in genere non è necessario preoccuparsi dei tipi MIME segnalati da ClipDescription#getMimeType(int) getDescription().getMimeType(int), poiché qualsiasi elemento clip può sempre essere convertito in una stringa.

Gli scambi più complessi verranno eseguiti tramite URI, in particolare gli URI "content:". Un URI di contenuto consente al destinatario di un elemento ClipData di interagire con il ContentProvider che contiene i dati per negoziare il trasferimento di tali dati. Il clip deve anche essere compilato con i tipi MIME disponibili; #newUri(ContentResolver, CharSequence, Uri) si occuperà di eseguire correttamente questa operazione.

Ad esempio, ecco la funzione paste di una semplice applicazione Blocco note. Quando si recuperano i dati dagli Appunti, è possibile eseguire due operazioni: se gli Appunti contengono un riferimento URI a una nota esistente, copia l'intera struttura della nota in una nuova nota; in caso contrario, limita la clip nel testo e lo usa come contenuto della nuova nota.

{

Documentazione java per android.content.ClipData.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.

Costruttori

ClipData(ClipData)	Crea una nuova clip che rappresenta una copia di un'altra clip.
ClipData(ClipDescription, ClipData+Item)	Crea una nuova clip che rappresenta una copia di un'altra clip.
ClipData(ICharSequence, String[], ClipData+Item)	Crea una nuova clip che rappresenta una copia di un'altra clip.
ClipData(IntPtr, JniHandleOwnership)	Costruttore utilizzato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.
ClipData(String, String[], ClipData+Item)	Crea una nuova clip.

Proprietà

Class	Restituisce la classe di runtime di questo `Object`oggetto . (Ereditato da Object)
Creator
Description	Restituisce l'oggetto `ClipDescription` associato a questi dati, che descrive ciò che contiene.
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
ItemCount	Restituisce il numero di elementi nei dati di ritaglio.
JniIdentityHashCode	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
JniPeerMembers	Rappresentazione di dati ritagliati negli Appunti.
PeerReference	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

Metodi

AddItem(ClipData+Item)	Aggiungere un nuovo elemento al contenitore ClipData complessivo.
AddItem(ContentResolver, ClipData+Item)	Aggiungere un nuovo elemento al contenitore ClipData complessivo.
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
DescribeContents()	Descrivere i tipi di oggetti speciali contenuti nella rappresentazione di marshalling di questo oggetto Parcelable.
Dispose()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
Dispose(Boolean)	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
GetItemAt(Int32)	Restituisce un singolo elemento all'interno dei dati di ritaglio.
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Creare un nuovo clipData contenente i dati del tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Creare un nuovo clipData contenente i dati del tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Creare un nuovo ClipData che contiene una finalità con tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewIntent(String, Intent)	Creare un nuovo ClipData che contiene una finalità con tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewPlainText(ICharSequence, ICharSequence)	Creare un nuovo clipData contenente i dati del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Creare un nuovo clipData contenente i dati del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Creare un nuovo ClipData contenente un URI con tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewRawUri(String, Uri)	Creare un nuovo ClipData contenente un URI con tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewUri(ContentResolver, ICharSequence, Uri)	Creare un nuovo ClipData contenente un URI.
NewUri(ContentResolver, String, Uri)	Creare un nuovo ClipData contenente un URI.
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitoraggio di questo oggetto. (Ereditato da Object)
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
ToArray<T>()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
ToString()	Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una>notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object)
Wait(Int64, Int32)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Appiattire questo oggetto in a un Parcel.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.Finalized()	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Rappresentazione di dati ritagliati negli Appunti. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo verificato dal runtime Android.
JavaCast<TResult>(IJavaObject)	Rappresentazione di dati ritagliati negli Appunti.
GetJniTypeName(IJavaPeerable)	Rappresentazione di dati ritagliati negli Appunti.

Si applica a

Condividi tramite