| Пакет | mx.managers |
| Класс | public class DragManager |
| Наследование | DragManager Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Все методы и свойства DragManager являются статическими, следовательно, создавать его экземпляр не требуется.
Все компоненты Flex поддерживают функции перетаскивания. Flex обеспечивает дополнительную поддержку перетаскивания в элементы управления List, Tree и DataGrid.
Когда пользователь выбирает какой-либо элемент с помощью указателя мыши, выбранный компонент называется инициатором перетаскивания. Значок, отображаемый при осуществлении операции перетаскивания, называется прокси перетаскивания.
Когда пользователь перемещает прокси перетаскивания на другой компонент, этому компоненту отправляется событие dragEnter. Если компонент принимает перетаскивание, он становится адресатом перетаскивания и получает события dragOver, dragExit и dragDrop.
Когда перетаскивание завершено, в инициатор перетаскивания передается событие dragComplete.
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| isDragging : Boolean [статические] [только для чтения]
Доступное только для чтения свойство, которое возвращает true во время выполнения перетаскивания. | DragManager | ||
| Метод | Определено | ||
|---|---|---|---|
[статические]
В случае согласия на прием перетаскиваемых данных вызовите этот метод из обработчика событий dragEnter. | DragManager | ||
doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void [статические]
Инициирует операцию перетаскивания. | DragManager | ||
[статические]
Возвращает текущую обратную связь перетаскивания. | DragManager | ||
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
[статические]
Устанавливает индикатор обратной связи для операции перетаскивания. | DragManager | ||
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
| Стиль | Описание | Определено | ||
|---|---|---|---|---|
copyCursor | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Курсор, отображаемый при осуществлении операции копирования. Значением по умолчанию является символ mx.skins.cursor.DragCopy в файле Assets.swf. | DragManager | ||
defaultDragImageSkin | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Тема оформления, используемая для отображения значка перетаскивания по умолчанию, называемого также прокси перетаскивания. Значением по умолчанию является mx.skins.halo.DefaultDragImage (for both Halo and Spark themes). | DragManager | ||
linkCursor | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Курсор, отображаемый при осуществлении операции ссылки. Значением по умолчанию является символ mx.skins.cursor.DragLink в файле Assets.swf. | DragManager | ||
moveCursor | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Курсор, отображаемый при осуществлении операции перемещения. Значением по умолчанию является символ mx.skins.cursor.DragMove в файле Assets.swf. | DragManager | ||
rejectCursor | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Курсор, отображаемый для операции отклонения. Значением по умолчанию является символ mx.skins.cursor.DragReject в файле Assets.swf. | DragManager | ||
| Константа | Определено | ||
|---|---|---|---|
| COPY : String = "copy" [статические]
Константа, указывающая, что типом действия перетаскивания является copy. | DragManager | ||
| LINK : String = "link" [статические]
Константа, указывающая, что типом действия перетаскивания является link. | DragManager | ||
| MOVE : String = "move" [статические]
Константа, указывающая, что типом действия перетаскивания является move. | DragManager | ||
| NONE : String = "none" [статические]
Константа, указывающая, что типом действия перетаскивания является none. | DragManager | ||
isDragging | свойство |
acceptDragDrop | () | метод |
public static function acceptDragDrop(target:IUIComponent):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
В случае согласия на прием перетаскиваемых данных вызовите этот метод из обработчика событий dragEnter. Как правило, event.target приводится к типу данных целевого объекта перетаскивания. В примере ниже целевым объектом перетаскивания является контейнер MX Canvas:
DragManager.acceptDragDrop(Canvas(event.target));
Параметры
target:IUIComponent — Адресат перетаскивания, принимающий это перетаскивание.
|
doDrag | () | метод |
public static function doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Инициирует операцию перетаскивания.
Параметры
dragInitiator:IUIComponent — IUIComponent, указывающий инициирующий перетаскивание компонент.
| |
dragSource:DragSource — Объект DragSource, содержащий перетаскиваемые данные.
| |
mouseEvent:MouseEvent — MouseEvent, содержащий информацию о положении мыши для начала перетаскивания.
| |
dragImage:IFlexDisplayObject (default = null) — Перетаскиваемое изображение. Этот аргумент является необязательным. Если он опущен, то в течение функции перетаскивания используется стандартный прямоугольник перетаскивания. При указании изображения следует явно установить высоту и ширину изображения, иначе оно не будет отображено.
| |
xOffset:Number (default = 0) — Число, указывающее смещение по оси x в пикселях для dragImage. Этот аргумент является необязательным. Если оно опущено, то прокси перетаскивания отображается в левом верхнем углу инициатора перетаскивания. Смещение выражается в пикселях от левого края прокси перетаскивания до левого края инициатора перетаскивания, и обычно является отрицательным числом.
| |
yOffset:Number (default = 0) — Число, указывающее смещение по оси y в пикселях для dragImage. Этот аргумент является необязательным. Если оно опущено, то прокси перетаскивания отображается в левом верхнем углу инициатора перетаскивания. Смещение выражается в пикселях от верхнего края прокси перетаскивания до верхнего края инициатора перетаскивания, и обычно является отрицательным числом.
| |
imageAlpha:Number (default = 0.5) — Число, указывающее используемое для перетаскиваемого изображения значение альфа-канала. Этот аргумент является необязательным. Если оно опущено, то значением альфа-канала по умолчанию является 0,5. Значение 0,0 указывает, что изображение является прозрачным; значение 1,0 указывает, что оно полностью непрозрачно.
| |
allowMove:Boolean (default = true) — Указывает, разрешено ли цели операции перетаскивания переместить перетаскиваемые данные.
|
getFeedback | () | метод |
public static function getFeedback():String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает текущую обратную связь перетаскивания.
ВозвращаетString — Возможными возвращаемыми значениями являются DragManager.COPY, DragManager.MOVE, DragManager.LINK и DragManager.NONE.
|
showFeedback | () | метод |
public static function showFeedback(feedback:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает индикатор обратной связи для операции перетаскивания. Возможными значениями являются DragManager.COPY, DragManager.MOVE, DragManager.LINK и DragManager.NONE.
Параметры
feedback:String — Тип индикатора обратной связи для отображения.
|
COPY | Константа |
public static const COPY:String = "copy"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа, указывающая, что типом действия перетаскивания является copy.
LINK | Константа |
public static const LINK:String = "link"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа, указывающая, что типом действия перетаскивания является link.
MOVE | Константа |
public static const MOVE:String = "move"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа, указывающая, что типом действия перетаскивания является move.
NONE | Константа |
public static const NONE:String = "none"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа, указывающая, что типом действия перетаскивания является none.
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства