Эта страница переведена с помощью Cloud Translation API.

Перетащите
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Jetpack Compose поддерживает перетаскивание с двумя модификаторами:

dragAndDropSource : указывает компонуемый объект в качестве отправной точки жеста перетаскивания.
dragAndDropTarget : указывает компонуемый объект, который принимает переброшенные данные.

Например, чтобы пользователи могли перетаскивать изображения в вашем приложении, создайте составное изображение и добавьте модификатор dragAndDropSource . Чтобы настроить цель перетаскивания, создайте другое компонуемое изображение и добавьте модификатор dragAndDropTarget .

Модификаторы можно применять к нескольким источникам перетаскивания и нескольким целям перетаскивания.

Модификаторы позволяют приложениям обмениваться данными между двумя или более составными объектами с помощью ClipData , который совместим с реализациями View .

Укажите источник перетаскивания

Чтобы включить события перетаскивания внутри компонента, добавьте модификатор dragAndDropSource . Это принимает функцию в качестве параметра. Внутри этой функции используйте DragAndDropTransferData для представления передаваемых данных. Данные могут представлять собой удаленный URI, данные форматированного текста в буфере обмена, локальный файл и т. д., но все они должны быть заключены в объект ClipData . Укажите простой текст, например, следующий:

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        )
    )
}DragAndDropSnippets.kt

Чтобы позволить действию перетаскивания пересекать границы приложения, конструктор DragAndDropTransferData принимает аргумент flags . В следующем примере константа DRAG_FLAG_GLOBAL указывает, что данные можно перетаскивать из одного приложения в другое:

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        ),
        flags = View.DRAG_FLAG_GLOBAL
    )
}DragAndDropSnippets.kt

DragAndDropTransferData принимает флаги, поддерживаемые системой Android View. См. список констант представления для получения исчерпывающего списка доступных флагов.

Получить данные о сбросе

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

Обратите внимание, что экземпляр обратного вызова следует запомнить . В следующем фрагменте показано, как запомнить обратный вызов:

val callback = remember {
    object : DragAndDropTarget {
        override fun onDrop(event: DragAndDropEvent): Boolean {
            // Parse received data
            return true
        }
    }
}DragAndDropSnippets.kt

Следующий фрагмент демонстрирует, как обрабатывать отброшенный простой текст:

Modifier.dragAndDropTarget(
    shouldStartDragAndDrop = { event ->
        event.mimeTypes().contains(ClipDescription.MIMETYPE_TEXT_PLAIN)
    }, target = callback
)DragAndDropSnippets.kt

Функция обратного вызова должна возвращать true если событие использовано, или false если событие отклонено и не распространяется на родительский компонент.

Обработка событий перетаскивания

Переопределите обратные вызовы в интерфейсе DragAndDropTarget , чтобы отслеживать, когда событие перетаскивания начинается, заканчивается или входит в компонент или выходит из него, для точного управления пользовательским интерфейсом и поведением приложения:

object : DragAndDropTarget {
    override fun onStarted(event: DragAndDropEvent) {
        // When the drag event starts
    }

    override fun onEntered(event: DragAndDropEvent) {
        // When the dragged object enters the target surface
    }

    override fun onEnded(event: DragAndDropEvent) {
        // When the drag event stops
    }

    override fun onExited(event: DragAndDropEvent) {
        // When the dragged object exits the target surface
    }

    override fun onDrop(event: DragAndDropEvent): Boolean = true
}DragAndDropSnippets.kt

Дополнительные ресурсы

Codelab: перетаскивание в Compose

Jetpack Compose поддерживает перетаскивание с двумя модификаторами:

dragAndDropSource : указывает компонуемый объект в качестве отправной точки жеста перетаскивания.
dragAndDropTarget : указывает компонуемый объект, который принимает переброшенные данные.

Модификаторы можно применять к нескольким источникам перетаскивания и нескольким целям перетаскивания.

Укажите источник перетаскивания

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        )
    )
}DragAndDropSnippets.kt

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        ),
        flags = View.DRAG_FLAG_GLOBAL
    )
}DragAndDropSnippets.kt

Получить данные о сбросе

val callback = remember {
    object : DragAndDropTarget {
        override fun onDrop(event: DragAndDropEvent): Boolean {
            // Parse received data
            return true
        }
    }
}DragAndDropSnippets.kt

Следующий фрагмент демонстрирует, как обрабатывать отброшенный простой текст:

Modifier.dragAndDropTarget(
    shouldStartDragAndDrop = { event ->
        event.mimeTypes().contains(ClipDescription.MIMETYPE_TEXT_PLAIN)
    }, target = callback
)DragAndDropSnippets.kt

Обработка событий перетаскивания

object : DragAndDropTarget {
    override fun onStarted(event: DragAndDropEvent) {
        // When the drag event starts
    }

    override fun onEntered(event: DragAndDropEvent) {
        // When the dragged object enters the target surface
    }

    override fun onEnded(event: DragAndDropEvent) {
        // When the drag event stops
    }

    override fun onExited(event: DragAndDropEvent) {
        // When the dragged object exits the target surface
    }

    override fun onDrop(event: DragAndDropEvent): Boolean = true
}DragAndDropSnippets.kt

Дополнительные ресурсы

Codelab: перетаскивание в Compose

Jetpack Compose поддерживает перетаскивание с двумя модификаторами:

dragAndDropSource : указывает компонуемый объект в качестве отправной точки жеста перетаскивания.
dragAndDropTarget : указывает компонуемый объект, который принимает переброшенные данные.

Модификаторы можно применять к нескольким источникам перетаскивания и нескольким целям перетаскивания.

Укажите источник перетаскивания

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        )
    )
}DragAndDropSnippets.kt

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        ),
        flags = View.DRAG_FLAG_GLOBAL
    )
}DragAndDropSnippets.kt

Получить данные о сбросе

val callback = remember {
    object : DragAndDropTarget {
        override fun onDrop(event: DragAndDropEvent): Boolean {
            // Parse received data
            return true
        }
    }
}DragAndDropSnippets.kt

Следующий фрагмент демонстрирует, как обрабатывать отброшенный простой текст:

Modifier.dragAndDropTarget(
    shouldStartDragAndDrop = { event ->
        event.mimeTypes().contains(ClipDescription.MIMETYPE_TEXT_PLAIN)
    }, target = callback
)DragAndDropSnippets.kt

Обработка событий перетаскивания

object : DragAndDropTarget {
    override fun onStarted(event: DragAndDropEvent) {
        // When the drag event starts
    }

    override fun onEntered(event: DragAndDropEvent) {
        // When the dragged object enters the target surface
    }

    override fun onEnded(event: DragAndDropEvent) {
        // When the drag event stops
    }

    override fun onExited(event: DragAndDropEvent) {
        // When the dragged object exits the target surface
    }

    override fun onDrop(event: DragAndDropEvent): Boolean = true
}DragAndDropSnippets.kt

Дополнительные ресурсы

Codelab: перетаскивание в Compose

Jetpack Compose поддерживает перетаскивание с двумя модификаторами:

dragAndDropSource : указывает компонуемый объект в качестве отправной точки жеста перетаскивания.
dragAndDropTarget : указывает компонуемый объект, который принимает переброшенные данные.

Модификаторы можно применять к нескольким источникам перетаскивания и нескольким целям перетаскивания.

Укажите источник перетаскивания

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        )
    )
}DragAndDropSnippets.kt

Modifier.dragAndDropSource { _ ->
    DragAndDropTransferData(
        ClipData.newPlainText(
            "image Url", url
        ),
        flags = View.DRAG_FLAG_GLOBAL
    )
}DragAndDropSnippets.kt

Получить данные о сбросе

val callback = remember {
    object : DragAndDropTarget {
        override fun onDrop(event: DragAndDropEvent): Boolean {
            // Parse received data
            return true
        }
    }
}DragAndDropSnippets.kt

Следующий фрагмент демонстрирует, как обрабатывать отброшенный простой текст:

Modifier.dragAndDropTarget(
    shouldStartDragAndDrop = { event ->
        event.mimeTypes().contains(ClipDescription.MIMETYPE_TEXT_PLAIN)
    }, target = callback
)DragAndDropSnippets.kt

Обработка событий перетаскивания

object : DragAndDropTarget {
    override fun onStarted(event: DragAndDropEvent) {
        // When the drag event starts
    }

    override fun onEntered(event: DragAndDropEvent) {
        // When the dragged object enters the target surface
    }

    override fun onEnded(event: DragAndDropEvent) {
        // When the drag event stops
    }

    override fun onExited(event: DragAndDropEvent) {
        // When the dragged object exits the target surface
    }

    override fun onDrop(event: DragAndDropEvent): Boolean = true
}DragAndDropSnippets.kt

Дополнительные ресурсы

Codelab: перетаскивание в Compose

Перетащите Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Укажите источник перетаскивания

Получить данные о сбросе

Обработка событий перетаскивания

Дополнительные ресурсы

Укажите источник перетаскивания

Получить данные о сбросе

Обработка событий перетаскивания

Дополнительные ресурсы

Укажите источник перетаскивания

Получить данные о сбросе

Обработка событий перетаскивания

Дополнительные ресурсы

Укажите источник перетаскивания

Получить данные о сбросе

Обработка событий перетаскивания

Дополнительные ресурсы

Перетащите
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.