ClipData Класс

Ссылка

Определение

Пространство имен:: Android.Content

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представление обрезанных данных в буфере обмена.

[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

Наследование: Object

Object
ClipData

Атрибуты: RegisterAttribute

Реализации: IParcelable IJavaObject IJavaPeerable IDisposable

ClipData — это сложный тип, содержащий один или несколько экземпляров Item, каждый из которых может содержать одно или несколько представлений элемента данных. Для отображения пользователю также имеется метка.

ClipData содержит ClipDescription, который описывает важные метаданные об клипе. В частности, он ClipDescription#getMimeType(int) getDescription().getMimeType(int) должен возвращать правильные типы MIME, описывающие данные в клипе. Для получения справки по правильному созданию клипа с правильным типом MIME используйте #newPlainText(CharSequence, CharSequence), #newUri(ContentResolver, CharSequence, Uri)и #newIntent(CharSequence, Intent).

Каждый экземпляр Item может быть одним из трех main классов данных: простой объект CharSequence текста, один объект Intent или универсальный код ресурса (URI). Дополнительные сведения см. в статье Item.

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

Дополнительные сведения об использовании платформы буфера обмена см. в руководстве разработчика по копированию и вставке .

</Div>

"ImplementingPaste"><h3>Реализация вставки или перетаскивания</h3>

Чтобы реализовать вставку или удаление объекта ClipData в приложение, приложение должно правильно интерпретировать данные для их использования. Item Если он содержит простой текст или намерение, мало что делать: текст можно интерпретировать только как текст, а намерение обычно используется для создания ярлыков (например, размещения значков на начальном экране) или других действий.

Если требуется только текстовое представление обрезанных данных, можно использовать удобный метод Item#coerceToText Item.coerceToText. В этом случае нет необходимости беспокоиться о типах MIME, сообщаемых ClipDescription#getMimeType(int) getDescription().getMimeType(int), так как любой элемент клипа всегда можно преобразовать в строку.

Более сложные обмены будут выполняться через URI, в частности с помощью URI content:. URI содержимого позволяет получателю элемента ClipData тесно взаимодействовать с ContentProvider, который содержит данные, для согласования передачи этих данных. Клип также должен быть заполнен доступными типами MIME; #newUri(ContentResolver, CharSequence, Uri) будет заботиться о правильном выполнении этого.

Например, ниже приведена функция вставки простого приложения Блокнота. При получении данных из буфера обмена он может выполнять две задачи: если буфер обмена содержит ссылку URI на существующую заметку, он копирует всю структуру заметки в новую заметку; В противном случае он просто принудит клип к тексту и использует его в качестве содержимого новой заметки.

{

Документация по Java для android.content.ClipData.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.

Конструкторы

ClipData(ClipData)	Создайте новый клип, который является копией другого клипа.
ClipData(ClipDescription, ClipData+Item)	Создайте новый клип, который является копией другого клипа.
ClipData(ICharSequence, String[], ClipData+Item)	Создайте новый клип, который является копией другого клипа.
ClipData(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
ClipData(String, String[], ClipData+Item)	Создайте клип.

Свойства

Class	Возвращает класс среды выполнения данного объекта `Object`. (Унаследовано от Object)
Creator
Description	Возвращает объект , связанный `ClipDescription` с данными, описывая, что они содержат.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
ItemCount	Возвращает количество элементов в данных клипа.
JniIdentityHashCode	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
JniPeerMembers	Представление обрезанных данных в буфере обмена.
PeerReference	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.

Методы

AddItem(ClipData+Item)	Добавьте новый элемент в общий контейнер ClipData.
AddItem(ContentResolver, ClipData+Item)	Добавьте новый элемент в общий контейнер ClipData.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
DescribeContents()	Описывать типы специальных объектов, содержащихся в маршалируемом представлении этого объектного объекта.
Dispose()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
Dispose(Boolean)	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
GetItemAt(Int32)	Возвращает один элемент внутри данных клипа.
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
NewHtmlText(ICharSequence, ICharSequence, String)	Создайте объект ClipData, содержащий данные типа `ClipDescription#MIMETYPE_TEXT_HTML`.
NewHtmlText(String, String, String)	Создайте объект ClipData, содержащий данные типа `ClipDescription#MIMETYPE_TEXT_HTML`.
NewIntent(ICharSequence, Intent)	Создайте объект ClipData, содержащий намерение с типом `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewIntent(String, Intent)	Создайте объект ClipData, содержащий намерение с типом `ClipDescription#MIMETYPE_TEXT_INTENT`MIME .
NewPlainText(ICharSequence, ICharSequence)	Создайте объект ClipData, содержащий данные типа `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewPlainText(String, String)	Создайте объект ClipData, содержащий данные типа `ClipDescription#MIMETYPE_TEXT_PLAIN`.
NewRawUri(ICharSequence, Uri)	Создайте объект ClipData, содержащий универсальный код ресурса (URI) с типом `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewRawUri(String, Uri)	Создайте объект ClipData, содержащий универсальный код ресурса (URI) с типом `ClipDescription#MIMETYPE_TEXT_URILIST`MIME .
NewUri(ContentResolver, ICharSequence, Uri)	Создайте новый объект ClipData, содержащий универсальный код ресурса (URI).
NewUri(ContentResolver, String, Uri)	Создайте новый объект ClipData, содержащий универсальный код ресурса (URI).
Notify()	Пробуждает один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Пробуждает все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
ToArray<T>()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
Wait()	Вызывает ожидание текущего потока, пока он не пробудится, как правило, из-за <уведомления><<> или>прерывания или прерывания.>< (Унаследовано от Object)
Wait(Int64)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Разведите этот объект в плоскую структуру в объект Parcel.

Явные реализации интерфейса

IJavaPeerable.Disposed()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.Finalized()	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Представление обрезанных данных в буфере обмена. (Унаследовано от Object)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенного средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Представление обрезанных данных в буфере обмена.
GetJniTypeName(IJavaPeerable)	Представление обрезанных данных в буфере обмена.

Применяется к