Spécifie le menu contextuel associé à l’objet.

Spécifie si l’objet reçoit les événements doubleClick. La valeur par défaut est false, ce qui signifie que, par défaut, une occurrence d'InteractiveObject ne reçoit pas les événements doubleClick. Si la propriété doubleClickEnabled est réglée sur true, l’occurrence reçoit les événements doubleClick qui la concernent. La propriété mouseEnabled de l’occurrence d'InteractiveObject doit également être réglée sur true pour que l’objet reçoive les événements doubleClick.

Définir cette propriété ne distribue aucun événement. Vous devez utiliser la méthode addEventListener() pour ajouter un écouteur d'événements à l'événement doubleClick.

Voir aussi

Spécifie si l’objet affiche un rectangle de focus. La valeur null indique que cet objet dépend de la propriété stageFocusRect définie sur la scène.

Spécifie si l’objet reçoit les messages souris. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence de InteractiveObject figurant dans la liste d’affichage reçoit les événements de souris. Si mouseEnabled est défini sur false, l’occurrence ne reçoit pas d’événement de souris. Aucun enfant de cette occurrence figurant dans la liste d’affichage n’est affecté. Pour modifier le comportement mouseEnabled de tous les enfants d’un objet figurant dans la liste d’affichage, utilisez flash.display.DisplayObjectContainer.mouseChildren.

Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.

Voir aussi

Indique si cet objet est spécifié dans l’ordre de tabulation. Lorsque cet objet figure dans l'ordre de tabulation, la valeur est true. Sinon, elle est false. La valeur par défaut est false, sauf pour les éléments suivants :

• Pour un objet SimpleButton, la valeur est true.
• Pour un objet TextField avec type = "input", la valeur est true.
• Pour un objet Sprite ou MovieClip avec buttonMode = true, la valeur true.

Spécifie l'ordre de tabulation des objets dans un fichier SWF. La propriété tabIndex est réglée sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est associé à l’objet.

Si un objet actuellement affiché dans le fichier SWF contient une propriété tabIndex, l'ordre de tabulation automatique est désactivé : l'ordre de tabulation est alors calculé à partir des propriétés tabIndex des objets contenus dans le fichier SWF. L'ordre de tabulation personnalisé inclut uniquement les objets dotés de propriétés tabIndex.

La propriété tabIndex peut être un entier non négatif. Les objets sont triés selon leurs propriétés tabIndex, par ordre croissant. Un objet dont la valeur de tabIndex est définie sur 1 précède celui dont la valeur de tabIndex est 2. N'appliquez pas la même valeur tabIndex à plusieurs objets.

L'ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que les relations hiérarchiques des objets contenus dans le fichier SWF ne sont pas prises en compte. Tous les objets du fichier SWF dotés de propriétés tabIndex sont placés dans l'ordre de tabulation, qui est déterminé par l'ordre des valeurs tabIndex.

L'appel du constructeur new InteractiveObject() renvoie une exception ArgumentError. Vous pouvez cependant appeler des constructeurs pour les sous-classes suivantes de InteractiveObject :

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu'un événement clic se produise, il doit toujours suivre cette série d'événements dans l'ordre suivant : événement mouseDown, puis mouseUp. L'objet cible doit être identique pour ces deux événements, sans quoi l’événement click ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements mouseDown et mouseUp, l’événement click se produit.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur appuie sur le bouton principal d'un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d'InteractiveObject si l’indicateur doubleClickEnabled de cet objet est défini sur true. Pour qu'un événement doubleClick se produise, il doit suivre immédiatement la série d'événements ci-après : mouseDown, mouseUp, click, mouseDown, mouseUp. Tous ces événements doivent partager la même cible en tant qu'événement doubleClick. Le second clic, représenté par les seconds événements mouseDown et mouseUp, doit se produire dans un délai spécifique après l’événement click. La longueur autorisée de ce délai varie selon le système d'exploitation et peut souvent être configurée par l'utilisateur. Si la cible est un champ de texte sélectionnable, le comportement par défaut consiste à sélectionner le mot qui se trouve sous le pointeur. Si l’indicateur doubleClickEnabled de l’objet InteractiveObject cible n’est pas réglé sur true, celui-ci reçoit deux événements click.

La propriété doubleClickEnabled prend par défaut la valeur false.

Le comportement de sélection de texte par le biais d'un double clic d’un objet TextField n’est pas lié à l’événement doubleClick. Utilisez TextField.doubleClickEnabled pour contrôler les sélections TextField.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué après la prise de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche l’objet en surbrillance à l’aide d’un périphérique de pointage ou du clavier. L’objet qui reçoit le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d'InteractiveObject correspondante qui perd le focus en raison de ce changement porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété relatedObject de l’objet cible. La propriété shiftKey n’est pas utilisée. Cet événement suit la distribution de l’événement focusOut de l’objet précédent.

Les propriétés de cet événement sont les suivantes :

Distribué après la perte de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche en surbrillance un autre objet à l’aide d’un périphérique de pointage ou du clavier. L’objet qui perd le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d'InteractiveObject correspondante qui reçoit le focus porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété relatedObject de l’objet cible. La propriété shiftKey n’est pas utilisée. Cet événement précède la distribution de l’événement focusIn par l’objet apparenté.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur appuie sur une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d'exploitation. Ce type d'événement est généré lors du mappage, mais avant le traitement d'un éditeur de méthode d'entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit avant l’événement keyUp.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements focusIn et focusOut correspondants.

Cet événement est distribué à l'objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d'InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez preventDefault() dans un écouteur d’événement correctement enregistré auprès de l’objet cible. Flash Player déplace le focus et distribue les événements focusIn et focusOut en tant que comportement par défaut.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur relâche une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d'exploitation. Ce type d'événement est généré lors du mappage, mais avant le traitement d'un éditeur de méthode d'entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit après un événement keyDown et présente les caractéristiques suivantes :

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur appuie à l’aide du bouton du périphérique de pointage sur une occurrence d'InteractiveObject dans la fenêtre Flash Player. Lorsque la cible est une occurrence de SimpleButton, celle-ci affiche l'objet d'affichage downState en tant que comportement par défaut. Si la cible est un champ de texte sélectionnable, le champ de texte commence la sélection, ce qui est son comportement par défaut.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements focusIn et focusOut correspondants.

Cet événement est distribué à l'objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d'InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez preventDefault() dans un écouteur d’événement correctement enregistré auprès de l’objet cible. La propriété shiftKey n’est pas utilisée. Flash Player déplace le focus et distribue les événements focusIn et focusOut en tant que comportement par défaut.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence d'InteractiveObject. Si la cible est un champ de texte sélectionné par l’utilisateur, le comportement par défaut consiste à mettre à jour la sélection.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence d'InteractiveObject. L’événement a pour cible l’objet précédemment placé sous le périphérique de pointage. L’objet relatedObject correspond à l’objet sur lequel s’est placé le périphérique de pointage. Lorsque la cible est une occurrence de SimpleButton, le bouton présente l'objet d'affichage upState comme comportement par défaut.

L'événement mouseOut est envoyé chaque fois que la souris quitte la zone d'un objet enfant du conteneur d'objet d'affichage, même si la souris reste au-dessus d'un autre objet enfant du conteneur d'objet d'affichage. Ce comportement est différent de celui de l'événement rollOut qui a pour objet de simplifier le codage des comportements de survol des conteneurs d'objet d'affichage avec enfants. Lorsque la souris quitte la zone d'un objet d'affichage ou de l'un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l'objet d'affichage distribue l'événement rollOut. Les événements rollOut sont distribués de façon consécutive vers le haut de la chaîne parent de l'objet, en commençant par l'objet et en se terminant par le parent de plus haut niveau qui n'est ni la racine, ni l'ancêtre de relatedObject.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur déplace un périphérique de pointage sur une occurrence d'InteractiveObject dans la fenêtre Flash Player. relatedObject correspond à l’objet précédemment placé sous le périphérique de pointage. Si la cible est une occurrence de SimpleButton, l'objet présente l'objet d'affichage overState ou upState, selon que le bouton de la souris est enfoncé ou non, comme comportement par défaut.

L'événement mouseOver est envoyé chaque fois que la souris pénètre dans la zone d'un objet enfant du conteneur d'objet d'affichage, même si la souris survolait déjà un autre objet enfant du conteneur d'objet d'affichage. Ce comportement est différent de celui de l'événement rollOver qui a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d'objet d'affichage avec enfants. Lorsque la souris pénètre dans la zone d'un objet d'affichage ou de l'un de ses enfants à partir d'un objet qui ne fait pas partie de ses enfants, l'objet d'affichage distribue l'événement rollOver. Les événements rollOver sont envoyés de façon consécutive vers le bas de la chaîne parent de l'objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l'ancêtre de relatedObject et se termine par l'objet.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur relâche le bouton du périphérique de pointage sur une occurrence d'InteractiveObject dans la fenêtre Flash Player. Si la cible est une occurrence de SimpleButton, l'objet présente l’objet d'affichage upState. Si la cible est un champ de texte sélectionnable, le champ de texte termine la sélection, ce qui est son comportement par défaut.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur fait tourner la molette de sa souris sur une occurrence d'InteractiveObject dans la fenêtre Flash Player. Si la cible est un champ de texte, le comportement par défaut consiste à faire défiler le texte.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence d'InteractiveObject. L’événement a pour cible l’objet placé précédemment sous le périphérique de pointage ou un parent de cet objet. L’objet relatedObject correspond à l’objet sur lequel s’est placé le périphérique de pointage. Les événements rollOut sont envoyés de façon consécutive vers le haut de la chaîne parent de l'objet, en commençant par l'objet et en se terminant par le parent de plus haut niveau qui n'est ni la racine, ni l'ancêtre de relatedObject.

L’événement rollOut a pour objet de simplifier le codage des comportements de survol des conteneurs d'objet d'affichage avec enfants. Lorsque la souris quitte la zone d'un objet d'affichage ou de l'un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l'objet d'affichage distribue l'événement rollOut. Ce comportement diffère de celui de l'événement mouseOut, qui est envoyé lorsque la souris quitte la zone d'un objet enfant du conteneur d'objet d'affichage, même si la souris reste au-dessus d'un autre objet enfant du conteneur d'objet d'affichage.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence d'InteractiveObject. L’événement a pour cible l’objet placé sous le périphérique de pointage ou un parent de cet objet. relatedObject correspond à l’objet précédemment placé sous le périphérique de pointage. Les événements rollOver sont envoyés de façon consécutive vers le bas de la chaîne parent de l'objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l'ancêtre de relatedObject et se termine par l'objet.

L’événement rollOver a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d'objet d'affichage avec enfants. Lorsque la souris pénètre dans la zone d'un objet d'affichage ou de l'un de ses enfants à partir d'un objet qui ne fait pas partie de ses enfants, l'objet d'affichage distribue l'événement rollOver. Ce comportement diffère de celui de l'événement mouseOver, qui est envoyé lorsque la souris entre dans la zone d'un objet enfant du conteneur d'objet d'affichage, même si la souris reste au-dessus d'un autre objet enfant du conteneur d'objet d'affichage.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l’indicateur tabEnabled de l’objet change.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque la valeur de la propriété tabIndex de l’objet change.

Les propriétés de cet événement sont les suivantes :

1. Dans le constructeur InteractiveObjectExample, un nouvel objet ChildSprite de type Sprite appelé child est créé, qui en retour appelle la méthode de constructeur ChildSprite pour dessiner la forme et ajoute des événements de souris à la forme (comme expliqué au cours des étapes suivantes). L'objet child est ajouté dans la partie supérieure de la liste d'affichage aux coordonnées x = 0, y = 0.
2. Dans la classe ChildSprite, déclarez les propriétés size et overSize qui sont utilisées par la suite par les méthodes draw() et MouseEvent.
3. Déclare des propriétés qui définissent la couleur de fond sur orange, la couleur de survol de la souris sur jaune et la couleur clic sur bleu clair.
4. Dans le constructeur ChildSprite, un carré orange est dessiné à l'aide des méthodes de la classe Graphics et de la méthode draw().
5. Le constructeur ajoute quatre méthodes d'écouteur d'événements MouseEvent :
6. • mouseOverHandler : dessine de nouveau un carré plus grand, de 60x60 pixels, en jaune plus sombre et aux coordonnées d'origine.
   • mouseOutHandler : rétablit la couleur et la taille d'origine du carré.
   • mouseDownHandler : dessine de nouveau un carré plus grand, de 60x60 pixels, en bleu clair et aux coordonnées d'origine.
   • mouseUpHandler : identique à mouseOverHandler.

package {
    import flash.display.Sprite;

    public class InteractiveObjectExample extends Sprite {

        public function InteractiveObjectExample() {
            var child:Sprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        buttonMode = true;
        draw(size, size, backgroundColor);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    public function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    public function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    public function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);
    }

    public function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        draw(overSize, overSize, overColor);
    }
}