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 |
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
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éthode | Défini par | ||
---|---|---|---|
[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 | ||
[statique]
Renvoie le résultat de l’opération Glisser-déposer en cours. | DragManager | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
[statique]
Définit l’indicateur de résultat pour l’opération Glisser-déposer. | DragManager | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
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.
Style | 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 |
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 |
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
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éeString — 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.
|
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 ».
Tue Jun 12 2018, 09:30 AM Z