ClipData Classe
Definizione
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à
- Attributi
- Implementazioni
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.
Un 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 una 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 altri dettagli, 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 una copia incolla o un'eliminazione di un oggetto ClipData in un'applicazione, l'applicazione deve interpretare correttamente i dati per il relativo utilizzo.
Item Se contiene è 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 collegamenti (ad esempio l'inserimento di icone nella schermata iniziale) o altre azioni.
Se tutto ciò che si desidera è la rappresentazione testuale dei dati ritagliati, è possibile usare il metodo Item#coerceToText Item.coerceToTextpratico . 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 gli URI, in particolare gli URI "content:". Un URI del contenuto consente al destinatario di un elemento ClipData di interagire strettamente con ContentProvider che contiene i dati per negoziare il trasferimento di tali dati. La clip deve anche essere riempita 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 in testo e lo usa come contenuto della nuova nota.
{ }
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Costruttori
| Nome | Descrizione |
|---|---|
| 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 usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
| ClipData(String, String[], ClipData+Item) |
Crea una nuova clip. |
Proprietà
| Nome | Descrizione |
|---|---|
| Class |
Restituisce la classe di runtime di questo |
| Creator | |
| Description |
Restituisce l'oggetto |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| ItemCount |
Restituisce il numero di elementi nei dati clip. |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniPeerMembers |
Ottiene i metadati JNI usati per richiamare i membri di questo peer Java. |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (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
| Nome | Descrizione |
|---|---|
| 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 con marshalling di questo oggetto Parcelable. |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| GetHashCode() |
Restituisce un valore di 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 |
| NewHtmlText(String, String, String) |
Creare un nuovo ClipData contenente i dati del tipo |
| NewIntent(ICharSequence, Intent) |
Creare un nuovo ClipData contenente una finalità con tipo |
| NewIntent(String, Intent) |
Creare un nuovo ClipData contenente una finalità con tipo |
| NewPlainText(ICharSequence, ICharSequence) |
Creare un nuovo ClipData contenente i dati del tipo |
| NewPlainText(String, String) |
Creare un nuovo ClipData contenente i dati del tipo |
| NewRawUri(ICharSequence, Uri) |
Creare un nuovo ClipData contenente un URI con tipo |
| NewRawUri(String, Uri) |
Creare un nuovo ClipData contenente un URI con tipo |
| 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 monitor dell'oggetto. (Ereditato da Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Appiattire questo oggetto in un pacco. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IJavaPeerable.Disposed() |
Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object) |
| IJavaPeerable.Finalized() |
Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object) |
| IJavaPeerable.JniManagedPeerState |
Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Rappresentazione di dati ritagliati negli Appunti. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |