Package | flash.events |
Classe | public class NativeDragEvent |
Héritage | NativeDragEvent MouseEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
L’objet déclencheur distribue :
-
nativeDragStart
— Lorsque l’opération de glissement commence. -
nativeDragUpdate
— Lorsque l’opération de glissement est en cours. -
nativeDragComplete
— Lorsque l’utilisateur relâche l’élément glissé (que l’opération déposer ait été acceptée ou non).
L’objet déclencheur est l’objet interactif transmis à l’objet NativeDragManager dans l’appel à NativeDragManager.doDrag()
qui a commencé l’opération de glissement.
Les objets interactifs de cible potentielle distribuent :
-
nativeDragEnter
— Lorsque l’opération glisser passe dans la limite de l’objet. -
nativeDragOver
— Lorsque l’opération glisser reste dans la limite de l’objet. -
nativeDragExit
— Lorsque l’opération glisser quitte la limite de l’objet. -
nativeDragDrop
— Lorsque l’utilisateur relâche l’élément glissé sur l’objet et que ce dernier a accepté l’opération déposer par un précédent appel àNativeDragManager.acceptDragDrop()
.
Généralement, le gestionnaire de l’événement nativeDragEnter
ou nativeDragOver
évalue les données glissées et les actions glisser autorisées pour déterminer si un objet interactif peut accepter l’opération de dépôt. Pour spécifier qu’un objet interactif est une cible éligible, le gestionnaire d’événement doit appeler la fonction NativeDragManager.acceptDrop()
, en transmettant une référence à l’objet. Si l’utilisateur relâche le bouton de sa souris sur l’objet désigné, ce dernier devient la cible de dépôt et déclenche l’événement nativeDragDrop
.
Tout objet de type InteractiveObject peut être un initiateur d’opération de glissement ou la cible d’une opération de dépôt.
Eléments de l’API associés
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject
Propriété | Défini par | ||
---|---|---|---|
allowedActions : NativeDragOptions
Objet NativeDragOptions spécifiant les actions autorisées par l’objet d’affichage ayant déclenché cette opération de déplacement. | NativeDragEvent | ||
altKey : Boolean
Indique si la touche Alt est active (true) ou non (false). | MouseEvent | ||
bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | ||
buttonDown : Boolean
Indique si l’utilisateur appuie (true) ou non (false) sur le bouton principal de la souris. | MouseEvent | ||
cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | ||
clickCount : int [lecture seule]
Indique si l’événement mouse down fait partie d’une séquence multi-clic. | MouseEvent | ||
clipboard : Clipboard
Objet Clipboard contenant les données dans cette opération de déplacement. | NativeDragEvent | ||
commandKey : Boolean
Indique si la touche Commande est activée (Mac uniquement). La valeur de la propriété commandKey a la même valeur que la propriété ctrlKey sur le Mac. | MouseEvent | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
controlKey : Boolean
Indique si la touche Contrôle et activée sous Mac et si la touche Ctrl est activée sous Windows ou Linux. | MouseEvent | ||
ctrlKey : Boolean
Sous Windows ou Linux, indique si la touche Ctrl est activée (true) ou non (false). | MouseEvent | ||
currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | ||
delta : int
Indique le nombre de lignes qui doivent défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran. | MouseEvent | ||
dropAction : String
Action en cours. | NativeDragEvent | ||
eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | ||
isRelatedObjectInaccessible : Boolean
Si la valeur est true, la propriété relatedObject est définie sur null pour des raisons liées aux sandbox de sécurité. | MouseEvent | ||
localX : Number
Lorsque le verrouillage de la souris est désactivé, coordonnée horizontale à laquelle l’événement s’est produit, par rapport au sprite conteneur. | MouseEvent | ||
localY : Number
Lorsque le verrouillage de la souris est désactivé, coordonnée verticale à laquelle l’événement s’est produit, par rapport au sprite conteneur. | MouseEvent | ||
movementX : Number
Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction X depuis le dernier événement de souris. | MouseEvent | ||
movementY : Number
Lorsque le verrouillage de la souris est activé, changement de position de la souris dans la direction Y depuis le dernier événement de souris. | MouseEvent | ||
relatedObject : InteractiveObject
Référence à un objet de la liste d’affichage qui est associé à l’événement. | MouseEvent | ||
shiftKey : Boolean
Indique si la touche Maj est activée (true) ou non (false). | MouseEvent | ||
stageX : Number [lecture seule]
Coordonnée horizontale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. | MouseEvent | ||
stageY : Number [lecture seule]
Coordonnée verticale à laquelle l’événement s’est produit, par rapport aux coordonnées globales de la scène. | MouseEvent | ||
target : Object [lecture seule]
Cible de l’événement. | Event | ||
type : String [lecture seule]
Type d’événement. | Event |
Méthode | Défini par | ||
---|---|---|---|
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)
Crée un événement Event avec des informations spécifiques concernant des événements natifs drag-and-drop. | NativeDragEvent | ||
[override]
Crée une copie de cet objet NativeDragEvent. | NativeDragEvent | ||
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | ||
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 | ||
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | ||
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 | ||
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | ||
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements. | Event | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Formate les propriétés de cet objet NativeDragEvent sous la forme d’une chaîne. | NativeDragEvent | ||
Demande à Flash Player ou à Adobe AIR d’effectuer un rendu à la fin du traitement de cet événement, si la liste d’affichage a été modifiée. | MouseEvent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
Constante | Défini par | ||
---|---|---|---|
NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [statique]
NativeDragEvent.NATIVE_DRAG_COMPLETE définit la valeur de la propriété type d’un objet d’événement nativeDragComplete. | NativeDragEvent | ||
NATIVE_DRAG_DROP : String = "nativeDragDrop" [statique]
NativeDragEvent.NATIVE_DRAG_DROP définit la valeur de la propriété type d’un objet d’événement nativeDragDrop. | NativeDragEvent | ||
NATIVE_DRAG_ENTER : String = "nativeDragEnter" [statique]
NativeDragEvent.NATIVE_DRAG_ENTER définit la valeur de la propriété type d’un objet d’événement nativeDragEnter. | NativeDragEvent | ||
NATIVE_DRAG_EXIT : String = "nativeDragExit" [statique]
NativeDragEvent.NATIVE_DRAG_EXIT définit la valeur de la propriété type d’un objet d’événement nativeDragExit. | NativeDragEvent | ||
NATIVE_DRAG_OVER : String = "nativeDragOver" [statique]
NativeDragEvent.NATIVE_DRAG_OVER définit la valeur de la propriété type d’un objet d’événement nativeDragOver. | NativeDragEvent | ||
NATIVE_DRAG_START : String = "nativeDragStart" [statique]
NativeDragEvent.NATIVE_DRAG_START définit la valeur de la propriété type d’un objet d’événement nativeDragStart. | NativeDragEvent | ||
NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [statique]
NativeDragEvent.NATIVE_DRAG_UPDATE définit la valeur de la propriété type d’un objet d’événement nativeDragUpdate. | NativeDragEvent |
allowedActions | propriété |
public var allowedActions:NativeDragOptions
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Objet NativeDragOptions spécifiant les actions autorisées par l’objet d’affichage ayant déclenché cette opération de déplacement.
Eléments de l’API associés
clipboard | propriété |
public var clipboard:Clipboard
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Objet Clipboard contenant les données dans cette opération de déplacement.
Si l’objet qui déclenche l’événement n’est pas dans le même domaine de sécurité que l’objet déclencheur, le presse-papiers peut uniquement être lu dans le gestionnaire pour un événement nativeDragDrop
.
Eléments de l’API associés
dropAction | propriété |
public var dropAction:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Action en cours. Dans l’événement nativeDragComplete
, la propriété dropAction
signale l’action finale.
NativeDragEvent | () | Constructeur |
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)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Crée un événement Event avec des informations spécifiques concernant des événements glisser-déplacer natifs.
Les objets Event sont transmis en tant que paramètres aux écouteurs d’événement. La distribution d’un événement de glissement natif ne déclenche pas le comportement associé.
Paramètrestype:String — Type de l’événement. Les valeurs possibles sont les suivantes : NativeDragEvent.NATIVE_DRAG_START , NativeDragEvent.NATIVE_DRAG_UPDATE , NativeDragEvent.NATIVE_DRAG_ENTER , NativeDragEvent.NATIVE_DRAG_OVER , NativeDragEvent.NATIVE_DRAG_EXIT , NativeDragEvent.NATIVE_DRAG_DROP et NativeDragEvent.NATIVE_DRAG_COMPLETE .
| |
bubbles:Boolean (default = false ) — Indique si l’objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d’événements.
| |
cancelable:Boolean (default = true ) — Indique si l’objet Event peut être annulé.
| |
localX:Number (default = NaN ) — Coordonnée horizontale à laquelle l’événement s’est produit par rapport au sprite conteneur.
| |
localY:Number (default = NaN ) — Coordonnée verticale à laquelle l’événement s’est produit par rapport au sprite conteneur.
| |
relatedObject:InteractiveObject (default = null ) — L’objet d’affichage interactif connexe.
| |
clipboard:Clipboard (default = null ) — L’objet Clipboard contenant les données à transférer.
| |
allowedActions:NativeDragOptions (default = null ) — Objet NativeDragOptions définissant les actions autorisées (déplacer, copier et lier).
| |
dropAction:String (default = null ) — Action en cours.
| |
controlKey:Boolean (default = false ) — Indique si la touche Ctrl est activée.
| |
altKey:Boolean (default = false ) — Indique si la touche Alt est activée.
| |
shiftKey:Boolean (default = false ) — Indique si la touche Maj est activée.
| |
commandKey:Boolean (default = false ) — Indique si la touche Commande est activée.
|
clone | () | méthode |
toString | () | méthode |
override public function toString():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Formate les propriétés de cet objet NativeDragEvent sous la forme d’une chaîne.
La chaîne est écrite au format suivant :
[NativeDragEvent type=valeur bubbles=valeur cancelable=valeur ... commandKey=valeur]
String — Les propriétés de cet objet NativeDragEvent sous la forme d’une chaîne.
|
NATIVE_DRAG_COMPLETE | Constante |
public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_COMPLETE définit la valeur de la propriété type
d’un objet d’événement nativeDragComplete
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_DROP | Constante |
public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_DROP définit la valeur de la propriété type
d’un objet d’événement nativeDragDrop
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers peut être lu même si l’objet distribuant cet événement ne se trouve pas dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_ENTER | Constante |
public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_ENTER définit la valeur de la propriété type
d’un objet d’événement nativeDragEnter
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_EXIT | Constante |
public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_EXIT définit la valeur de la propriété type
d’un objet d’événement nativeDragExit
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_OVER | Constante |
public static const NATIVE_DRAG_OVER:String = "nativeDragOver"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_OVER définit la valeur de la propriété type
d’un objet d’événement nativeDragOver
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. Le presse-papiers ne peut être lu que si l’objet distribuant cet événement se trouve dans le même domaine de sécurité que l’initiateur. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_START | Constante |
public static const NATIVE_DRAG_START:String = "nativeDragStart"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_START définit la valeur de la propriété type
d’un objet d’événement nativeDragStart
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | true ; l’annulation de cet événement annule l’opération de déplacement. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
NATIVE_DRAG_UPDATE | Constante |
public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_UPDATE définit la valeur de la propriété type
d’un objet d’événement nativeDragUpdate
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
allowedActions | L’objet NativeDragOptions spécifiant les actions liées à cette opération glisser. |
bubbles | true |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
clipboard | L’objet Clipboard contenant les données glissées. |
dropAction | Action choisie par la cible de dépôt (ou none si aucune action n’est définie). |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z