| Paket | flash.events |
| Klasse | public class NativeDragEvent |
| Vererbung | NativeDragEvent  MouseEvent Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das initiierende Objekt löst folgende Ereignisse aus:
-
nativeDragStart: Zu Beginn des Ziehvorgangs. -
nativeDragUpdate: Während des Ziehvorgangs. -
nativeDragComplete: Wenn der Benutzer das gezogene Element loslässt (egal, ob das Ablegen akzeptiert wurde oder nicht).
Das initiierende Objekt ist das interaktive Objekt, das im Aufruf von NativeDragManager.doDrag(), mit dem der Ziehvorgang beginnt, an das NativeDragManager-Objekt übergeben wird.
Potenzielle interaktive Zielobjekte lösen folgende Ereignisse aus:
-
nativeDragEnter: Wenn sich die Ziehbewegung über die Objektgrenzen auf das Objekt bewegt. -
nativeDragOver: Wenn die Ziehbewegung innerhalb der Objektgrenzen verbleibt. -
nativeDragExit: Wenn die Ziehbewegung die Objektgrenzen verlässt. -
nativeDragDrop: Wenn der Benutzer das gezogene Element über dem Objekt loslässt und das Objekt das Ablegen durch einen früheren Aufruf vonNativeDragManager.acceptDragDrop()akzeptiert hat.
Normalerweise evaluiert die Prozedur für das nativeDragEnter- oder nativeDragOver-Ereignis die gezogenen Daten zusammen mit den zulässigen Ziehaktionen, um festzustellen, ob ein interaktives Objekt das Ablegen akzeptieren kann. Um festzulegen, dass ein interaktives Objekt ein gültiges Ziel ist, muss die Ereignisprozedur die NativeDragManager.acceptDrop()-Funktion aufrufen, die einen Verweis an das Objekt übergibt. Wenn der Benutzer die Maustaste über dem vorgesehenen Objekt loslässt, wird dieses zum Ablageziel und löst das nativeDragDrop-Ereignis aus.
Jedes Objekt vom Typ InteractiveObject kann ein Ziehinitiator oder ein Ablageziel sein.
Verwandte API-Elemente
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
Öffentliche Eigenschaften
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| allowedActions : NativeDragOptions
Das NativeDragOptions-Objekt, das die Aktionen festlegt, die vom Anzeigeobjekt, das diesen Ziehvorgang eingeleitet hat, zugelassen sind. | NativeDragEvent | ||
 | altKey : Boolean
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. | MouseEvent | |
| bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | |
| buttonDown : Boolean
Gibt an, ob die primäre Maustaste gedrückt (true) ist oder nicht (false). | MouseEvent | |
| cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | |
| clickCount : int [schreibgeschützt]
Gibt an, ob das Mouse-Down-Ereignis Teil einer Sequenz mit mehreren Klicks ist oder nicht. | MouseEvent | |
| clipboard : Clipboard
Das Clipboard-Objekt, das in diesem Ziehvorgang die Daten enthält. | NativeDragEvent | ||
| commandKey : Boolean
Gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Der Wert der commandKey-Eigenschaft hat denselben Wert wie die ctrlKey-Eigenschaft auf dem Mac. | MouseEvent | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| controlKey : Boolean
Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. | MouseEvent | |
| ctrlKey : Boolean
Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. | MouseEvent | |
| currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | |
| delta : int
Gibt an, wie viele Zeilen pro Raststellung des Mausrads durchlaufen werden sollen. | MouseEvent | |
| dropAction : String
Die aktuelle Aktion. | NativeDragEvent | ||
| eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | |
| isRelatedObjectInaccessible : Boolean
Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. | MouseEvent | |
| localX : Number
Wenn die Maussperre deaktiviert ist, die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Relation zum Sprite, in dem es enthalten ist. | MouseEvent | |
| localY : Number
Wenn die Maussperre deaktiviert ist, die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Relation zum Sprite, in dem es enthalten ist. | MouseEvent | |
| movementX : Number
Wenn die Maussperre aktiviert ist, die Änderung an der Mausposition in x-Richtung seit dem letzten Mausereignis. | MouseEvent | |
| movementY : Number
Wenn die Maussperre aktiviert ist, die Änderung an der Mausposition in y-Richtung seit dem letzten Mausereignis. | MouseEvent | |
| relatedObject : InteractiveObject
Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. | MouseEvent | |
| shiftKey : Boolean
Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. | MouseEvent | |
| stageX : Number [schreibgeschützt]
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | MouseEvent | |
| stageY : Number [schreibgeschützt]
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | MouseEvent | |
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| type : String [schreibgeschützt]
Der Ereignistyp. | Event | |
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
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)
Erstellt ein Event-Objekt mit spezifischen Informationen, die für native Ziehen-und-Ablegen-Ereignisse relevant sind. | NativeDragEvent | ||
[override]
Erstellt eine Kopie dieses NativeDragEvent-Objekts. | NativeDragEvent | ||
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
[override]
Formatiert die Eigenschaften dieses NativeDragEvent-Objekts als ein String. | NativeDragEvent | ||
|
Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. | MouseEvent | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Öffentliche Konstanten
| Konstante | Definiert von | ||
|---|---|---|---|
| NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [statisch]
NativeDragEvent.NATIVE_DRAG_COMPLETE definiert den Wert der type-Eigenschaft eines nativeDragComplete-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_DROP : String = "nativeDragDrop" [statisch]
NativeDragEvent.NATIVE_DRAG_DROP definiert den Wert der type-Eigenschaft eines nativeDragDrop-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_ENTER : String = "nativeDragEnter" [statisch]
NativeDragEvent.NATIVE_DRAG_ENTER definiert den Wert der type-Eigenschaft eines nativeDragEnter-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_EXIT : String = "nativeDragExit" [statisch]
NativeDragEvent.NATIVE_DRAG_EXIT definiert den Wert der type-Eigenschaft eines nativeDragExit-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_OVER : String = "nativeDragOver" [statisch]
NativeDragEvent.NATIVE_DRAG_OVER definiert den Wert der type-Eigenschaft eines nativeDragOver-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_START : String = "nativeDragStart" [statisch]
NativeDragEvent.NATIVE_DRAG_START definiert den Wert der type-Eigenschaft eines nativeDragStart-Ereignisobjekts. | NativeDragEvent | ||
| NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [statisch]
NativeDragEvent.NATIVE_DRAG_UPDATE definiert den Wert der type-Eigenschaft eines nativeDragUpdate-Ereignisobjekts. | NativeDragEvent | ||
Eigenschaftendetails
allowedActions | Eigenschaft |
public var allowedActions:NativeDragOptions| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das NativeDragOptions-Objekt, das die Aktionen festlegt, die vom Anzeigeobjekt, das diesen Ziehvorgang eingeleitet hat, zugelassen sind.
Verwandte API-Elemente
clipboard | Eigenschaft |
public var clipboard:Clipboard| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Clipboard-Objekt, das in diesem Ziehvorgang die Daten enthält.
Wenn sich das Objekt, das das Ereignis auslöst, nicht in derselben Sicherheitsdomäne befindet wie das initiierende Objekt, kann die Zwischenablage nur in der Prozedur für ein nativeDragDrop-Ereignis gelesen werden.
Verwandte API-Elemente
dropAction | Eigenschaft |
public var dropAction:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die aktuelle Aktion. Im nativeDragComplete-Ereignis protokolliert die dropAction-Eigenschaft die endgültige Aktion.
Konstruktordetails
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)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt ein Event-Objekt mit spezifischen Informationen, die für native Ziehen-und-Ablegen-Ereignisse relevant sind.
Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. Das Auslösen eines Ziehereignisses löst nicht das zugehörige Verhalten aus.
Parametertype:String — Der Ereignistyp. Mögliche Werte sind: NativeDragEvent.NATIVE_DRAG_START, NativeDragEvent.NATIVE_DRAG_UPDATE, NativeDragEvent.NATIVE_DRAG_ENTER, NativeDragEvent.NATIVE_DRAG_OVER, NativeDragEvent.NATIVE_DRAG_EXIT, NativeDragEvent.NATIVE_DRAG_DROP und 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) |
Methodendetails
clone | () | Methode |
toString | () | Methode |
override public function toString():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Formatiert die Eigenschaften dieses NativeDragEvent-Objekts als ein String.
Der String liegt im folgenden Format vor:
[NativeDragEvent type=Wert bubbles=Wert cancelable=Wert ... commandKey=Wert]
String — Die Eigenschaften dieses NativeDragEvent-Objekts als ein String.
|
Konstantendetails
NATIVE_DRAG_COMPLETE | Konstante |
public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_COMPLETE definiert den Wert der type-Eigenschaft eines nativeDragComplete-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_DROP | Konstante |
public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_DROP definiert den Wert der type-Eigenschaft eines nativeDragDrop-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | true; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann auch gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich nicht in derselben Sicherheitsdomäne wie der Initiator befindet. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_ENTER | Konstante |
public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_ENTER definiert den Wert der type-Eigenschaft eines nativeDragEnter-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_EXIT | Konstante |
public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_EXIT definiert den Wert der type-Eigenschaft eines nativeDragExit-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_OVER | Konstante |
public static const NATIVE_DRAG_OVER:String = "nativeDragOver"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_OVER definiert den Wert der type-Eigenschaft eines nativeDragOver-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | true; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. Die Zwischenablage kann nur gelesen werden, wenn das Objekt, das dieses Ereignis auslöst, sich in derselben Sicherheitsdomäne wie der Initiator befindet. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_START | Konstante |
public static const NATIVE_DRAG_START:String = "nativeDragStart"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_START definiert den Wert der type-Eigenschaft eines nativeDragStart-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | true; das Abbrechen dieses Ereignisses bricht den Ziehvorgang ab. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
NATIVE_DRAG_UPDATE | Konstante |
public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_UPDATE definiert den Wert der type-Eigenschaft eines nativeDragUpdate-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
allowedActions | Das NativeDragOptions-Objekt, das die für diesen Ziehvorgang relevanten Aktionen angibt. |
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
clipboard | Das Clipboard-Objekt, das die gezogenen Daten enthält. |
dropAction | Die vom Ablageziel gewählte Aktion (oder none, wenn keine Aktion festgelegt wurde). |
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z