ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: AIR 30.0 i wcześniejsze, Flash Player 30.0 i wcześniejsze, Flash Lite 4
Flex 4.6 i wcześniejsze, Flash Pro CS6 i wcześniejsze
Ukryj filtry
flash.desktop 

NativeDragManager  - AS3

Pakietyx

Najwyższy poziom
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementy językowe

Stałe globalne
Funkcje globalne
Operatory
Instrukcje, słowa kluczowe i dyrektywy
Typy specjalne

Dodatki

Nowości
Błędy kompilatora
Ostrzeżenia kompilatora
Błędy czasu wykonywania
Migracja kodu ActionScript 3
Obsługiwane zestawy znaków
Tylko MXML
Elementy XML dotyczące ruchu
Znaczniki tekstu z synchronizacją czasową
Przestarzały indeks
Stałe implementacji dostępności
Instrukcje dotyczące przykładów
Informacje prawne
Pakietflash.desktop
Klasapublic class NativeDragManager
DziedziczenieNativeDragManager Inheritance Object

Wersje środowiska wykonawczego: AIR 1.0

Klasa NativeDragManager koordynuje operacje przeciągania i upuszczania. Dzięki macierzystemu interfejsowi API przeciągania i upuszczania użytkownik może transportować dane między aplikacją AIR i macierzystym systemem operacyjnym, pomiędzy dwoma aplikacjami lub pomiędzy składnikami pojedynczej aplikacji.

Można przesyłać następujące rodzaje danych:

  • Bitmapy
  • Pliki
  • Tekst
  • Ciągi URL
  • Obiekty serializowane
  • Odwołania obiektów (poprawne jedynie w aplikacji źródłowej)

Uwaga: wszystkie elementy menedżera NativeDragManager są statyczne. Instancja tej klasy nie musi być tworzona.

Operacja przeciągnij i upuść jest ruchem interfejsu użytkownika, który zaczyna się kliknięciem widocznego elementu, a następnie przeciągnięciu go w inne miejsce. W trakcie przeciągania obiekty interaktywne listy wyświetlania wywołują macierzyste zdarzenia przeciągania w momencie przesunięcia się na okno aplikacji AIR. Moduły obsługi dla tych zdarzeń mogą wywołać metody NativeDragManager, w celu określenia, czy przeciągany element może być upuszczony na obiekt. Jednocześnie NativeDragManager zmieni wygląd wskaźnika myszy, w celu dostarczenia użytkownikowi informacji zwrotnych.

Obsługa profilów AIR: Ta funkcja nie jest obsługiwana na urządzeniach telewizyjnych ze środowiskiem AIR. Nie jest też obsługiwana na niektórych urządzeniach przenośnych. W czasie wykonywania można sprawdzić, czy ta funkcja jest obsługiwana, odczytując właściwość NativeDragManager.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Akcje przeciągania

Operacje przeciągnij i upuść są z reguły stosowane dla trzech typów operacji zwanych akcjami. Ponieważ znaczenie tych akcji zależy od kontekstu aplikacji, środowisko wykonawcze nie wymusza żadnych konkretnych operacji względem akcji. Jednakże właściwa implementacja akcji usprawni pracę użytkownika z aplikacją.

Możliwe są następujące akcje:

  • Kopiowanie — tworzona jest kopia danych, pozostawiając oryginał nietknięty. (Podczas przeciągania obiektów w aplikacji należy uważnie skopiować oryginalny obiekt, a nie odwołanie do niego).
  • Przesuwanie — dane przenoszone są z oryginalnego kontekstu do kontekstu określonego przez obiekt docelowy, na przykład przenoszenie elementu z jednej listy do drugiej.
  • Łączenie — tworzone jest odwołanie lub skrót do oryginalnych danych, pozostawiając element w oryginalnym kontekście.

Można ustawić akcje dozwolone dla ruchu przeciągania poprzez dostarczenie parametru allowedActions w menedżerze NativeDragManager.doDrag(), który rozpoczyna tę operację. Jeśli nie ma dostarczonego parametru allowedActions dozwolone są wszystkie akcje. Potencjalne cele przeciągania mogą sprawdzić które akcje są dozwolone stosując właściwość allowedActions obiektu NativeDragEvent, oraz nie powinny akceptować upuszczeń, na które pozwalałyby jedynie akcje niekompatybilne (jednak nie jest to wymuszane przez środowisko wykonawcze).

Jeżeli cel upuszczania implementuje jedynie pojedynczą akcję, obiekt może ustawić właściwość dropAction obiektu NativeDragManager w modułach obsługi dla obu zdarzeń: nativeDragEnter oraz nativeDragOver. Ustawienie właściwości przed upuszczeniem pozwala menedżerowi przeciągania na aktualizowanie wskaźnika myszy w celu wskazania obsługiwanej akcji i jednocześnie ogranicza możliwość wybrania przez użytkownika niezgodnej akcji za pomocą klawiszy modyfikujących. Jeśli określona akcja nie jest jedną z dozwolonych akcji, wówczas upuszczenie jest niedozwolone, nawet jeśli cel wywoła metodęacceptDrop().

Podczas akceptowania upuszczenia potencjalny cel upuszczenia powinien wskazywać akcję wybraną przez właściwość NativeDragManager.dropAction w odpowiedzi na zdarzenie nativeDragDrop. Akcja ta jest raportowana z powrotem do wyświetlanego obiektu inicjującego zdarzenia nativeDragComplete. Jeśli żadna akcja nie jest określana przez cel upuszczenia, wówczas akcja domyślna wybierana jest spośród akcji dozwolonych, w następującej kolejności: kopiowanie, przesuwanie, łączenie. Obiekt inicjujący jest odpowiedzialny za uaktualnianie swego stanu wewnętrznego w odpowiedzi na wybraną akcję.

Stałe ciągów znaków dla nazw akcji są zdefiniowane w klasie NativeDragActions.

Kolejność zdarzeń

Ruch przeciągania rozpoczyna się wywołaniem metody NativeDragManager.doDrag() wewnątrz modułów obsługi zdarzeń mouseDown lub mouseMove i w odpowiedzi na akcje użytkownika przechodzi przez następującą sekwencję zdarzeń:

  • Zdarzenie nativeDragStart — gdy wywołana jest metoda NativeDragManager.doDrag() obiekt interaktywny przekazany jako parametr metody staje się obiektem inicjującym i wywołuje zdarzenie nativeDragStart.
  • Zdarzenie nativeDragUpdate — gdy przeciąganie jest w toku, obiekt inicjujący będzie ciągle wywoływać zdarzenia nativeDragUpdate.
  • Zdarzenia nativeDragEnter, nativeDragOver — kiedy operacja przeciągania znajdzie się nad obiektem interaktywnym, wywołane zostanie zdarzenienativeDragEnter. Kiedy operacja przeciągania pozostaje nad obiektem interaktywnym, zdarzenia nativeDragOver będą ciągle wywoływane. W odpowiedzi na dowolne z tych dwóch zdarzeń obiekt będący potencjalnym celem upuszczenia powinien sprawdzić właściwości obiektu zdarzenia, aby zadecydować o akceptacji upuszczenia. Jeśli format danych i dozwolone akcje są prawidłowe moduł obsługi zdarzeń musi wywołać metodę NativeDragManager.acceptDrop(), przekazując odwołanie do obiektu wyświetlanego, który będzie celem przeciągnięcia (z reguły obiekt który wywołał zdarzenie nativeDragEnter lub nativeDragOver). Użytkownik będzie mógł wówczas upuścić przeciągany element na cel.
  • Zdarzenie nativeDragExit — kiedy operacja przeciągania zostanie przesunięta poza obiekt interaktywny, wówczas obiekt wywoła zdarzenie nativeDragExit. Jeśli obiekt został określony jako cel przeciągnięcia wcześniejszego wywołania metody NativeDragManager.acceptDrop(), wówczas to wywołanie nie jest już prawidłowe i metoda acceptDrop() musi zostać wywołana ponownie jeśli ruch znajdzie się ponownie nad obiektem interaktywnym.
  • Zdarzenie nativeDragDrop — docelowy obiekt wyświetlany wywołuje zdarzenie nativeDragDrop, gdy użytkownik zwalnia przycisk myszy nad tym obiektem. Moduł dla tego zdarzenia ma dostęp do danych we właściwości transferable obiektu zdarzenia oraz powinien ustawić właściwość NativeDragManager.dropAction do sygnalizacji która akcja powinna zostać podjęta przez obiekt inicjujący.
  • Zdarzenie nativeDragComplete — gdy użytkownik zwalania przycisk myszy na końcu ruchu przeciągania, obiekt inicjujący wywołuje zdarzenie nativeDragComplete (bez względu na to, czy upuszczenie zostało zrealizowane). Moduł dla tego zdarzenia może sprawdzić właściwość dropAction obiektu zdarzenia, aby zdecydować, czy należy wprowadzić jakiekolwiek modyfikacje do wewnętrznego stanu danych, takich jak usuwanie elementów wyciągniętych z listy. Jeśli właściwość dropAction ma wartość NativeDragActions.NONE, wówczas przeciągany element nie został upuszczony na właściwy cel.

Ruchy między aplikacjami

Kiedy ruch przeciągania wchodzi na okno aplikacji AIR z aplikacji innej niż AIR, wówczas nie ma obiektu inicjującego, który wywoła zdarzenie nativeDragStart lub nativeDragComplete. W innym wypadku zdarzenia wywoływane podczas ruchu będą postępować według tego samego wzorca, jak ruch rozpoczynający się i kończący w tej samej aplikacji AIR.

Kiedy ruch przeciągania opuszcza okno aplikacji AIR, wówczas nie ma obiektu docelowego, który wywoła zdarzenia nativeDragEnter, nativeDragOver lub nativeDragDrop Obiekt inicjujący wciąż wywołuje zdarzenie nativeDragComplete, które raportuje akcję przeciągania, określoną przez macierzysty system operacyjny (lub none, jeśli upuszczenie nie zostało zaakceptowane).

Kiedy ruch przeciągania przesuwa się z jednej aplikacji AIR do drugiej, obiekty inicjujące i wyświetlane obiekty docelowe dysponują odpowiednie zdarzenia w swoich aplikacjach.

Przenoszenie informacji

Dane przenoszone podczas ruchu przeciągania i upuszczania są zawarte w obiekcie Clipboard. Obiekt danych jest dodawany do operacji przeciągania przez metodę NativeDragManager.doDrag(), która rozpoczyna ruch przeciągania. Potencjalne cele upuszczania mają dostęp do obiektu Clipboard poprzez właściwość clipboard obiektu zdarzenia przeciągania. Po rozpoczęciu operacji przeciągania, dostęp do obiektu Clipboard ma tylko moduł obsługi zdarzeń obiektu NativeDragEvent. Jakakolwiek inna próba otrzymania dostępu do obiektu generuje błąd uruchamiania.

Uwagi na temat bezpieczeństwa

Obszary izolowane obiektów inicjujących i potencjalnych obiektów docelowych określają sposób, w jaki można otrzymać dostęp do przeciąganych danych. Jeżeli oba obiekty znajdują się w tym samym obszarze izolowanym, wówczas do danych istnieje dostęp z dowolnego obiektu NativeDragEvent. W przypadku gdy obiekt inicjujący i obiekt docelowy znajdują się w różnych obszarach izolowanych, dostęp do danych jest możliwy tylko w docelowym obszarze izolowanym wewnątrz modułu obsługi zdarzeń (dotyczącego zdarzenia nativeDragDrop). Inne macierzyste moduły obsługi zdarzeń mają dostęp do obiektu Clipboard, do którego było odwołanie we właściwościach zdarzenia clipboard, w celu ustalenia które z formatów danych są dostępne, jednakże wywołanie metody clipboard.getData() generuje błąd bezpieczeństwa.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
      dragInitiator : InteractiveObject
[statyczny] [tylko do odczytu] Obiekt interaktywny przekazał do metody NativeDragManager.doDrag() wywołanie, które zainicjowało operację przeciągania.
NativeDragManager
      dropAction : String
[statyczny] Operacja przeciągania określona przez cel upuszczenia.
NativeDragManager
      isDragging : Boolean
[statyczny] [tylko do odczytu] Wskazuje, czy obecnie trwa operacja przeciągania.
NativeDragManager
      isSupported : Boolean
[statyczny] [tylko do odczytu] Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest obsługiwana klasa NativeDragManager; w przeciwnym razie ma wartość false.
NativeDragManager
Metody publiczne
 MetodaZdefiniowane przez
  
[statyczny] Informuje obiekt NativeDragManager, że wybrany docelowy obiekt interaktywny może przyjąć upuszczenie określone przez obecne zdarzenie przeciągania.
NativeDragManager
  
    doDrag(dragInitiator:InteractiveObject, clipboard:Clipboard, dragImage:BitmapData = null, offset:Point = null, allowedActions:NativeDragOptions = null):void
[statyczny] Rozpoczyna operację przeciągania i upuszczania.
NativeDragManager
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Szczegół właściwości
    

dragInitiator

właściwość
dragInitiator:InteractiveObject  [tylko do odczytu]

Wersje środowiska wykonawczego: AIR 1.0

Obiekt interaktywny przekazał do metody NativeDragManager.doDrag() wywołanie, które zainicjowało operację przeciągania.



Implementacja
    public static function get dragInitiator():InteractiveObject
    

dropAction

właściwość 
dropAction:String

Wersje środowiska wykonawczego: AIR 1.0

Akcja przeciągania określona przez cel upuszczenia.

Właściwość dropAction powinna być ustawiona w module obsługi zdarzenia nativeDragDrop. Jeśli właściwość dropAction nie zostanie ustawiona przed właściwością nativeDragComplete, wówczas menedżer NativeDragManager ustawi tę wartość jako pierwszą dozwoloną akcję z listy: copy, move lub link (w tej kolejności).



Implementacja
    public static function get dropAction():String
    public static function set dropAction(value:String):void

Powiązane elementy interfejsu API

    

isDragging

właściwość 
isDragging:Boolean  [tylko do odczytu]

Wersje środowiska wykonawczego: AIR 1.0

Wskazuje, czy operacja przeciągania jest obecnie w trakcie wykonania.



Implementacja
    public static function get isDragging():Boolean
    

isSupported

właściwość 
isSupported:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2

Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest obsługiwana klasa NativeDragManager; w przeciwnym razie ma wartość false.



Implementacja
    public static function get isSupported():Boolean
Szczegół metody

    acceptDragDrop

()metoda
public static function acceptDragDrop(target:InteractiveObject):void

Wersje środowiska wykonawczego: AIR 1.0

Informuje obiekt NativeDragManager, że wybrany docelowy obiekt interaktywny może przyjąć upuszczenie określone przez obecne zdarzenie przeciągania.

Ta metoda powinna być wywoływana tylko w sytuacji, gdy istnieje moduł obsługi nativeDragDrop na wybranym obiekcie docelowym, który jest w stanie obsłużyć chociaż jeden z formatów danych w przeciąganym elemencie oraz przynajmniej jedną z dozwolonych akcji.

Ta funkcja może być wywołana jedynie wewnątrz modułów obsługi zdarzeń nativeDragEnter lub nativeDragOver.

Parametry

target:InteractiveObject

    doDrag

()metoda 
public static function doDrag(dragInitiator:InteractiveObject, clipboard:Clipboard, dragImage:BitmapData = null, offset:Point = null, allowedActions:NativeDragOptions = null):void

Wersje środowiska wykonawczego: AIR 1.0

Rozpoczyna operację przeciągania i upuszczania.

Aby rozpocząć operację przeciągania należy:

  1. Utworzyć nowy obiekt Clipboard.
  2. Dodać dane, które mają być przeniesione w jednym lub więcej formatów.
  3. Opcjonalnie, stworzyć obiekt BitmapData, który będzie służył jako obraz proxy w trakcie przeciągania.
  4. Opcjonalnie, stworzyć obiekt NativeDragOptions, aby ograniczyć akcje dozwolone dla tej operacji. (Jeśli parametr allowedActions ma wartość null, wówczas wszystkie akcje są dozwolone).
  5. Wywołać metodę NativeDragManager.doDrag().

Obiekt inicjujący wywołuje zdarzenie nativeDragStart po wywołaniu tej metody, zdarzenie nativeDragStart w trakcie przeciągania oraz zdarzenie nativeDragComplete, kiedy użytkownik zwolni przycisk myszy w celu zakończenia ruchu przeciągania. Moduł obsługi dla zdarzenia nativeDragComplete może sprawdzić właściwość dropAction zdarzenia aby określić, czy operacja przeciągania i upuszczania została zakończona pomyślnie. Jeśli dropAction ma wartość NativeDragActions.NONE, wówczas przeciągany element nie został upuszczony na właściwy cel.

Ta metoda może być wywołana wyłącznie z wnętrza modułu obsługi zdarzeń mouseDown lub mouseMove. (Jeżeli wywołana w odpowiedzi na zdarzenie mouseMove, wówczas przycisk myszy musi również być wciśnięty).

Parametry

dragInitiator:InteractiveObject — Z reguły obiekt, od którego rozpoczął się ruch przeciągania. Otrzymuje zdarzenia nativeDragStart oraz nativeDragComplete.
 
clipboard:Clipboard — Obiekt kontenera dla przeciąganych danych.
 
dragImage:BitmapData (default = null) — Opcjonalny obraz proxy wyświetlony pod wskaźnikiem myszy w czasie ruchu przeciągania. Jeśli wartość jest równa null, obraz nie jest wyświetlany.
 
offset:Point (default = null) — Przesunięcie pomiędzy punktem aktywnym myszy, a górnym lewym rogiem przeciąganego obrazu. Ujemne współrzędne przesuwają obraz w górę i w lewo względem punktu aktywnego myszy. Jeśli wartość jest równa null, wówczas górny lewy róg obrazu przeciągania zostanie ustawiony w punkcie aktywnym myszy.
 
allowedActions:NativeDragOptions (default = null) — Ogranicza akcje przeciągania i upuszczania dozwolone dla tej operacji. Jeśli wartość jest równa null, wówczas wszystkie akcje są dozwolone.

Powiązane elementy interfejsu API





[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.