DragManager - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.managers
Klasse	public class DragManager
Vererbung	DragManager Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die DragManager-Klasse verwaltet Daten-Drag & Drop-Vorgänge in Flex-Anwendungen. Beispielsweise können Sie ein Objekt wie ein Element in einem List-Steuerelement oder einem Flex-Steuerelement (z. B. Image-Steuerelement) auswählen und über eine Komponente ziehen, um sie dieser Komponente hinzuzufügen.

Alle Methoden und Eigenschaften des DragManagers sind statisch, sodass Sie keine Instanz davon erstellen müssen.

Alle Flex-Komponenten unterstützen Drag & Drop-Vorgänge. Flex bietet zusätzliche Unterstützung für Drag & Drop in List-, Tree- und DataGrid-Steuerelementen.

Wenn der Benutzer ein Element mit der Maus auswählt, wird die ausgewählte Komponente als Ziehinitiator bezeichnet. Das während des Ziehvorgangs angezeigte Bild wird als Ziehproxy bezeichnet.

Wenn der Benutzer den Ziehproxy über eine andere Komponente zieht, wird das dragEnter-Ereignis an diese Komponente gesendet. Wenn die Komponente den Ziehvorgang akzeptiert, wird sie das Ziehziel und erhält die dragOver-, dragExit- und dragDrop-Ereignisse.

Nach Abschluss des Ziehvorgangs wird das dragComplete-Ereignis an den Ziehinitiator gesendet.

Verwandte API-Elemente

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

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		isDragging : Boolean [statisch] [schreibgeschützt] Schreibgeschützte Eigenschaft, die „true“ zurückgibt, wenn ein Ziehvorgang ausgeführt wird.	DragManager

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		acceptDragDrop(target:IUIComponent):void [statisch] Rufen Sie diese Methode in Ihrer dragEnter-Ereignisprozedur auf, um die gezogenen Daten zu akzeptieren.	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 [statisch] Initiiert einen Drag & Drop-Vorgang.	DragManager
		getFeedback():String [statisch] Gibt die aktuelle Drag & Drop-Rückmeldung zurück.	DragManager
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		showFeedback(feedback:String):void [statisch] Legt den Rückmeldungsindikator für den Drag & Drop-Vorgang fest.	DragManager
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Stile

Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.

Allgemeine Stile

Klicken Sie, um weitere Informationen zu Stilen zu erhalten.

	Beschreibung	Definiert von
copyCursor	Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Beim Kopieren angezeigter Cursor. Der Standardwert ist das Symbol „mx.skins.cursor.DragCopy“ in der Datei „Assets.swf“.	DragManager
defaultDragImageSkin	Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Die zum Zeichnen der Standardabbildung beim Ziehen verwendete Skin; wird auch als Ziehproxy bezeichnet. Der Standardwert ist `mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)`.	DragManager
linkCursor	Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Bei einer Verknüpfung angezeigter Cursor. Der Standardwert ist das Symbol „mx.skins.cursor.DragLink“ in der Datei „Assets.swf“.	DragManager
moveCursor	Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Beim Verschieben angezeigter Cursor. Der Standardwert ist das Symbol „mx.skins.cursor.DragMove“ in der Datei „Assets.swf“.	DragManager
rejectCursor	Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Für eine Ablehnung angezeigter Cursor. Der Standardwert ist das Symbol „mx.skins.cursor.DragReject“ in der Datei „Assets.swf“.	DragManager

Öffentliche Konstanten

	Konstante		Definiert von
		COPY : String = "copy" [statisch] Konstante, die als Typ des Ziehvorgangs „copy“ angibt.	DragManager
		LINK : String = "link" [statisch] Konstante, die als Typ des Ziehvorgangs „link“ angibt.	DragManager
		MOVE : String = "move" [statisch] Konstante, die als Typ des Ziehvorgangs „move“ angibt.	DragManager
		NONE : String = "none" [statisch] Konstante, die als Typ des Ziehvorgangs „none“ angibt.	DragManager

Eigenschaftendetails

isDragging

Eigenschaft

isDragging:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Schreibgeschützte Eigenschaft, die true zurückgibt, wenn ein Ziehvorgang ausgeführt wird.

Implementierung
public static function get isDragging():Boolean

Methodendetails

acceptDragDrop

()

Methode

public static function acceptDragDrop(target:IUIComponent):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Rufen Sie diese Methode in Ihrer dragEnter-Ereignisprozedur auf, um die gezogenen Daten zu akzeptieren. In der Regel wandeln Sie event.target in den Datentyp des Ablageziels um. Im folgenden Beispiel ist das Ablageziel ein MX Canvas-Container.

DragManager.acceptDragDrop(Canvas(event.target));

Parameter

target:IUIComponent — Das Ablageziel, das den Ziehvorgang akzeptiert.

doDrag

()

Methode

 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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Initiiert einen Drag & Drop-Vorgang.

Parameter

	`dragInitiator:IUIComponent` — IUIComponent zur Angabe der Komponente, von der der Ziehvorgang eingeleitet wird.

	`dragSource:DragSource` — DragSource-Objekt, das die gezogenen Daten enthält.

	`mouseEvent:MouseEvent` — MouseEvent, der die Mausinformationen für den Start des Ziehvorgangs enthält.

	`dragImage:IFlexDisplayObject` (default = `null`) — Das zu ziehende Bild. Dieses Argument ist optional. Wird dies ausgelassen, dann wird ein standardmäßiges Rechteck während des Drag & Drop-Vorgangs verwendet. Wenn Sie ein Bild angeben, müssen Sie dessen Höhe und Breite explizit festlegen, andernfalls wird das Bild nicht angezeigt.

	`xOffset:Number` (default = `0`) — Zahl, die den x-Offset in Pixeln für `dragImage` angibt. Dieses Argument ist optional. Wird dies ausgelassen, dann wird der Ziehproxy in der linken oberen Ecke des Ziehinitiators angezeigt. Der Offset wird von der linken Kante des Ziehproxys zur linken Kante des Ziehinitiators in Pixeln gemessen. Normalerweise ist die Zahl negativ.

	`yOffset:Number` (default = `0`) — Zahl, die den y-Offset in Pixeln für `dragImage` angibt. Dieses Argument ist optional. Wird dies ausgelassen, dann wird der Ziehproxy in der linken oberen Ecke des Ziehinitiators angezeigt. Der Offset wird von der oberen Kante des Ziehproxys zur oberen Kante des Ziehinitiators in Pixeln gemessen. Normalerweise ist die Zahl negativ.

	`imageAlpha:Number` (default = `0.5`) — Zahl, die den Alpha-Wert des Ziehbilds angibt. Dieses Argument ist optional. Wird sie ausgelassen, beträgt der Alpha-Wert 0,5. Mit dem Wert 0,0 ist das Bild transparent, mit dem Wert 1,0 ist es völlig undurchsichtig.

	`allowMove:Boolean` (default = `true`) — Gibt an, ob ein Ablageziel die gezogenen Daten verschieben kann.

getFeedback

()

Methode

public static function getFeedback():String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt die aktuelle Drag & Drop-Rückmeldung zurück.

Rückgabewerte

String — Mögliche Werte sind DragManager.COPY, DragManager.MOVE, DragManager.LINK oder DragManager.NONE.

showFeedback

()

Methode

public static function showFeedback(feedback:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt den Rückmeldungsindikator für den Drag & Drop-Vorgang fest. Mögliche Werte sind DragManager.COPY, DragManager.MOVE, DragManager.LINK oder DragManager.NONE.

Parameter

feedback:String — Der Typ des anzuzeigenden Rückmeldungsindikators.

Konstantendetails

COPY

Konstante

public static const COPY:String = "copy"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstante, die als Typ des Ziehvorgangs „copy“ angibt.

LINK

Konstante

public static const LINK:String = "link"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstante, die als Typ des Ziehvorgangs „link“ angibt.

MOVE

Konstante

public static const MOVE:String = "move"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstante, die als Typ des Ziehvorgangs „move“ angibt.

NONE

Konstante

public static const NONE:String = "none"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstante, die als Typ des Ziehvorgangs „none“ angibt.

Rechtliche Hinweise | Onlinedatenschutzerklärung

DragManager - AS3 Flex

Klassen x

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE