Пакет | 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