| Pakiet | flash.events |
| Klasa | public class NativeDragEvent |
| Dziedziczenie | NativeDragEvent  MouseEvent Event Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt inicjujący wywołuje zdarzenie:
-
nativeDragStart— w momencie rozpoczęcia operacji przeciągania; -
nativeDragUpdate— w trakcie operacji przeciągania; -
nativeDragComplete— gdy użytkownik zwolni przeciągany element (niezależnie od tego, czy upuszczenie zostało zaakceptowane).
Obiektem inicjującym jest obiekt interaktywny przekazany do obiektu NativeDragManager w wywołaniu metody NativeDragManager.doDrag(), które rozpoczęło operację przeciągania.
Potencjalne docelowe obiekty interaktywne wywołują zdarzenie:
-
nativeDragEnter— gdy przeciągany element zostanie wprowadzony do obiektu docelowego (przekroczy jego granicę); -
nativeDragOver— gdy przeciągany element znajduje się w granicach obiektu docelowego; -
nativeDragExit— gdy przeciągany element opuści obiekt docelowy (przekroczy jego granicę); -
nativeDragDrop— gdy użytkownik zwolni przeciągany element nad obiektem docelowym, a obiekt docelowy zaakceptuje upuszczenie, wywołując wcześniej metodęNativeDragManager.acceptDragDrop().
Zazwyczaj procedura obsługi zdarzenia nativeDragEnter lub nativeDragOver analizuje dane przeciąganego elementu oraz dozwolone operacje przeciągania, aby określić, czy obiekt interaktywny powinien zaakceptować upuszczenie. Aby wskazać obiekt interaktywny jako dozwolony obiekt docelowy, procedura obsługi zdarzeń musi wywołać funkcję NativeDragManager.acceptDrop(), przekazując odwołanie do obiektu. Jeśli użytkownik zwolni przycisk myszy nad wskazanym obiektem, obiekt stanie się celem operacji upuszczania i wywoła zdarzenie nativeDragDrop.
Inicjatorem przeciągania lub celem upuszczania może być dowolny obiekt typu InteractiveObject.
Powiązane elementy interfejsu API
flash.desktop.NativeDragManager
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject
Właściwości publiczne
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| allowedActions : NativeDragOptions
Obiekt NativeDragOptions określający operacje dozwolone przez obiekt ekranowy, który zainicjował tę operację przeciągania. | NativeDragEvent | ||
 | altKey : Boolean
Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). | MouseEvent | |
| bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
| buttonDown : Boolean
Określa, czy główny przycisk myszy jest naciśnięty (true), czy nie (false). | MouseEvent | |
| cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
| clickCount : int [tylko do odczytu]
Określa, czy dane naciśnięcie przycisku myszy należy do sekwencji wielu kliknięć. | MouseEvent | |
| clipboard : Clipboard
Obiekt Clipboard zawierający dane w tej operacji przeciągania. | NativeDragEvent | ||
| commandKey : Boolean
Określa, czy klawisz Command jest aktywny (tylko w systemach Mac). W systemach Mac właściwość commandKey będzie miała tę samą wartość, co właściwość ctrlKey. | MouseEvent | |
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| controlKey : Boolean
Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux. | MouseEvent | |
| ctrlKey : Boolean
W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). | MouseEvent | |
| currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
| delta : int
Określa liczbę wierszy przewijanych w odpowiedzi na elementarny ruch pokrętłem myszy. | MouseEvent | |
| dropAction : String
Bieżąca operacja. | NativeDragEvent | ||
| eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
| isRelatedObjectInaccessible : Boolean
Jeśli wartość to true, właściwość relatedObject zostanie ustawiona na wartość null z przyczyn związanych z bezpiecznymi obszarami izolowanymi. | MouseEvent | |
| localX : Number
Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), gdy jest wyłączone blokowanie myszy. | MouseEvent | |
| localY : Number
Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), gdy jest wyłączone blokowanie myszy. | MouseEvent | |
| movementX : Number
Zmiana pozycji myszy w kierunku X od ostatniego zdarzenia myszy, gdy jest włączone blokowanie myszy. | MouseEvent | |
| movementY : Number
Zmiana pozycji myszy w kierunku Y od ostatniego zdarzenia myszy, gdy jest włączone blokowanie myszy. | MouseEvent | |
| relatedObject : InteractiveObject
Odwołanie do listy powiązanej ze zdarzeniem. | MouseEvent | |
| shiftKey : Boolean
Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false). | MouseEvent | |
| stageX : Number [tylko do odczytu]
Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | MouseEvent | |
| stageY : Number [tylko do odczytu]
Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | MouseEvent | |
| target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
| type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
Metody publiczne
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
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)
Tworzy obiekt Event zawierający określone informacje o zdarzeniach dotyczących natywnych operacji przeciągania i upuszczania. | NativeDragEvent | ||
[przesłanianie]
Tworzy kopię tego obiektu NativeDragEvent. | NativeDragEvent | ||
|
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Formatuje właściwości tego obiektu NativeDragEvent do postaci ciągu znaków. | NativeDragEvent | ||
|
Powoduje, że po zakończeniu przetwarzania tego zdarzenia program Flash Player lub środowisko wykonawcze Adobe AIR zrenderuje obraz, jeśli lista wyświetlania została zmodyfikowana. | MouseEvent | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
Stałe publiczne
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_COMPLETE definiuje wartość właściwości type obiektu zdarzenia nativeDragComplete. | NativeDragEvent | ||
| NATIVE_DRAG_DROP : String = "nativeDragDrop" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_DROP definiuje wartość właściwości type obiektu zdarzenia nativeDragDrop. | NativeDragEvent | ||
| NATIVE_DRAG_ENTER : String = "nativeDragEnter" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_ENTER definiuje wartość właściwości type obiektu zdarzenia nativeDragEnter. | NativeDragEvent | ||
| NATIVE_DRAG_EXIT : String = "nativeDragExit" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_EXIT definiuje wartość właściwości type obiektu zdarzenia nativeDragExit. | NativeDragEvent | ||
| NATIVE_DRAG_OVER : String = "nativeDragOver" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_OVER definiuje wartość właściwości type obiektu zdarzenia nativeDragOver. | NativeDragEvent | ||
| NATIVE_DRAG_START : String = "nativeDragStart" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_START definiuje wartość właściwości type obiektu zdarzenia nativeDragStart. | NativeDragEvent | ||
| NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [statyczny]
Stała NativeDragEvent.NATIVE_DRAG_UPDATE definiuje wartość właściwości type obiektu zdarzenia nativeDragUpdate. | NativeDragEvent | ||
Szczegół właściwości
allowedActions | właściwość |
public var allowedActions:NativeDragOptions| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt NativeDragOptions określający operacje dozwolone przez obiekt wyświetlany, który zainicjował tę operację przeciągania.
Powiązane elementy interfejsu API
clipboard | właściwość |
public var clipboard:Clipboard| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt Clipboard zawierający dane w tej operacji przeciągania.
Jeśli obiekt wywołujący zdarzenie nie znajduje się w tej samej domenie zabezpieczeń, co obiekt inicjujący, zawartość schowka można odczytywać jedynie wewnątrz procedury obsługi zdarzenia nativeDragDrop.
Powiązane elementy interfejsu API
dropAction | właściwość |
public var dropAction:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Bieżąca operacja. W zdarzeniu nativeDragComplete właściwość dropAction informuje o końcowej operacji.
Konstruktor Szczegół
NativeDragEvent | () | Konstruktor |
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)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy obiekt Event zawierający określone informacje o zdarzeniach dotyczących macierzystych operacji przeciągania i upuszczania.
Obiekty Event są przekazywane jako parametry do detektorów zdarzeń. Wywołanie zdarzenia nativeDrag nie wywołuje skojarzonego zachowania.
Parametrytype:String — Typ zdarzenia. Możliwe wartości to: NativeDragEvent.NATIVE_DRAG_START, NativeDragEvent.NATIVE_DRAG_UPDATE, NativeDragEvent.NATIVE_DRAG_ENTER, NativeDragEvent.NATIVE_DRAG_OVER, NativeDragEvent.NATIVE_DRAG_EXIT, NativeDragEvent.NATIVE_DRAG_DROP i NativeDragEvent.NATIVE_DRAG_COMPLETE.
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = true) | |
localX:Number (default = NaN) | |
localY:Number (default = NaN) | |
relatedObject:InteractiveObject (default = null) | |
clipboard:Clipboard (default = null) | |
allowedActions:NativeDragOptions (default = null) | |
dropAction:String (default = null) | |
controlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) |
Szczegół metody
clone | () | metoda |
toString | () | metoda |
override public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Formatuje właściwości tego obiektu NativeDragEvent do postaci ciągu znaków.
Format ciągu znaków jest następujący:
[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]
String — Właściwości tego obiektu NativeDragEvent w postaci ciągu znaków.
|
Szczegół stałej
NATIVE_DRAG_COMPLETE | Stała |
public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_COMPLETE definiuje wartość właściwości type obiektu zdarzenia nativeDragComplete.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_DROP | Stała |
public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_DROP definiuje wartość właściwości type obiektu zdarzenia nativeDragDrop.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać nawet wtedy, gdy obiekt wywołujący to zdarzenie jest w innej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_ENTER | Stała |
public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_ENTER definiuje wartość właściwości type obiektu zdarzenia nativeDragEnter.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_EXIT | Stała |
public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_EXIT definiuje wartość właściwości type obiektu zdarzenia nativeDragExit.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_OVER | Stała |
public static const NATIVE_DRAG_OVER:String = "nativeDragOver"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_OVER definiuje wartość właściwości type obiektu zdarzenia nativeDragOver.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_START | Stała |
public static const NATIVE_DRAG_START:String = "nativeDragStart"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_START definiuje wartość właściwości type obiektu zdarzenia nativeDragStart.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
NATIVE_DRAG_UPDATE | Stała |
public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała NativeDragEvent.NATIVE_DRAG_UPDATE definiuje wartość właściwości type obiektu zdarzenia nativeDragUpdate.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z