DragManager - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.managers
Classe	public class DragManager
Héritage	DragManager Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

La classe DragManager gère les opérations Glisser-déposer, qui vous permettent de déplacer les données d’un endroit à un autre dans une application Flex. Par exemple, vous pouvez sélectionner un objet, comme un élément dans un contrôle List ou un contrôle Flex, comme un contrôle Image, puis le faire glisser par dessus un autre composant pour l’ajouter à ce composant.

Toutes les méthodes et propriétés de la classe DragManager sont statiques. Vous n’avez donc pas besoin de leur créer une instance.

Tous les composants Flex prennent en charge les opérations Glisser-déposer. Flex fournit un support supplémentaire pour faire glisser et déposer les contrôles List, Tree et DataGrid.

Lorsque l’utilisateur sélectionne un élément avec la souris, le composant sélectionné est appelé l’intiateur de glissement. L’image affichée lors de l’opération de glissement est appelée proxy de glissement.

Lorsque l’utilisateur déplace le proxy de glissement sur un autre composant, l’événement dragEnter est envoyé à ce composant. Si le composant accepte le glissement, il devient la cible de dépôt et reçoit les événements dragOver, dragExit et dragDrop.

Une fois le glissement terminé, un événement dragComplete est envoyé à l’initiateur du glissement.

Eléments de l’API associés

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

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		isDragging : Boolean [statique] [lecture seule] Propriété en lecture seule qui renvoie la valeur true si un glissement est en cours.	DragManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		acceptDragDrop(target:IUIComponent):void [statique] Appelez cette méthode depuis votre gestionnaire d’événements dragEnter si vous acceptez les données glissées et déposées.	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 [statique] Initie une opération Glisser-déposer.	DragManager
		getFeedback():String [statique] Renvoie le résultat de l’opération Glisser-déposer en cours.	DragManager
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		showFeedback(feedback:String):void [statique] Définit l’indicateur de résultat pour l’opération Glisser-déposer.	DragManager
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Styles

Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.

Styles communs

Cliquez pour plus d’informations sur les styles

	Description	Défini par
copyCursor	Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Curseur affiché lors d’une opération de copie. La valeur par défaut est le symbole « mx.skins.cursor.DragCopy » dans le fichier Assets.swf.	DragManager
defaultDragImageSkin	Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Habillage utilisé pour tracer l’image de glissement par défaut, qui est également appelée proxy de glissement. La valeur par défaut est `mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)`.	DragManager
linkCursor	Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Curseur affiché lors d’une opération de liaison. La valeur par défaut est le symbole « mx.skins.cursor.DragLink » dans le fichier Assets.swf.	DragManager
moveCursor	Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Curseur affiché lors d’une opération de déplacement. La valeur par défaut est le symbole « mx.skins.cursor.DragMove » dans le fichier Assets.swf.	DragManager
rejectCursor	Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Curseur affiché pour une opération de rejet. La valeur par défaut est le symbole « mx.skins.cursor.DragReject » dans le fichier Assets.swf.	DragManager

Constantes publiques

	Constante		Défini par
		COPY : String = "copy" [statique] Constante indiquant que le type de l’action de glissement est « copy ».	DragManager
		LINK : String = "link" [statique] Constante indiquant que le type de l’action de glissement est « link ».	DragManager
		MOVE : String = "move" [statique] Constante indiquant que le type de l’action de glissement est « move ».	DragManager
		NONE : String = "none" [statique] Constante indiquant que le type de l’action de glissement est « none ».	DragManager

Détails de la propriété

isDragging

propriété

isDragging:Boolean [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Propriété en lecture seule qui renvoie la valeur true si un glissement est en cours.

Implémentation
public static function get isDragging():Boolean

Détails de la méthode

acceptDragDrop

()

méthode

public static function acceptDragDrop(target:IUIComponent):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Appelez cette méthode depuis votre gestionnaire d’événements dragEnter si vous acceptez les données glissées et déposées. Généralement, vous distribuez event.target au type de données de la cible de dépose. Dans l’exemple suivant, la cible de dépose est un conteneur de la zone de travail :

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

Paramètres

target:IUIComponent — Cible de dépôt acceptant le glissement.

doDrag

()

méthode

 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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Initie une opération Glisser-déposer.

Paramètres

	`dragInitiator:IUIComponent` — Interface IUIComponent spécifiant le composant qui initie l’opération de glissement.

	`dragSource:DragSource` — Objet DragSource contenant les données en cours de glissement.

	`mouseEvent:MouseEvent` — Objet MouseEvent contenant les informations de souris pour le début du glissement.

	`dragImage:IFlexDisplayObject` (default = `null`) — Image à faire glisser. Cet argument est facultatif. S’il est omis, un rectangle de glissement standard est utilisé lors de l’opération Glisser-déposer. Si vous spécifiez une image, vous devez définir explicitement sa hauteur et sa largeur. Sinon, elle n’apparaît pas.

	`xOffset:Number` (default = `0`) — Nombre spécifiant le décalage x, en pixels, de l’objet `dragImage`. Cet argument est facultatif. S’il est omis, le proxy de glissement est affiché dans le coin supérieur gauche de l’initiateur du glissement. Le décalage est exprimé en pixels à partir du bord gauche du proxy de glissement vers le bord gauche de l’initiateur du glissement. Il s’agit généralement d’un nombre négatif.

	`yOffset:Number` (default = `0`) — Nombre spécifiant le décalage y, en pixels, de l’objet `dragImage`. Cet argument est facultatif. S’il est omis, le proxy de glissement est affiché dans le coin supérieur gauche de l’initiateur du glissement. Le décalage est exprimé en pixels à partir du bord supérieur du proxy de glissement vers le bord supérieur de l’initiateur du glissement. Il s’agit généralement d’un nombre négatif.

	`imageAlpha:Number` (default = `0.5`) — Nombre spécifiant la valeur Alpha utilisée pour l’image de glissement. Cet argument est facultatif. S’il est omis, la valeur Alpha par défaut est de 0.5. La valeur 0.0 indique que l’image est transparente et la valeur 1.0 indique qu’elle est entièrement opaque.

	`allowMove:Boolean` (default = `true`) — Indique si une cible de dépôt peut déplacer les données glissées.

getFeedback

()

méthode

public static function getFeedback():String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie le résultat de l’opération Glisser-déposer en cours.

Valeur renvoyée

String — Les valeurs renvoyées possibles sont DragManager.COPY, DragManager.MOVE, DragManager.LINK ou DragManager.NONE.

showFeedback

()

méthode

public static function showFeedback(feedback:String):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Définit l’indicateur de résultat pour l’opération Glisser-déposer. Les valeurs possibles sont DragManager.COPY, DragManager.MOVE, DragManager.LINK ou DragManager.NONE.

Paramètres

feedback:String — Type d’indicateur de résultat à afficher.

Détails de la constante

COPY

Constante

public static const COPY:String = "copy"

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constante indiquant que le type de l’action de glissement est « copy ».

LINK

Constante

public static const LINK:String = "link"

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constante indiquant que le type de l’action de glissement est « link ».

MOVE

Constante

public static const MOVE:String = "move"

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constante indiquant que le type de l’action de glissement est « move ».

NONE

Constante

public static const NONE:String = "none"

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constante indiquant que le type de l’action de glissement est « none ».

Informations juridiques | Politique de confidentialité en ligne

DragManager - AS3 Flex

Classes x

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE