InteractiveObject  - AS3

Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject.

Eléments de l’API associés

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

Pour le contenu s’exécutant dans Flash Player, cette propriété est un objet ContextMenu. Dans le moteur d’exécution AIR, la classe ContextMenu étend la classe NativeMenu, mais Flash Player prend en charge la classe ContextMenu uniquement, pas la classe NativeMenu.

Remarque : les objets TextField incluent toujours un menu du Presse-papiers dans le menu contextuel. Le menu du Presse-papiers comporte les commandes Couper, Copier, Coller, Effacer et Sélectionner tout. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll.

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

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énement à l’événement doubleClick.

Eléments de l’API associés

Spécifie si l’objet affiche un rectangle de focus. Trois valeurs sont possibles : true, false ou null. Les valeurs true et false fonctionnent comme prévu, c’est-à-dire indiquent si le rectangle du focus s’affiche. La valeur null indique que cet objet dépend de la propriété stageFocusRect de la scène.

Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence d’InteractiveObject figurant dans la liste d’affichage reçoit des événements de souris ou d’autres événements de saisie utilisateur. Si la propriété mouseEnabled est définie sur false, l’occurrence ne reçoit aucun événement de souris (ni aucun autre événement de saisie utilisateur, tel qu’un événement de clavier). 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.

Eléments de l’API associés

Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.

Par défaut, cette valeur est définie sur false ; placer le focus sur une occurrence d’InteractiveObject n’affiche pas de clavier logiciel. Si la propriété needsSoftKeyboard est définie sur true, le moteur d’exécution affiche un clavier logiciel lorsque l’occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur. Une occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur après un appel par programmation visant à définir la propriété focus de la scène ou une interaction utilisateur, telle qu’un appui bref. Si le système client dispose d’un clavier matériel ou ne prend pas en charge les claviers virtuels, le clavier logiciel n’apparaît pas.

L’occurrence d’InteractiveObject distribue les événements softKeyboardActivating, softKeyboardActivate et softKeyboardDeactivate lorsque le clavier logiciel apparaît ou disparaît.

Remarque : cette propriété n’est pas prise en charge dans les applications AIR sous iOS.

Eléments de l’API associés

Contrôle l’aspect du clavier logiciel.

Les périphériques disposant de claviers logiciels peuvent personnaliser les touches du clavier afin de répondre au type d’entrée prévu. Par exemple, si une entrée numérique est attendue, un périphérique peut utiliser SoftKeyboardType.NUMBER pour afficher uniquement des chiffres sur le clavier logiciel. Les valeurs valides sont définies comme constantes dans la classe SoftKeyboardType.

• "default"
• "punctuation"
• "url"
• "nombre"
• "contact"
• "e-mail"
• "phone"
• "decimalpad"

Ces valeurs sont utilisées comme conseils pour aider un périphérique à afficher le clavier le mieux adapté à l’opération en cours.

La valeur par défaut est SoftKeyboardType.DEFAULT.

Eléments de l’API associés

Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS)

Si la propriété needsSoftKeyboard de cet objet InteractiveObject est définie sur true, le moteur d’exécution ajuste l’affichage en conséquence pour conserver l’objet en vue lorsque l’utilisateur effectue une saisie. En règle générale, le moteur d’exécution utilise les limites de l’objet obtenues à partir de la méthode DisplayObject.getBounds(). Vous pouvez spécifier une autre zone à l’aide de cette propriété softKeyboardInputAreaOfInterest.

Spécifiez la propriété softKeyboardInputAreaOfInterest dans les coordonnées de la scène.

Remarque : sous Android, la propriété softKeyboardInputAreaOfInterest n’est pas respectée en mode paysage.

Remarque : softKeyboardInputAreaOfInterest n’est pas pris en charge sur iOS.

Eléments de l’API associés

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.

Remarque : pour définir l’ordre de tabulation des occurrences de TLFTextField, distribuez l’objet d’affichage enfant de TLFTextField en tant qu’objet InteractiveObject, puis définissez la propriété tabIndex. Par exemple :

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

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()

Affiche un clavier virtuel.

L’appel de cette méthode place le focus sur l’occurrence d’InteractiveObject et affiche le clavier logiciel, si nécessaire. La propriété needsSoftKeyboard doit également être définie sur true. Aucun clavier n’apparaît si un clavier matériel est disponible ou si le système client ne prend pas en charge les claviers virtuels.

Remarque : cette méthode n’est pas prise en charge dans les applications AIR sous iOS.

Eléments de l’API associés

Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de supprimer le texte actuellement sélectionné dans le champ de texte.

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

Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).

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’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.

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

Eléments de l’API associés

Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de copier le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.

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

Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).

Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de couper le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.

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

Remarque : les objets TextField ne distribuent pas les événements clear, copy, cut, paste ou selectAll. Les objets TextField incluent toujours les commandes Couper, Copier, Coller, Effacer et Sélectionner tout dans le menu contextuel. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement clear, copy, cut, paste ou selectAll. Toutefois, les autres classes qui étendent la classe InteractiveObject, y compris les composants intégrés à l’aide de Flash Text Engine (FTE), distribueront ces événements en réponse aux actions de l’utilisateur (raccourcis clavier et menus contextuels, entre autres).

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 :

Eléments de l’API associés

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 crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles.

De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les déplace, l’occurrence InteractiveObject peut distribuer un événement touchBegin et un événement touchEnd (entre autres) en plus de l’événement gestureDirectionalTap, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement touchBegin, le même gestionnaire d’événement sera exécuté sur un périphérique tactile. Toutefois, si vous choisissez de gérer l’événement gestureDirectionalTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement de mouvement ou d’un événement tactile. Cependant, la décision de déclenchement de l’événement tactile ou de mouvement revient à la classe flash.ui.Multitouch.

Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal (pour l’Apple TV, il s’agit du centre de l’écran). Les propriétés offsetX et offsetY correspondent à la direction du mouvement.

Remarque : Cette API ne prend en charge que l’appui directionnel avec un seul doigt.

L’objet TransformGestureEvent possède les propriétés suivantes :

Eléments de l’API associés

Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). Certains périphériques peuvent également interpréter ce contact comme un événement doubleClick.

De façon plus spécifique, si un utilisateur appuie brièvement avec deux doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement doubleClick ou un événement gestureTwoFingerTap, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement doubleClick, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureTwoFingerTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.

Eléments de l’API associés

Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement mouseOver et comme un événement touchOver.

De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver, un événement touchOver ou un événement gesturePan, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gesturePan, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.

L’objet TransformGestureEvent possède les propriétés suivantes :

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Eléments de l’API associés

Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). Bien que cette manière d’effectuer une rotation soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de rotation. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.

De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gestureRotate, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureRotate, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où le mouvement de rotation se termine.

Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.

Lors de cet événement, la propriété rotation contient l’angle de rotation. Les valeurs de rotation sont les suivantes :

• De 0 à 180 degrés dans le sens des aiguilles d’une montre
• De - 180 à 0 degrés dans le sens inverse des aiguilles d’une montre

L’objet TransformGestureEvent possède les propriétés suivantes :

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Eléments de l’API associés

Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que le déplacement parallèle de plusieurs doigts soit un mouvement de glissement commun, chaque périphérique ou système d’exploitation peut avoir sa propre méthode de glissement. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.

De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les déplace simultanément, l’occurrence d’InteractiveObject peut distribuer un événement rollOver et un événement rollOut (entre autres) en plus de l’événement gestureSwipe, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Si vous choisissez de gérer l’événement rollOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureSwipe, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où se termine le mouvement de glissement.

Remarque : bien que certains périphériques qui utilisent le système d’exploitation Mac OS soient capables d’interpréter un glissement à quatre doigts, cette API prend en charge un glissement à trois doigts uniquement.

L’objet TransformGestureEvent possède les propriétés suivantes :

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

Eléments de l’API associés

Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.

De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, puis appuie brièvement dessus avec un doigt, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gesturePressAndTap, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gesturePressAndTap, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal (l’« appui »). Les propriétés offsetX et offsetY représentent la distance au point de contact secondaire (l’« appui bref »).

Eléments de l’API associés

Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que cette manière d’effectuer un zoom soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de zoom. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.

De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les écarte, l’occurrence d’InteractiveObject peut distribuer un événement mouseOver et un événement click (entre autres) en plus de l’événement gestureZoom, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement mouseOver, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement gestureZoom, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.

Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés localX et localY sont définies sur le point de contact principal. Les propriétés offsetX et offsetY représentent la distance jusqu’au point de contact où le mouvement de zoom se termine.

Remarque : voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.

L’objet TransformGestureEvent possède les propriétés suivantes :

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Eléments de l’API associés

Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.

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.

Dans AIR, l’annulation de cet événement empêche le caractère d’être inséré dans un champ de texte.

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

Plus d’exemples

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. Le focus change et les événements focusIn et focusOut sont distribués 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 sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement middleClick se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement middleMouseDown, puis middleMouseUp. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement middleClick ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements middleMouseDown et middleMouseUp, l’événement middleClick se produit.

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

Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.

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

Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.

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

Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. 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. Le focus change et les événements focusIn et focusOut sont distribués 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 de 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 de 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 place un périphérique de pointage sur une occurrence de InteractiveObject. 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é lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. 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 la molette d’une souris est actionnée sur une occurrence de InteractiveObject. Si la cible est un champ de texte, le comportement par défaut consiste à faire défiler le texte. Disponible uniquement sur les systèmes d’exploitation Microsoft Windows.

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

Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.

La propriété dropAction de l’événement indique l’action définie par l’objet cible drag ; une valeur "none" (DragActions.NONE) indique que l’opération déposer a été annulée ou refusée.

Le gestionnaire d’événement nativeDragComplete est un espace pratique permettant de mettre à jour l’état de l’objet d’affichage déclencheur, notamment en supprimant un élément d’une liste (sur un mouvement de glissement) ou en changeant les propriétés visuelles.

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

Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().

Accédez aux données déposées à l’aide de la propriété clipboard de l’objet d’événement.

Le gestionnaire de cet événement doit régler la propriété DragManager.dropAction pour fournir des informations à l’objet déclencheur sur l’action glisser effectuée. Si aucune valeur n’est réglée, le DragManager sélectionne une valeur par défaut dans la liste des actions autorisées.

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