Packagefl.events
Classepublic class ListEvent
HéritageListEvent Inheritance Event Inheritance Object
Sous-classes DataGridEvent

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

La classe ListEvent définit les événements des composants à base de liste, y compris List, DataGrid, TileList et ComboBox. Parmi ces événements figurent, notamment :

Consulter les exemples

Voir aussi

Liste
SelectableList


Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l'événement peut être annulé.
Event
  columnIndex : int
[lecture seule] Récupère l'index de la colonne qui contient l'élément associé à cet événement.
ListEvent
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d'événements.
Event
  index : int
[lecture seule] Récupère l'index basé sur zéro de la cellule qui contient la fonction de rendu.
ListEvent
  item : Object
[lecture seule] Récupère la donnée qui appartient à la fonction de rendu active.
ListEvent
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
  rowIndex : Object
[lecture seule] Récupère l'index de la ligne qui contient l'élément associé à cet événement.
ListEvent
 Inheritedtarget : Object
[lecture seule] Cible de l'événement.
Event
 Inheritedtype : String
[lecture seule] Type d'événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)
Crée un nouvel objet ListEvent avec les paramètres spécifiés.
ListEvent
  
Crée une copie de l'objet ListEvent et définit la valeur de chaque paramètre pour correspondre à l'original.
ListEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l'événement.
Event
 Inherited
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
 Inherited
Annule le comportement par défaut d'un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
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 une chaîne contenant toutes les propriétés de l'objet ListEvent.
ListEvent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change.
Event
 InheritedCLEAR : String = "clear"
[statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear.
Event
 InheritedCLOSE : String = "close"
[statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing.
Event
 InheritedCOMPLETE : String = "complete"
[statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedCOPY : String = "copy"
[statique] Définit la valeur de la propriété type d'un objet d'événement copy.
Event
 InheritedCUT : String = "cut"
[statique] Définit la valeur de la propriété type d'un objet d'événement cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender.
Event
 InheritedID3 : String = "id3"
[statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init.
Event
  ITEM_CLICK : String = "itemClick"
[statique] Définit la valeur de la propriété type d'un objet de l'événement itemClick.
ListEvent
  ITEM_DOUBLE_CLICK : String = "itemDoubleClick"
[statique] Définit la valeur de la propriété type d'un objet de l'événement itemDoubleClick.
ListEvent
  ITEM_ROLL_OUT : String = "itemRollOut"
[statique] Définit la valeur de la propriété type d'un objet de l'événement itemRollOut.
ListEvent
  ITEM_ROLL_OVER : String = "itemRollOver"
[statique] Définit la valeur de la propriété type de l'objet d'un événement itemRollOver.
ListEvent
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange.
Event
 InheritedOPEN : String = "open"
[statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedPASTE : String = "paste"
[statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste.
Event
 InheritedREMOVED : String = "removed"
[statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent.
Event
Détails de la propriété
columnIndexpropriété
columnIndex:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Récupère l'index de la colonne qui contient l'élément associé à cet événement.



Implémentation
    public function get columnIndex():int

Voir aussi

indexpropriété 
index:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Récupère l'index basé sur zéro de la cellule qui contient la fonction de rendu.



Implémentation
    public function get index():int
itempropriété 
item:Object  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Récupère la donnée qui appartient à la fonction de rendu active.



Implémentation
    public function get item():Object
rowIndexpropriété 
rowIndex:Object  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Récupère l'index de la ligne qui contient l'élément associé à cet événement.



Implémentation
    public function get rowIndex():Object

Voir aussi

Détails du constructeur
ListEvent()Constructeur
public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Crée un nouvel objet ListEvent avec les paramètres spécifiés.

Paramètres
type:String — Type d'événement ; cette valeur indique l'action qui a déclenché l'événement.
 
bubbles:Boolean (default = false) — Indique si l'événement peut propager vers le haut la hiérarchie de la liste d'affichage.
 
cancelable:Boolean (default = false) — Indique si le comportement associé à l'événement peut être annulé.
 
columnIndex:int (default = -1) — Index basé sur zéro de la colonne qui contient la fonction de rendu, ou représentation visuelle des données présentes dans la colonne.
 
rowIndex:int (default = -1) — Index basé sur zéro de la ligne qui contient la fonction de rendu, ou représentation visuelle des données présentes dans la ligne.
 
index:int (default = -1) — Index basé sur zéro de l'élément dans le DataProvider.
 
item:Object (default = null) — Référence à la donnée qui appartient à la fonction de rendu.
Détails de la méthode
clone()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Crée une copie de l'objet ListEvent et définit la valeur de chaque paramètre pour correspondre à l'original.

Valeur renvoyée
Event — Nouvel objet ListEvent dont les paramètres ont la même valeur que ceux de l'objet d'origine.
toString()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Renvoie une chaîne contenant toutes les propriétés de l'objet ListEvent. La chaîne est écrite au format suivant :

[ListEvent type= valeur bubbles= valeur cancelable= valeur columnIndex= valeur rowIndex= valeur]

Valeur renvoyée
String — Représentation sous forme de chaîne de l'objet ListEvent.
Détails de la constante
ITEM_CLICKConstante
public static const ITEM_CLICK:String = "itemClick"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement itemClick.

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

PropriétéValeur
bubbles false
cancelable true
columnIndex Index basé sur zéro de la colonne qui contient la fonction de rendu.
currentTarget Objet qui traite activement l'objet de l'événement avec un écouteur d'événement.
index Index basé sur zéro du DataProvider qui contient la fonction de rendu.
item Référence à la donnée qui appartient à la fonction de rendu.
rowIndex Index basé sur zéro de la ligne qui contient la fonction de rendu.
target Objet qui a distribué l'événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété currentTarget.

ITEM_DOUBLE_CLICKConstante 
public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement itemDoubleClick.

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

PropriétéValeur
bubbles false
cancelable true
columnIndex Index basé sur zéro de la colonne qui contient la fonction de rendu.
currentTarget Objet qui traite activement l'objet de l'événement avec un écouteur d'événement.
index Index basé sur zéro du DataProvider qui contient la fonction de rendu.
item Référence à la donnée qui appartient à la fonction de rendu.
rowIndex Index basé sur zéro de la ligne qui contient la fonction de rendu.
target Objet qui a distribué l'événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété currentTarget.

ITEM_ROLL_OUTConstante 
public static const ITEM_ROLL_OUT:String = "itemRollOut"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement itemRollOut.

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

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
columnIndex Index basé sur zéro de la colonne qui contient la fonction de rendu.
currentTarget Objet qui traite activement l'objet de l'événement avec un écouteur d'événement.
index Index basé sur zéro du DataProvider qui contient la fonction de rendu.
item Référence à la donnée qui appartient à la fonction de rendu.
rowIndex Index basé sur zéro de la ligne qui contient la fonction de rendu.
target Objet qui a distribué l'événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété currentTarget.

Voir aussi

ITEM_ROLL_OVERConstante 
public static const ITEM_ROLL_OVER:String = "itemRollOver"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement itemRollOver.

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

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
columnIndex Index basé sur zéro de la colonne qui contient la fonction de rendu.
currentTarget Objet qui traite activement l'objet de l'événement avec un écouteur d'événement.
index Index basé sur zéro du DataProvider qui contient la fonction de rendu.
item Référence à la donnée qui appartient à la fonction de rendu.
rowIndex Index basé sur zéro de la ligne qui contient la fonction de rendu.
target Objet qui a distribué l'événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété currentTarget.

Voir aussi

Exemples Utilisation des exemples
ListEventExample.as

Cet exemple montre comment utiliser la classe ListEvent pour déterminer la ligne et la colonne d'un élément dans une grille de données.
  1. Ajoutez le composant DataGrid dans votre bibliothèque.
  2. Enregistrez ce code sous le nom ListEventExample.as dans le même répertoire que votre fichier FLA.
  3. Dans le fichier FLA, définissez DocumentClass sur ListEventExample.
package
{
    import flash.display.Sprite;
    import fl.data.DataProvider;
    import fl.controls.DataGrid;
    import fl.events.ListEvent;
    
    public class ListEventExample extends Sprite
    {
        private var dg:DataGrid;
        
        public function ListEventExample() {
            createDataGrid();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            addChild(dg);
            dg.setSize(200,300);
            
            var dp:DataProvider = new DataProvider();
            var i:uint;
            var totalRows:uint = 42;
            for(i=0; i<totalRows; i++) {
                dp.addItem( {     col1:getRandomNumber(),
                                   col2:getRandomNumber(),
                                col3:getRandomNumber() } );
            }
            dg.dataProvider = dp;
            dg.addEventListener(ListEvent.ITEM_ROLL_OVER, declarePosition);
        }
        private function declarePosition(e:ListEvent):void {
            trace("You are above row: " + e.rowIndex + " column: " + e.columnIndex);    
        }
        private function getRandomNumber():uint {
            return Math.round(Math.random()*100);
        }
    }
}