DragManager - Adobe ActionScript® 3 (AS3 Flex)

Пакет	mx.managers
Класс	public class DragManager
Наследование	DragManager Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс DragManager управляет функциями перетаскивания, позволяющими перемещать данные из одного места в другое в рамках приложения Flex. Например, можно выбрать объект, такой как элемент управления List, или элемент управления Flex, или элемент управления Image, и затем перетащить его поверх другого компонента для добавления к этому компоненту.

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

Все компоненты Flex поддерживают функции перетаскивания. Flex обеспечивает дополнительную поддержку перетаскивания в элементы управления List, Tree и DataGrid.

Когда пользователь выбирает какой-либо элемент с помощью указателя мыши, выбранный компонент называется инициатором перетаскивания. Значок, отображаемый при осуществлении операции перетаскивания, называется прокси перетаскивания.

Когда пользователь перемещает прокси перетаскивания на другой компонент, этому компоненту отправляется событие dragEnter. Если компонент принимает перетаскивание, он становится адресатом перетаскивания и получает события dragOver, dragExit и dragDrop.

Когда перетаскивание завершено, в инициатор перетаскивания передается событие dragComplete.

Связанные элементы API

mx.core.DragSource
mx.events.DragEvent
mx.core.UIComponent

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		isDragging : Boolean [статические] [только для чтения] Доступное только для чтения свойство, которое возвращает true во время выполнения перетаскивания.	DragManager

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		acceptDragDrop(target:IUIComponent):void [статические] В случае согласия на прием перетаскиваемых данных вызовите этот метод из обработчика событий 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
		getFeedback():String [статические] Возвращает текущую обратную связь перетаскивания.	DragManager
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		showFeedback(feedback:String):void [статические] Устанавливает индикатор обратной связи для операции перетаскивания.	DragManager
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():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

свойство

isDragging:Boolean [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Доступное только для чтения свойство, которое возвращает true во время выполнения перетаскивания.

Реализация
public static function get isDragging():Boolean

Сведения о методе

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.

Юридическая информация | Политика конфиденциальности онлайн

DragManager - AS3 Flex

Классы x

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE