NativeDragEvent

Пакет	flash.events
Класс	public class NativeDragEvent
Наследование	NativeDragEvent MouseEvent Event Object

Язык версии:

ActionScript 3.0

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

AIR 1.0

События собственного перетаскивания отправляются интерактивными объектами, участвующими в операции перетаскивания.

Инициирующий объект отправляет:

nativeDragStart в момент начала операции перетаскивания;
nativeDragUpdate по ходу выполнения операции перетаскивания;
nativeDragComplete, когда пользователь отпускает перетаскиваемый объект (независимо от того, принято ли новое положение объекта).

Инициирующий объект — это передаваемый интерактивный объект, то есть объект NativeDragManager в вызове метода NativeDragManager.doDrag(), начавшего операцию перетаскивания.

Потенциальные целевые интерактивные объекты отправляют:

nativeDragEnter при попадании траектории перетаскивания в границы объекта;
nativeDragOver во время пребывания жеста перетаскивания в границах объекта;
nativeDragExit при выходе жеста перетаскивания за границы объекта;
nativeDragDrop, когда пользователь отпускает перетаскиваемый элемент над объектом и он отпускается, предварительно вызвав метод NativeDragManager.acceptDragDrop().

Как правило, обработчик события nativeDragEnter или nativeDragOver оценивает перетаскиваемые данные и допустимые действия перетаскивания, чтобы определить, может ли интерактивный объект принять опускание. Чтобы указать, что интерактивный объект может быть целью, обработчик событий должен вызвать функцию NativeDragManager.acceptDrop(), передающую ссылку на объект. Если пользователь отпускает кнопку мыши над заданным объектом, этот объект становиться целью опускания и отправляет событие nativeDragDrop.

Любой объект типа InteractiveObject может быть инициатором перетаскивания или целью опускания.

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

flash.desktop.NativeDragManager
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject

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

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

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

	Свойство		Определено
		allowedActions : NativeDragOptions Объект NativeDragOptions, указывающий действия, разрешенные экранным объектом, инициировавшим данную операцию перетаскивания.	NativeDragEvent
		altKey : Boolean Показывает активность клавиши Alt: true — активна, false — неактивна.	MouseEvent
		bubbles : Boolean [только для чтения] Определяет, является ли событие событием восходящей цепочки.	Event
		buttonDown : Boolean Указывает состояние левой кнопки мыши: нажата (true) или не нажата (false).	MouseEvent
		cancelable : Boolean [только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.	Event
		clickCount : int [только для чтения] Указывает на то, является ли событие для нажатого положения мыши частью последовательности нажатий мышью.	MouseEvent
		clipboard : Clipboard Объект Clipboard, содержащий данные этой операции перетаскивания.	NativeDragEvent
		commandKey : Boolean Указывает, активирована ли клавиша Command (только для Mac). Свойство commandKey будет иметь то же значение, что и свойство ctrlKey в Mac.	MouseEvent
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		controlKey : Boolean Указывает, активирована ли клавиша Control в Mac или клавиша Ctrl в Windows или Linux.	MouseEvent
		ctrlKey : Boolean В Windows или Linux указывает на то, активирована ли клавиша Ctrl (true) или нет (false).	MouseEvent
		currentTarget : Object [только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.	Event
		delta : int Указывает количество строк, подлежащих прокрутке в каждом случае вращения пользователем колесика мыши.	MouseEvent
		dropAction : String Текущее действие.	NativeDragEvent
		eventPhase : uint [только для чтения] Текущая фаза в потоке событий.	Event
		isRelatedObjectInaccessible : Boolean Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности.	MouseEvent
		localX : Number Если блокировка мыши отключена, горизонтальная координата, в которой произошло событие, относительно контейнера-спрайта.	MouseEvent
		localY : Number Если блокировка мыши отключена, вертикальная координата, в которой произошло событие, относительно контейнера-спрайта.	MouseEvent
		movementX : Number Когда блокировка мыши включена, изменение положения мыши в направлении X с последнего события мыши.	MouseEvent
		movementY : Number Когда блокировка мыши включена, изменение положения мыши в направлении Y с последнего события мыши.	MouseEvent
		relatedObject : InteractiveObject Ссылка на объект списка отображения, связанный с событием.	MouseEvent
		shiftKey : Boolean Показывает активность клавиши Shift: true — активна, false — неактивна.	MouseEvent
		stageX : Number [только для чтения] Горизонтальная координата события в глобальных координатах рабочей области.	MouseEvent
		stageY : Number [только для чтения] Вертикальная координата события в глобальных координатах рабочей области.	MouseEvent
		target : Object [только для чтения] Целевой объект события.	Event
		type : String [только для чтения] Тип события.	Event

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

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

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

	Метод		Определено
		NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false) Создает объект Event со специфической информацией, имеющей отношение к собственным событиям перетаскивания.	NativeDragEvent
		clone():Event [переопределить] Создает копию данного объекта NativeDragEvent.	NativeDragEvent
		formatToString(className:String, ... arguments):String Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.	Event
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isDefaultPrevented():Boolean Проверяет, выполнялся ли для события вызова метода preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		preventDefault():void Отменяет поведение по умолчанию для события, если такое поведение можно отменить.	Event
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stopImmediatePropagation():void Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.	Event
		stopPropagation():void Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.	Event
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String [переопределить] Форматирует свойства данного объекта NativeDragEvent в виде строки.	NativeDragEvent
		updateAfterEvent():void Предписывает проигрывателю Flash Player или Adobe AIR выполнить визуализацию после обработки данного события, если список отображения был изменен.	MouseEvent
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

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

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

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

	Константа		Определено
		NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [статические] NativeDragEvent.NATIVE_DRAG_COMPLETE определяет значение свойства type объекта события nativeDragComplete.	NativeDragEvent
		NATIVE_DRAG_DROP : String = "nativeDragDrop" [статические] NativeDragEvent.NATIVE_DRAG_DROP определяет значение свойства type объекта события nativeDragDrop.	NativeDragEvent
		NATIVE_DRAG_ENTER : String = "nativeDragEnter" [статические] NativeDragEvent.NATIVE_DRAG_ENTER определяет значение свойства type объекта события nativeDragEnter.	NativeDragEvent
		NATIVE_DRAG_EXIT : String = "nativeDragExit" [статические] NativeDragEvent.NATIVE_DRAG_EXIT определяет значение свойства type объекта события nativeDragExit.	NativeDragEvent
		NATIVE_DRAG_OVER : String = "nativeDragOver" [статические] NativeDragEvent.NATIVE_DRAG_OVER определяет значение свойства type объекта события nativeDragOver.	NativeDragEvent
		NATIVE_DRAG_START : String = "nativeDragStart" [статические] NativeDragEvent.NATIVE_DRAG_START определяет значение свойства type объекта события nativeDragStart.	NativeDragEvent
		NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [статические] NativeDragEvent.NATIVE_DRAG_UPDATE определяет значение свойства type объекта события nativeDragUpdate.	NativeDragEvent

Сведения о свойстве

allowedActions

свойство

public var allowedActions:NativeDragOptions

Язык версии:

ActionScript 3.0

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

AIR 1.0

Объект NativeDragOptions, указывающий действия, разрешенные экранным объектом, инициировавшим данную операцию перетаскивания.

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

flash.desktop.NativeDragOptions

clipboard

свойство

public var clipboard:Clipboard

Язык версии:

ActionScript 3.0

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

AIR 1.0

Объект Clipboard, содержащий данные этой операции перетаскивания.

Если объект, отправивший событие, находится не в том же домене защиты, что и объект-инициатор, то буфер обмена может считываться только в обработчике события nativeDragDrop.

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

flash.desktop.Clipboard

dropAction

свойство

public var dropAction:String

Язык версии:

ActionScript 3.0

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

AIR 1.0

Текущее действие. В событии nativeDragComplete свойство dropAction сообщает окончательное действие.

Сведения о конструкторе

()

Конструктор

public function NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false)

Язык версии:

ActionScript 3.0

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

AIR 1.0

Создает объект Event со специфической информацией, имеющей отношение к собственным событиям перетаскивания.

Объекты Event передаются прослушивателям событий в качестве параметров. Отправка события собственного перетаскивания не запускает связанного с этим поведения.

Параметры

	`type:String` — Тип события. Возможные значения: `NativeDragEvent.NATIVE_DRAG_START`, `NativeDragEvent.NATIVE_DRAG_UPDATE`, `NativeDragEvent.NATIVE_DRAG_ENTER`, `NativeDragEvent.NATIVE_DRAG_OVER`, `NativeDragEvent.NATIVE_DRAG_EXIT`, `NativeDragEvent.NATIVE_DRAG_DROP` и `NativeDragEvent.NATIVE_DRAG_COMPLETE`.

	`bubbles:Boolean` (default = `false`) — Указывает, участвует ли объект Event в фазе восходящей цепочки потока событий.

	`cancelable:Boolean` (default = `true`) — Указывает, можно ли отменить объект Event.

	`localX:Number` (default = `NaN`) — Горизонтальная координата события относительно спрайта-контейнера.

	`localY:Number` (default = `NaN`) — Вертикальная координата события относительно спрайта-контейнера.

	`relatedObject:InteractiveObject` (default = `null`) — Связанный интерактивный экранный объект.

	`clipboard:Clipboard` (default = `null`) — Объект Clipboard, содержащий передаваемые данные.

	`allowedActions:NativeDragOptions` (default = `null`) — Объект NativeDragOptions, определяющий допустимые действия (перемещение, копирование или ссылка).

	`dropAction:String` (default = `null`) — Текущее действие.

	`controlKey:Boolean` (default = `false`) — Указывает, активирована ли клавиша Control.

	`altKey:Boolean` (default = `false`) — Указывает, активирована ли клавиша Alt.

	`shiftKey:Boolean` (default = `false`) — Указывает, активирована ли клавиша Shift.

	`commandKey:Boolean` (default = `false`) — Указывает, активирована ли клавиша Command.

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

clone

()

метод

override public function clone():Event

Язык версии:

ActionScript 3.0

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

AIR 1.0

Создает копию данного объекта NativeDragEvent.

Возвращает

Event — Новый объект NativeDragEvent, значения свойств которого соответствуют значениям оригинала.

toString

()

метод

override public function toString():String

Язык версии:

ActionScript 3.0

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

AIR 1.0

Форматирует свойства данного объекта NativeDragEvent в виде строки.

Строка имеет следующий формат:

[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]

Возвращает

String — Свойства данного объекта NativeDragEvent в виде строки.

Сведения о константе

NATIVE_DRAG_COMPLETE

Константа

public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_COMPLETE определяет значение свойства type объекта события nativeDragComplete.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragComplete
flash.desktop.NativeDragActions

NATIVE_DRAG_DROP

Константа

public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_DROP определяет значение свойства type объекта события nativeDragDrop.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`true`; отмена данного события отменяет операцию перетаскивания.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться даже если объект, отправивший данное событие находится не в том же домене защиты, что и инициатор.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragDrop

NATIVE_DRAG_ENTER

Константа

public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_ENTER определяет значение свойства type объекта события nativeDragEnter.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragEnter

NATIVE_DRAG_EXIT

Константа

public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_EXIT определяет значение свойства type объекта события nativeDragExit.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragExit

NATIVE_DRAG_OVER

Константа

public static const NATIVE_DRAG_OVER:String = "nativeDragOver"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_OVER определяет значение свойства type объекта события nativeDragOver.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`true`; отмена данного события отменяет операцию перетаскивания.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные. Буфер обмена может считываться только если объект, отправивший данное событие находится том же домене защиты, что и инициатор.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragOver

NATIVE_DRAG_START

Константа

public static const NATIVE_DRAG_START:String = "nativeDragStart"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_START определяет значение свойства type объекта события nativeDragStart.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`true`; отмена данного события отменяет операцию перетаскивания.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragStart

NATIVE_DRAG_UPDATE

Константа

public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"

Язык версии:

ActionScript 3.0

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

AIR 1.0

NativeDragEvent.NATIVE_DRAG_UPDATE определяет значение свойства type объекта события nativeDragUpdate.

Это событие имеет следующие свойства:

Свойство	Значение
`allowedActions`	Объект NativeDragOptions, указывающий действия, имеющие отношение к данной операции перетаскивания.
`bubbles`	`true`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`clipboard`	Объект Clipboard, содержащий перетаскиваемые данные.
`dropAction`	Действие, выбранное целью опускания (или `none`, если действие не было задано).

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

flash.display.InteractiveObject.nativeDragUpdate

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

NativeDragEvent - AS3

Классы x

allowedActions

clipboard

dropAction