Поддержка жеста «перетаскивания в»

Для операции отпускания характерна определенная последовательность событий:

1. Пользователь перетаскивает объект буфера обмена на компонент.

2. Компонент отправляет событие nativeDragEnter.

3. Обработчик события nativeDragEnter исследует объект события на предмет доступных форматов данных и разрешенных действий. Если компонент может обработать отпускание, он вызывает метод NativeDragManager.acceptDragDrop().

4. NativeDragManager изменяет вид курсора мыши, чтобы показать, что объект можно отпустить.

5. Пользователь отпускает объект на компоненте.

6. Компонент-получатель отправляет событие nativeDragDrop.

7. Компонент-получатель считывает из объекта Clipboard в объекте события данные в нужном формате.

8. Если жест перетаскивания начался в приложении AIR, то интерактивный объект-инициатор отправляет событие nativeDragComplete. Если жест начался вне приложения AIR, обратной связи нет.

Когда пользователь перетаскивает элемент буфера обмена в границы визуального компонента, тот отправляет события nativeDragEnter и nativeDragOver. Чтобы определить, может ли компонент принять этот элемент, обработчики этих событий проверяют свойства clipboard и allowedActions объекта события. Для подтверждения возможности перетаскивания обработчик события должен вызвать метод NativeDragManager.acceptDragDrop() и передать компоненту-получателю ссылку. Если метод acceptDragDrop() вызывается сразу несколькими обработчиками, то преимущество имеет последний в списке. Вызов метода acceptDragDrop() остается действительным, пока курсор мыши не будет выведен за границы объекта-получателя и не будет отправлено событие nativeDragExit.

Если параметром allowedActions, передаваемым методу doDrag(), разрешено более одного действия, пользователь может указать желаемое действие с помощью клавиши-модификатора. Диспетчер перетаскивания изменяет изображение курсора, показывая пользователю, какое действие будет совершено при отпускании. О планируемом действии сообщает свойство dropAction объекта NativeDragEvent. Действие, заданное для жеста перетаскивания, приводится исключительно для информации. Поведение компонентов, задействованных в передаче, должно быть соответствующим. Для завершения, например, действия перемещения инициатор перетаскивания может удалять перетаскиваемый объект, а целевой элемент — добавлять его.

Цель перетаскивания может ограничивать число действий отпускания до трех возможных с помощью свойства dropAction класса NativeDragManager. Если пользователь пытается выбрать другое действие с помощью клавиатуры, NativeDragManager отобразит курсор вида unavailable. В обработчиках событий nativeDragEnter и nativeDragOver следует задать свойство dropAction.

В примере ниже рассматривается обработчик событий nativeDragEnter и nativeDragOver. Этот обработчик принимает жест «перетаскивания в», только если перетаскиваемый объект буфера обмена содержит данные в текстовом формате.

import flash.desktop.NativeDragManager; 
import flash.events.NativeDragEvent; 
 
public function onDragIn(event:NativeDragEvent):void{ 
    NativeDragManager.dropAction = NativeDragActions.MOVE; 
    if(event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){ 
        NativeDragManager.acceptDragDrop(this); //'this' is the receiving component 
    } 
}

Когда пользователь отпускает перетаскиваемый элемент на интерактивном объекте, принимающем этот жест, тот отправляет событие nativeDragDrop. Обработчик этого события может извлекать данные из свойства clipboard объекта события.

Когда в буфере обмена содержится поддерживаемый приложением формат, параметр transferMode, передаваемый методу getData() объекта Clipboard, определяет, что должен возвращать диспетчер перетаскивания: ссылку или сериализованную версию объекта.

В примере ниже рассматривается обработчик события nativeDragDrop:

import flash.desktop.Clipboard; 
import flash.events.NativeDragEvent; 
 
public function onDrop(event:NativeDragEvent):void { 
    if (event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)) { 
    var text:String = 
        String(event.clipboard.getData(ClipboardFormats.TEXT_FORMAT,  
                                    ClipboardTransferMode.ORIGINAL_PREFERRED)); 
}

При появлении обработчика события объект Clipboard перестает действовать. Любая попытка доступа к этому объекту или его данным возвращает ошибку.

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

Пока жест перетаскивания выполняется в границах компонента, отправляются события nativeDragOver. Эти события отправляются каждые несколько миллисекунд и при любом движении мыши. Объект события nativeDragOver может использоваться для определения положения мыши в границах компонентом. Доступ к положению мыши полезен в тех ситуациях, когда компонент-получатель является сложным, но при этом не состоит из нескольких компонентов. Например, если в приложении отображается растровое изображение карты города и на нем при перетаскивании информации требуется выделить некоторые области, то данные о координатах мыши можно получить с помощью события nativeDragOver, позволяющего отслеживать положение мыши на карте.