Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
fl.controls.listClasses 

ICellRenderer  - AS3 Flash

Packagefl.controls.listClasses
Interfacepublic interface ICellRenderer
Implémenteurs CellRenderer, DataGridCellEditor, ImageCell

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

L’interface ICellRenderer fournit les méthodes et les propriétés requises par un rendu de cellule. Tous les rendus de cellule définis par l’utilisateur doivent implémenter cette interface. Tous les rendus de cellule définis par l’utilisateur doivent étendre la classe UIComponent ou une sous-classe de la classe UIComponent.

Consulter les exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  data : Object
Récupère ou définit un objet Object qui représente les données associées à un composant.
ICellRenderer
  listData : ListData
Récupère ou définit les propriétés list qui sont appliquées à la cellule, par exemple les valeurs index et selected.
ICellRenderer
  selected : Boolean
Récupère ou définit une valeur booléenne indiquant si la cellule active est sélectionnée.
ICellRenderer
  x : Number
[écriture seule] Définit la coordonnée X du rendu de cellule
ICellRenderer
  y : Number
[écriture seule] Définit la coordonnée Y du rendu de cellule
ICellRenderer
Méthodes publiques
 MéthodeDéfini par
  
Définit la cellule active sur un état spécifique de la souris.
ICellRenderer
  
setSize(width:Number, height:Number):void
Définit la taille des données en fonction des valeurs spécifiées en pixels par les paramètres width et height.
ICellRenderer
Détails de la propriété

data

propriété
data:Object

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit un objet Object qui représente les données associées à un composant. Lorsque cette valeur est définie, les données du composant sont stockées et le conteneur est invalidé. Le composant invalidé est alors automatiquement redessiné.

La propriété data représente l’objet contenant l’élément dans le DataProvider représenté par la cellule. Généralement, la propriété data contient des propriétés standard, qui dépendent du type du composant. Dans le CellRenderer d’un composant List ou ComboBox, les données contiennent des propriétés label, icon et data ; un composant TileList : une propriété label et source ; une cellule DataGrid contient les valeurs de chaque colonne. La propriété data contient également les données définies par l’utilisateur et relatives à la cellule. Les utilisateurs peuvent étendre un CellRenderer en composant afin d’exploiter différentes propriétés de données dans le rendu de la cellule.

De plus, les éléments labelField, labelFunction, iconField, iconFunction, sourceField et sourceFunction peuvent servir à désigner les propriétés à utiliser pour dessiner l’étiquette, l’icône et la source, respectivement.



Implémentation
    public function get data():Object
    public function set data(value:Object):void

listData

propriété 
listData:ListData

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit les propriétés list qui sont appliquées à la cellule, par exemple les valeurs index et selected. Ces propriétés list sont automatiquement mises à jour après l’invalidation de la cellule.



Implémentation
    public function get listData():ListData
    public function set listData(value:ListData):void

selected

propriété 
selected:Boolean

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit une valeur booléenne indiquant si la cellule active est sélectionnée. La valeur true indique que la cellule active est sélectionnée ; la valeur false indique qu’elle ne l’est pas.



Implémentation
    public function get selected():Boolean
    public function set selected(value:Boolean):void

x

propriété 
x:Number  [écriture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Définit la coordonnée X du rendu de cellule



Implémentation
    public function set x(value:Number):void

y

propriété 
y:Number  [écriture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Définit la coordonnée Y du rendu de cellule



Implémentation
    public function set y(value:Number):void
Détails de la méthode

setMouseState

()méthode
public function setMouseState(state:String):void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Définit la cellule active sur un état spécifique de la souris. Cette méthode est nécessaire pour que le composant DataGrid définisse l’état de la souris sur une ligne complète lorsque l’utilisateur interagit avec une seule cellule.

Paramètres

state:String — Chaîne qui indique l’état de la souris, tel que « relevé » ou « survolant ».

setSize

()méthode 
public function setSize(width:Number, height:Number):void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Définit la taille des données en fonction des valeurs spécifiées en pixels par les paramètres width et height.

Paramètres

width:Number — Largeur d’affichage du rendu de cellule, en pixels.
 
height:Number — Hauteur d’affichage du rendu de cellule, en pixels.

ICellRendererExample.as

Cet exemple crée un rendu de cellule personnalisé en implémentant la classe ICellRenderer.

Pour exécuter l’exemple, suivez ces étapes :

  1. Ajoutez les composants List et Button dans la bibliothèque.
  2. Enregistrez ce code sous le nom ICellRendererExample.as dans le même répertoire que votre fichier FLA.
  3. Dans le fichier FLA, définissez la classe Document sur ICellRendererExample.
package
{ 
    import fl.controls.List;
    import fl.data.DataProvider;
    import fl.events.ListEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    
    public class ICellRendererExample extends Sprite
    {
        public function ICellRendererExample() {
            var dp:DataProvider = new DataProvider();
            var totalEntries:Number = 42;
            var i:Number;
            for(i=0; i<totalEntries; i++) {
                dp.addItem( { label:Math.random(), data:null } );            
            }
            
            var myList = new List();
            myList.setSize(300,300);
            myList.move(10,10);
            myList.setStyle('cellRenderer', MyRenderer);    
            myList.dataProvider = dp;
            addChild(myList);
        }
    }
}
MyRenderer.as

Enregistrez le code suivant sous le nom MyRenderer.as dans le même répertoire que votre fichier FLA :
package
{
    import fl.controls.LabelButton;
    import fl.controls.listClasses.ICellRenderer;
    import fl.controls.listClasses.ListData;
    
    public class MyRenderer extends LabelButton implements ICellRenderer {
        private var _listData:ListData;
        private var _data:Object;
        
        public function MyRenderer() {
        }

        public function set listData(newListData:ListData):void {
            _listData = newListData;
            label = "Random: " + _listData.label;
            drawRandomColor();
        }

        private function drawRandomColor():void {
            graphics.beginFill(Math.random()*0xFFFFFF);
            graphics.drawRect(0,0,20,20);
            graphics.endFill();            
        }

        public function get listData():ListData {
            return _listData;
        }

        public function set data(newData:Object):void {
            _data = newData;
        }

        public function get data():Object {
            return _data;
        }
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.