ClipData Classe

Definição

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representação de dados recortados na área de transferência.

[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

Herança: Object

JavaObject

Object
ClipData

Atributos: RegisterAttribute

Implementações: IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Representação de dados recortados na área de transferência.

ClipData é um tipo complexo que contém uma ou mais instâncias de item, cada uma das quais pode conter uma ou mais representações de um item de dados. Para exibição ao usuário, ele também tem um rótulo.

Um ClipData contém um ClipDescription, que descreve metadados importantes sobre o clipe. Em particular, ele ClipDescription#getMimeType(int) getDescription().getMimeType(int) deve retornar tipos MIME corretos que descrevem os dados no clipe. Para obter ajuda na construção correta de um clipe com o tipo MIME correto, use #newPlainText(CharSequence, CharSequence)e #newUri(ContentResolver, CharSequence, Uri)#newIntent(CharSequence, Intent).

Cada instância de Item pode ser uma das três classes principais de dados: um CharSequence simples de texto, um único objeto Intent ou um Uri. Confira Item para saber mais.

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

Para obter mais informações sobre como usar a estrutura da área de transferência, leia o guia do desenvolvedor Copiar e Colar .

</div>

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

Para implementar uma colagem ou uma queda de um objeto ClipData em um aplicativo, o aplicativo deve interpretar corretamente os dados para seu uso. Se ele Item contiver um texto simples ou uma Intenção, há pouco a ser feito: o texto só pode ser interpretado como texto e uma Intenção normalmente será usada para criar atalhos (como colocar ícones na tela inicial) ou outras ações.

Se tudo o que você deseja é a representação textual dos dados recortados, você pode usar o método Item#coerceToText Item.coerceToTextde conveniência. Nesse caso, geralmente não é necessário se preocupar com os tipos MIME relatados por ClipDescription#getMimeType(int) getDescription().getMimeType(int), uma vez que qualquer item de clipe sempre pode ser convertido em uma cadeia de caracteres.

Trocas mais complicadas serão feitas por meio de URIs, em particular URIs "content:". Um URI de conteúdo permite que o destinatário de um item ClipData interaja de perto com o ContentProvider que contém os dados para negociar a transferência desses dados. O clipe também deve ser preenchido com os tipos MIME disponíveis; #newUri(ContentResolver, CharSequence, Uri) cuidará de fazer isso corretamente.

Por exemplo, aqui está a função de colagem de um aplicativo simples do NotePad. Ao recuperar os dados da área de transferência, ele pode fazer duas coisas: se a área de transferência contiver uma referência de URI a uma nota existente, ela copiará toda a estrutura da anotação em uma nova nota; caso contrário, ele simplesmente coagirá o clipe para o texto e o usará como o conteúdo da nova anotação.

{

Java documentação para android.content.ClipData.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
ClipData(ClipData)	Crie um novo clipe que seja uma cópia de outro clipe.
ClipData(ClipDescription, ClipData+Item)	Crie um novo clipe que seja uma cópia de outro clipe.
ClipData(ICharSequence, String[], ClipData+Item)	Crie um novo clipe que seja uma cópia de outro clipe.
ClipData(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.
ClipData(String, String[], ClipData+Item)	Crie um novo clipe.

Propriedades

Nome	Description
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Creator
Description	Retorne os `ClipDescription` dados associados, descrevendo o que eles contêm.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
ItemCount	Retorne o número de itens nos dados de clipe.
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
JniPeerMembers	Obtém os metadados JNI usados para invocar membros desse par Java.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

Métodos

Nome	Description
AddItem(ClipData+Item)	Adicione um novo item ao contêiner ClipData geral.
AddItem(ContentResolver, ClipData+Item)	Adicione um novo item ao contêiner ClipData geral.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
DescribeContents()	Descreva os tipos de objetos especiais contidos na representação marshalled deste Parcelable.
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
Equals(Object)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetItemAt(Int32)	Retornar um único item dentro dos dados do clipe.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Crie um novo ClipData que contém dados do tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Crie um novo ClipData que contém dados do tipo `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Crie um novo ClipData segurando uma intenção com o tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME.
NewIntent(String, Intent)	Crie um novo ClipData segurando uma intenção com o tipo `ClipDescription#MIMETYPE_TEXT_INTENT`MIME.
NewPlainText(ICharSequence, ICharSequence)	Crie um novo ClipData que contém dados do tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Crie um novo ClipData que contém dados do tipo `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Crie um novo ClipData segurando um URI com o tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME.
NewRawUri(String, Uri)	Crie um novo ClipData segurando um URI com o tipo `ClipDescription#MIMETYPE_TEXT_URILIST`MIME.
NewUri(ContentResolver, ICharSequence, Uri)	Crie um novo ClipData segurando um URI.
NewUri(ContentResolver, String, Uri)	Crie um novo ClipData segurando um URI.
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Nivele esse objeto em um Pacote.

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Representação de dados recortados na área de transferência. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Representação de dados recortados na área de transferência.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	Representação de dados recortados na área de transferência.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a