ClipData Clase

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

[<Android.Runtime.Register("android/content/ClipData", DoNotGenerateAcw=true)>]
type ClipData = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herencia: Object

JavaObject

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.

ClipData contiene un objeto , que describe metadatos ClipDescriptionimportantes sobre el clip. En concreto, debe ClipDescription#getMimeType(int) getDescription().getMimeType(int) 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. Consulte Item para obtener más detalles.

<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>

"ImplementarPaste"><h3>Implementar pegar o quitar</h3>

Para implementar un pegado o colocación de un objeto ClipData en una aplicación, la aplicación debe interpretar correctamente los datos para su uso. Item Si contiene es texto simple o intención, no hay nada 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 lo único 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 de 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 nueva nota; de lo contrario, simplemente convierte el clip en texto y lo usa como contenido de la nueva nota.

{

Java documentación para android.content.ClipData.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Constructores

Nombre	Description
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

Nombre	Description
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	Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object)
JniManagedPeerState	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
JniPeerMembers	Obtiene los metadatos de JNI usados para invocar miembros de este Java del mismo nivel.
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (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

Nombre	Description
AddItem(ClipData+Item)	Agregue un nuevo elemento al contenedor general de ClipData.
AddItem(ContentResolver, ClipData+Item)	Agregue un nuevo elemento al contenedor general de ClipData.
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
DescribeContents()	Describir los tipos de objetos especiales contenidos en la representación serializado de este Parcelable.
Dispose()	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
Dispose(Boolean)	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
DisposeUnlessReferenced()	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
Equals(Object)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
GetHashCode()	Devuelve un valor de código hash para el objeto . (Heredado de Object)
GetItemAt(Int32)	Devuelve un único 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 clipData que contenga datos del tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Cree un clipData que contenga 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 clipData que contenga datos del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Cree un clipData que contenga datos del tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Cree un clipData que contenga un URI con el tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewRawUri(String, Uri)	Cree un clipData que contenga un URI con el tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewUri(ContentResolver, ICharSequence, Uri)	Cree un clipData que contenga un URI.
NewUri(ContentResolver, String, Uri)	Cree un 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)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto . (Heredado de Object)
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (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, 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)
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)
WriteToParcel(Parcel, ParcelableWriteFlags)	Aplane este objeto en un paquete.

Implementaciones de interfaz explícitas

Nombre	Description
IJavaPeerable.Disposed()	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.Finalized()	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Representación de datos recortados en el Portapapeles. (Heredado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Representación de datos recortados en el Portapapeles.

Métodos de extensión

Nombre	Description
GetJniTypeName(IJavaPeerable)	Obtiene el nombre JNI del tipo de la instancia `self`.
JavaAs<TResult>(IJavaPeerable)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.
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.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.

Se aplica a