ClipData Clase

Referencia

Definición

Espacio de nombres:: Android.Content

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representación de datos recortados en el Portapapeles.

[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

Herencia: Object

Object
ClipData

Atributos: RegisterAttribute

Implementaciones: IParcelable IJavaObject IJavaPeerable IDisposable

Comentarios

Representación de datos recortados en el Portapapeles.

ClipData es un tipo complejo que contiene una o varias instancias de Item, cada una de las cuales puede contener una o varias representaciones de un elemento de datos. Para mostrar al usuario, también tiene una etiqueta.

Un ClipData contiene un ClipDescriptionobjeto , que describe metadatos importantes sobre el clip. En concreto, su ClipDescription#getMimeType(int) getDescription().getMimeType(int) debe devolver los tipos MIME correctos que describen los datos del clip. Para obtener ayuda para construir correctamente un clip con el tipo MIME correcto, use #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)y #newIntent(CharSequence, Intent).

Cada instancia de Item puede ser una de las tres clases principales de datos: una charsequence simple de texto, un único objeto Intent o un URI. Para obtener más información, consulte Item.

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

Para obtener más información sobre el uso del marco del Portapapeles, lea la guía para desarrolladores Copiar y pegar .

</Div>

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

Para implementar un pegado o colocar un objeto ClipData en una aplicación, la aplicación debe interpretar correctamente los datos para su uso. Item Si contiene texto simple o intención, no hay mucho que hacer: el texto solo se puede interpretar como texto y normalmente se usará una intención para crear accesos directos (como colocar iconos en la pantalla principal) u otras acciones.

Si todo lo que desea es la representación textual de los datos recortados, puede usar el método Item#coerceToText Item.coerceToTextde conveniencia . En este caso, generalmente no es necesario preocuparse por los tipos MIME notificados por ClipDescription#getMimeType(int) getDescription().getMimeType(int), ya que cualquier elemento clip siempre se puede convertir en una cadena.

Los intercambios más complicados se realizarán a través de URI, en particular los URI "content:". Un URI de contenido permite al destinatario de un elemento ClipData interactuar estrechamente con el ContentProvider que contiene los datos para negociar la transferencia de esos datos. El clip también debe rellenarse con los tipos MIME disponibles; #newUri(ContentResolver, CharSequence, Uri) se encargará de hacer esto correctamente.

Por ejemplo, esta es la función paste de una aplicación simple del Bloc de notas. Al recuperar los datos del Portapapeles, puede hacer dos cosas: si el Portapapeles contiene una referencia de URI a una nota existente, copia toda la estructura de la nota en una nota nueva; de lo contrario, simplemente convierte el clip en texto y lo usa como contenido de la nueva nota.

{

Documentación de Java para android.content.ClipData.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código Project y que se usan según los términos Creative Commons 2.5 Attribution License.

Constructores

ClipData(ClipData)	Cree un clip que sea una copia de otro clip.
ClipData(ClipDescription, ClipData+Item)	Cree un clip que sea una copia de otro clip.
ClipData(ICharSequence, String[], ClipData+Item)	Cree un clip que sea una copia de otro clip.
ClipData(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.
ClipData(String, String[], ClipData+Item)	Cree un clip.

Propiedades

Class	Devuelve la clase en tiempo de ejecución de este `Object`objeto . (Heredado de Object)
Creator
Description	Devuelve el `ClipDescription` asociado a estos datos, que describe lo que contiene.
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
ItemCount	Devuelve el número de elementos de los datos del clip.
JniIdentityHashCode	Representación de datos recortados en el Portapapeles. (Heredado de Object)
JniPeerMembers	Representación de datos recortados en el Portapapeles.
PeerReference	Representación de datos recortados en el Portapapeles. (Heredado de Object)
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

Métodos

AddItem(ClipData+Item)	Agregue un nuevo elemento al contenedor clipData general.
AddItem(ContentResolver, ClipData+Item)	Agregue un nuevo elemento al contenedor clipData general.
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
DescribeContents()	Describir los tipos de objetos especiales contenidos en la representación serializado de este Parcelable.
Dispose()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
Dispose(Boolean)	Representación de datos recortados en el Portapapeles. (Heredado de Object)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
GetHashCode()	Devuelve un valor de código hash del objeto. (Heredado de Object)
GetItemAt(Int32)	Devuelve un solo elemento dentro de los datos del clip.
JavaFinalize()	Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Cree un nuevo ClipData que contenga los datos del tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Cree un nuevo ClipData que contenga los datos del tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Cree un clipData que contenga una intención con el tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewIntent(String, Intent)	Cree un clipData que contenga una intención con el tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewPlainText(ICharSequence, ICharSequence)	Cree un nuevo ClipData que contenga los datos del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Cree un nuevo ClipData que contenga los datos del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Cree un nuevo ClipData que contenga un URI con el tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewRawUri(String, Uri)	Cree un nuevo ClipData que contenga un URI con el tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewUri(ContentResolver, ICharSequence, Uri)	Cree un nuevo ClipData que contenga un URI.
NewUri(ContentResolver, String, Uri)	Cree un nuevo ClipData que contenga un URI.
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
ToArray<T>()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto. (Heredado de Object)
UnregisterFromRuntime()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Aplane este objeto en un paquete.

Implementaciones de interfaz explícitas

IJavaPeerable.Disposed()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.Finalized()	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.JniManagedPeerState	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Representación de datos recortados en el Portapapeles. (Heredado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Representación de datos recortados en el Portapapeles. (Heredado de Object)

Métodos de extensión

JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Representación de datos recortados en el Portapapeles.
GetJniTypeName(IJavaPeerable)	Representación de datos recortados en el Portapapeles.

Se aplica a