DragAndDrop

DragAndDrop

Справочник по API
androidx.draganddrop

Принимайте данные перетаскивания из другого приложения или внутри приложения и показывайте постоянную целевую доступность перетаскивания.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
11 мая 2022 г.	1.0.0	-	-	-

Объявление зависимостей

Чтобы добавить зависимость от DragAndDrop, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

dependencies {
    implementation "androidx.draganddrop:draganddrop:1.0.0"
}

Котлин

dependencies {
    implementation("androidx.draganddrop:draganddrop:1.0.0")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

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

Версия 1.0

Версия 1.0.0

11 мая 2022 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0 . Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

DropHelper , первый член библиотеки draganddrop , представляет собой служебный класс, который упрощает реализацию возможностей перетаскивания. Используйте DropHelper , чтобы указать цели перетаскивания, настроить подсветку целей перетаскивания и определить, как обрабатываются перетаскиваемые данные.

• DropHelper использует OnReceiveContentListener Jetpack для обеспечения целевой обработки перетаскивания ClipData . DropHelper улучшает взаимодействие с пользователем, настраивая цели перетаскивания для отображения выделения, когда пользователи перетаскивают контент поверх целей. Вложенный класс DropHelper.Options позволяет настроить внешний вид выделения по умолчанию.
• DropHelper присоединяет OnReceiveContentListener для перетаскивания целей и настраивает цели перетаскивания для прослушивания событий перетаскивания. Не прикрепляйте OnDragListener или дополнительный OnReceiveContentListener для удаления целевых объектов при использовании DropHelper .
• DropHelper.Options дает вам возможность перечислять все элементы EditText содержащиеся в иерархии представлений сложных целей перетаскивания. Если таковые имеются, их необходимо указать таким образом. DropHelper не позволяет элементам EditText перехватывать фокус у цели перетаскивания, когда пользователи перетаскивают данные на цель. Если перетаскивание ClipData включает в себя текст и данные URI, DropHelper выбирает один из элементов EditText в цели перетаскивания для обработки текстовых данных при перетаскивании ClipData .

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

Версия 1.0.0-rc01

20 апреля 2022 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0-rc01 . Версия 1.0.0-rc01 содержит эти коммиты.

• Никаких изменений со времени последней бета-версии.

Версия 1.0.0-бета01

23 марта 2022 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0-beta01 . Версия 1.0.0-beta01 содержит эти коммиты.

• Никаких изменений со времени последней альфа-версии.

Версия 1.0.0-альфа04

23 февраля 2022 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит эти коммиты.

Изменения API

• DragEvents с ненулевым значением localState по умолчанию не запускает подсветку. Существует опция конфигурации, позволяющая изменить это поведение. ( I55792 )

Версия 1.0.0-альфа03

26 января 2022 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит эти коммиты.

Новые возможности

• На устройствах под управлением Android S или более поздней версии DropHelper теперь делегирует системную реализацию OnReceiveContentListener , автоматически обеспечивая поддержку методов ввода, отличных от перетаскивания.

Версия 1.0.0-альфа02

15 декабря 2021 г.

Выпущен androidx.draganddrop:draganddrop:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит эти коммиты.

Возможности первоначальной версии

DropHelper , первый член библиотеки draganddrop , представляет собой служебный класс, который упрощает реализацию возможностей перетаскивания. Используйте DropHelper , чтобы указать цели перетаскивания, настроить подсветку целей перетаскивания и определить, как обрабатываются перетаскиваемые данные.

DropHelper использует OnReceiveContentListener Jetpack для обеспечения целевой обработки перетаскивания ClipData . DropHelper улучшает взаимодействие с пользователем, настраивая цели перетаскивания для отображения выделения, когда пользователи перетаскивают контент поверх целей. Вложенный класс DropHelper.Options позволяет настроить цвет и радиус угла выделения по умолчанию.

DropHelper.Options также дает вам возможность перечислять все элементы EditText содержащиеся в иерархии представлений сложных целей перетаскивания. DropHelper не позволяет элементам EditText перехватывать фокус у цели перетаскивания, когда пользователи перетаскивают данные на цель. Если перетаскивание ClipData включает в себя текст и данные URI, DropHelper выбирает один из элементов EditText в цели перетаскивания для обработки текстовых данных при перетаскивании ClipData .

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