| Package | mx.states |
| Classe | public class State |
| Héritage | State  EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
overrides spécifie un jeu de classes enfant à ajouter ou supprimer de l’état d’affichage de base et des propriétés, des styles et des gestionnaires d’événements à définir lorsque l’état d’affichage est en vigueur.
Utilisez la classe State dans la propriété states des composants Flex. Vous pouvez spécifier uniquement une propriété states à la racine d’une application ou d’un contrôle personnalisé et non sur des contrôles enfant.
Vous activez un état d’affichage en définissant la propriété currentState d’un composant.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:State> tag has the following attributes:
<mx:State Properties basedOn="null" name="null" overrides="null" />
Propriété MXML par défautoverrides
Eléments de l’API associés
mx.states.RemoveChild
mx.states.SetEventHandler
mx.states.SetProperty
mx.states.SetStyle
mx.states.Transition
| Propriété | Défini par | ||
|---|---|---|---|
| basedOn : String
Nom de l’état d’affichage sur lequel cet état d’affichage est basé ou null si cet état d’affichage n’est pas basé sur un état d’affichage nommé. | State | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| name : String
Nom de l’état d’affichage. | State | ||
| overrides : Array
Remplacements de cet état d’affichage, sous la forme d’un tableau d’objets qui implémentent l’interface IOverride. | State | ||
| stateGroups : Array
Groupes d’états auxquels appartient cet état d’affichage sous la forme d’un tableau de chaîne. | State | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | State | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
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 | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
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 | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué après le passage à un état d’affichage. | State | |||
| Distribué juste avant la désactivation d’un état d’affichage. | State | |||
basedOn | propriété |
public var basedOn:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de l’état d’affichage sur lequel cet état d’affichage est basé ou null si cet état d’affichage n’est pas basé sur un état d’affichage nommé. Si cette valeur est null, l’état d’affichage est basé sur un état racine composé des propriétés, styles, gestionnaires d’événements et enfants que vous définissez pour un composant sans utiliser de classe State.
La valeur par défaut est null.
name | propriété |
public var name:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom de l’état d’affichage. Les noms d’états doivent être uniques pour un composant donné. Cette propriété doit être définie.
overrides | propriété |
public var overrides:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Remplacements de cet état d’affichage, sous la forme d’un tableau d’objets qui implémentent l’interface IOverride. Ces remplacements sont appliqués dans l’ordre dans lequel l’état est saisi et supprimés dans l’ordre inverse lorsque l’état est désactivé.
Les classes Flex suivantes implémentent l’interface et vous permettent de définir les caractéristiques de l’état d’affichage :
- AddChild
- RemoveChild
- SetEventHandler
- SetProperty
- SetStyle
La propriété overrides est la propriété par défaut de la classe State. Vous pouvez omettre la balise <mx:overrides> et sa balise enfant <mx:Array> si vous utilisez la syntaxe de balise MXML pour définir les remplacements.
stateGroups | propriété |
public var stateGroups:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Groupes d’états auxquels appartient cet état d’affichage sous la forme d’un tableau de chaîne.
State | () | Constructeur |
enterState | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.ENTER_STATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué après le passage à un état d’affichage.
La constanteFlexEvent.ENTER_STATE définit la valeur de la propriété type de l’objet d’événement d’un événement enterState.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
exitState | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.EXIT_STATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué juste avant la désactivation d’un état d’affichage. Cet événement est distribué avant la suppression des modifications apportées à l’état d’affichage par défaut.
La constanteFlexEvent.EXIT_STATE définit la valeur de la propriété type de l’objet d’événement d’un événement exitState.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Tue Jun 12 2018, 09:30 AM Z