ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.core 

DragSource  - AS3 Flex

Paketmx.core
Klassepublic class DragSource
VererbungDragSource Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die DragSource-Klasse enthält die gezogenen Daten. Die Daten können abhängig vom Typ des Steuerelements, das den Ziehvorgang initiierte, in vielen verschiedenen Formaten vorliegen.

Jedes Datenformat wird mit einem String identifiziert. Mit der hasFormat()-Methode wird bestimmt, ob das Objekt Daten im entsprechenden Format hat. Mit der dataForFormat()-Methode werden die Daten im angegebenen Format abgerufen.

Daten können mit der addData()-Methode direkt, oder mit der addHandler()-Methode indirekt hinzugefügt werden. Die addHandler()-Methode registriert einen Rückruf, der bei Anforderung der Daten augerufen wird. Dies ist zum Hinzufügen von Daten in einem nicht nativen Format nützlich, die möglicherweise einen größeren Berechnungs- oder Konvertierungsaufwand benötigen. Beispiel: Wenn Sie rohe Sounddaten haben, können Sie eine MP3-Formatprozedur hinzufügen. Die MP3-Konvertierung wird nur dann durchgeführt, wenn die MP3-Daten angefordert werden.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  formats : Array
[schreibgeschützt] Enthält die Formate der Ziehdaten als Array von Strings.
DragSource
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
DragSource
  
addData(data:Object, format:String):void
Fügt der Ziehquelle Daten und einen entsprechenden Formatstring hinzu.
DragSource
  
addHandler(handler:Function, format:String):void
Fügt eine Prozedur hinzu, die bei Anforderung von Daten im angegebenen Format aufgerufen wird.
DragSource
  
Ruft die Daten für das angegebene Format ab.
DragSource
  
Gibt „true“ zurück, wenn die Datenquelle das angefordertert Format enthält. Andernfalls wird „false“ zurückgegeben.
DragSource
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

formats

Eigenschaft
formats:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Enthält die Formate der Ziehdaten als Array von Strings. Stellt diese Eigenschaft mit der addData()- oder der addHandler()-Methode ein. Der Standardwert hängt von den dem DragSource-Objekt hinzugefügten Daten ab.



Implementierung
    public function get formats():Array
Konstruktordetails

DragSource

()Konstruktor
public function DragSource()

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

addData

()Methode
public function addData(data:Object, format:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fügt der Ziehquelle Daten und einen entsprechenden Formatstring hinzu. Diese Methode gibt keinen Wert zurück.

Parameter

data:Object — Objekt, das die Ziehdaten angibt. Dies kann jedes beliebige Objekt sein, z. B. ein String oder ein DataProvider.
 
format:String — String, der eine das Format dieser Daten beschreibende Beschriftung angibt.

addHandler

()Methode 
public function addHandler(handler:Function, format:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fügt eine Prozedur hinzu, die bei Anforderung von Daten im angegebenen Format aufgerufen wird. Dies ist beim Ziehen großer Datenmengen nützlich. Die Prozedur wird nur dann aufgerufen, wenn die Daten angefordert werden. Diese Methode gibt keinen Wert zurück.

Parameter

handler:Function — Funktion, die die zur Anforderung der Daten aufgerufene Prozedur angibt. Diese Funktion muss die Daten im angegebenen Format zurückgeben.
 
format:String — String, der das Format für diese Daten angibt.

dataForFormat

()Methode 
public function dataForFormat(format:String):Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ruft die Daten für das angegebene Format ab. Wurden die Daten mit der addData()-Methode hinzugefügt, werden sie direkt zurückgegeben. Wurden die Daten mit der addHandler()-Methode hinzugefügt, wird für die Rückgabe der Daten die Prozedurfunktion aufgerufen.

Parameter

format:String — String, der eine das Format der zurückzugebenden Daten beschreibende Beschriftung angibt. Dieser String kann ein benutzerdefinierter Wert sein, wenn Sie mit der addData()-Methode ein benutzerdefiniertes Ablageziel erstellen.

Listenbasierte Steuerelemente haben vordefinierte Werte für den format-Parameter. Wenn das Steuerelement, das den Ziehvorgang initiiert hat, ein Tree-Steuerelement ist, ist das Format „treeItems“ und die Elemente implementieren die ITreeDataProvider-Schnittstelle. Bei allen anderen listenbasierten Steuerelementen mit integrierter Drag & Drop-Unterstützung ist das Format „items“ und die Elemente implementieren die IDataProvider-Schnittstelle.

Rückgabewerte
Object — Ein Objekt, das die Daten im angeforderten Format enthält. Wenn Sie mehrere Elemente ziehen, ist der zurückgegebene Wert ein Array. Bei listenbasierten Steuerelementen ist der Rückgabewert immer ein Array, auch wenn es nur ein einziges Element enthält.

hasFormat

()Methode 
public function hasFormat(format:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt true zurück, wenn die Datenquelle das angefordertert Format enthält. Andernfalls wird false zurückgegeben.

Parameter

format:String — String, der eine das Format der Daten beschreibende Beschriftung angibt.

Rückgabewerte
Booleantrue, wen die Datenquelle das angeforderte Format enthält.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.