Flash CS4 Professional ActionScript 2.0

Classe DataGridColumn

Nom de classe ActionScript mx.controls.gridclasses.DataGridColumn

Vous pouvez créer et configurer des objets DataGridColumn à utiliser en tant que colonnes d'une grille de données. Un grand nombre de méthodes de la classe DataGrid est consacré à la gestion des objets DataGridColumn. Dans la grille de données, les objets DataGridColumn sont triés dans un tableau basé sur zéro, c'est-à-dire la colonne la plus à gauche. Une fois les colonnes ajoutées ou créées, vous pouvez appeler DataGrid.getColumnAt(index) pour y accéder.

Il existe trois manières d'ajouter ou de créer des colonnes dans une grille. Si vous souhaitez configurer les colonnes, il est préférable d'utiliser la deuxième ou la troisième méthode avant d'ajouter des données dans une grille. Ainsi vous n'aurez pas à créer les colonnes deux fois.

  • Ajoutez un fournisseur de données ou un élément comportant plusieurs champs à une grille qui ne possède aucun objet DataGridColumn configuré. Cette méthode génère automatiquement des colonnes pour tous les champs, dans l'ordre inverse de la boucle for..in. Par exemple, pour une occurrence du composant DataGrid appelée my_dg :
    my_dg.dataProvider = [{guitar:"Flying V", name:"maggot"}, {guitar:"SG", name:"dreschie"}, {guitar:"jagstang", name:"vitapup"}];
    
    
  • Utilisez DataGrid.columnNames pour créer les noms des champs d'éléments souhaités et générer des objets DataGridColumn, dans l'ordre, pour chaque champ répertorié.
    Cette approche vous permet de sélectionner et de classer rapidement les colonnes, en faisant appel à un minimum de paramètres de configuration. Elle supprime toute information précédente liée à la colonne. Par exemple, pour une occurrence du composant DataGrid appelée my_dg :
    my_dg.columnNames = ["guitar","name"];
    
    
  • Précréez les objets DataGridColumn et ajoutez-les à la grille de données en utilisant DataGrid.addColumn(). Cette approche est très pratique, car elle permet d'ajouter des colonnes de taille et de format adéquats alors qu'elles ne se trouvent pas encore dans la grille (le processeur est moins sollicité). Pour plus d'informations, voir Constructeur de la classe DataGridColumn. Par exemple, pour une occurrence du composant DataGrid appelée my_dg :
    // Création d'un objet de colonne.
    var location_dgc:DataGridColumn = new DataGridColumn("Location");
    location_dgc.width = 100;
    // Ajout de la colonne au composant DataGrid.
    my_dg.addColumn(location_dgc);
    
    

Propriétés de la classe DataGridColumn

Le tableau suivant présente les propriétés de la classe DataGridColumn.

Propriété

Description

DataGridColumn.cellRenderer

Identifiant de liaison d'un symbole à utiliser pour afficher les cellules dans cette colonne.

DataGridColumn.columnName

Lecture seule ; nom du champ associé à la colonne.

DataGridColumn.editable

Une valeur booléenne indiquant si une colonne est modifiable (true) ou non (false).

DataGridColumn.headerRenderer

Nom de la classe à utiliser pour afficher l'en-tête de cette colonne.

DataGridColumn.headerText

Texte de l'en-tête de cette colonne.

DataGridColumn.labelFunction

Fonction qui détermine le champ d'un élément à afficher.

DataGridColumn.resizable

Une valeur booléenne indiquant si une colonne peut être redimensionnée (true) ou non (false).

DataGridColumn.sortable

Une valeur booléenne indiquant si une colonne peut être triée (true) ou non (false).

DataGridColumn.sortOnHeaderRelease

Valeur booléenne indiquant si une colonne peut être triée (true) ou non (false) lorsque l'utilisateur clique sur son en-tête.

DataGridColumn.width

Largeur d'une colonne, en pixels.