ClipData Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représentation d’une donnée clippée dans le Presse-papiers.
[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- Héritage
- Attributs
- Implémente
Remarques
Représentation d’une donnée clippée dans le Presse-papiers.
ClipData est un type complexe contenant une ou plusieurs instances Item, chacune pouvant contenir une ou plusieurs représentations d’un élément de données. Pour l’affichage à l’utilisateur, il a également une étiquette.
Un ClipData contient un ClipDescription, qui décrit les métadonnées importantes sur le clip. En particulier, son ClipDescription#getMimeType(int) getDescription().getMimeType(int) doit retourner un ou plusieurs types MIME corrects décrivant les données dans le clip. Pour obtenir de l’aide sur la construction correcte d’un clip avec le type MIME approprié, utilisez #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)et #newIntent(CharSequence, Intent).
Chaque instance Item peut être l’une des trois classes principales de données : une simple charSequence de texte, un objet Intent unique ou un URI. Consultez Item pour plus d’informations.
<div class="special reference"><h3>Developer Guides</h3>
Pour plus d’informations sur l’utilisation de l’infrastructure du Presse-papiers, consultez le guide du développeur copier-coller .
<Commande /div>
« ImplementingPaste"><h3>Implémentation de collage ou de suppression</h3>
Pour implémenter un collage ou une suppression d’un objet ClipData dans une application, l’application doit interpréter correctement les données pour son utilisation.
Item S’il contient un texte simple ou une intention, il n’y a que peu à faire : le texte ne peut être interprété que comme du texte et une intention est généralement utilisée pour créer des raccourcis (tels que placer des icônes sur l’écran d’accueil) ou d’autres actions.
Si tout ce que vous souhaitez est la représentation textuelle des données clippées, vous pouvez utiliser la méthode Item#coerceToText Item.coerceToTextpratique. Dans ce cas, il n’est généralement pas nécessaire de vous soucier des types MIME signalés par ClipDescription#getMimeType(int) getDescription().getMimeType(int), car tout élément clip peut toujours être converti en chaîne.
Des échanges plus complexes seront effectués via des URI, en particulier des URI « content : ». Un URI de contenu permet au destinataire d’un élément ClipData d’interagir étroitement avec le ContentProvider contenant les données afin de négocier le transfert de ces données. Le clip doit également être rempli avec les types MIME disponibles ; #newUri(ContentResolver, CharSequence, Uri) s’occupera de faire cela correctement.
Par exemple, voici la fonction coller d’une application Bloc-notes simple. Lors de la récupération des données à partir du Presse-papiers, il peut effectuer deux opérations : si le Presse-papiers contient une référence d’URI à une note existante, il copie la structure entière de la note dans une nouvelle note ; sinon, il force simplement le clip dans du texte et utilise celui-ci comme contenu de la nouvelle note.
{
Java documentation pour android.content.ClipData.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| ClipData(ClipData) |
Créez un clip qui est une copie d’un autre clip. |
| ClipData(ClipDescription, ClipData+Item) |
Créez un clip qui est une copie d’un autre clip. |
| ClipData(ICharSequence, String[], ClipData+Item) |
Créez un clip qui est une copie d’un autre clip. |
| ClipData(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| ClipData(String, String[], ClipData+Item) |
Créez un clip. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Creator | |
| Description |
Retournez les |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| ItemCount |
Retourne le nombre d’éléments dans les données clip. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| JniPeerMembers |
Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Nom | Description |
|---|---|
| AddItem(ClipData+Item) |
Ajoutez un nouvel élément au conteneur ClipData global. |
| AddItem(ContentResolver, ClipData+Item) |
Ajoutez un nouvel élément au conteneur ClipData global. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| DescribeContents() |
Décrivez les types d’objets spéciaux contenus dans la représentation marshallée de ce Colisable. |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| Equals(Object) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetItemAt(Int32) |
Retourne un élément unique à l’intérieur des données clip. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| NewHtmlText(ICharSequence, ICharSequence, String) |
Créez un ClipData contenant les données du type |
| NewHtmlText(String, String, String) |
Créez un ClipData contenant les données du type |
| NewIntent(ICharSequence, Intent) |
Créez un ClipData contenant une intention avec le type |
| NewIntent(String, Intent) |
Créez un ClipData contenant une intention avec le type |
| NewPlainText(ICharSequence, ICharSequence) |
Créez un ClipData contenant les données du type |
| NewPlainText(String, String) |
Créez un ClipData contenant les données du type |
| NewRawUri(ICharSequence, Uri) |
Créez un ClipData contenant un URI avec le type |
| NewRawUri(String, Uri) |
Créez un ClipData contenant un URI avec le type |
| NewUri(ContentResolver, ICharSequence, Uri) |
Créez un ClipData contenant un URI. |
| NewUri(ContentResolver, String, Uri) |
Créez un ClipData contenant un URI. |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Aplatir cet objet dans un colis. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Représentation d’une donnée clippée dans le Presse-papiers. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Représentation d’une donnée clippée dans le Presse-papiers. |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Représentation d’une donnée clippée dans le Presse-papiers. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |