spark.components.gridClassesGridColumn La classe GridColumn définit une colonne d’un contrôle de grille Spark, tel que le contrôle Spark DataGrid ou Grid.The <s:GridColumn> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GridColumn
    Properties
    dataField="null"
    dataTipField="null"
    dataTipFormatter="null"
    dataTipFunction="null"
    editable="true"
    formatter="null"
    headerRenderer="null"
    headerText="value of dataField"
    imeMode="null"
    itemEditor="null"
    itemRenderer="null"
    itemRendererFunction="null"
    labelFunction="null"
    maxWidth="NaN"
    minWidth="20"
    rendererIsEditable="false"
    resizeable="true"
    showDataTips="undefined"
    sortable="true"
    sortCompareFunction="null"
    sortDescending="false"
    visible="true"
    width="NaN"
  />
]]>flash.events:EventDispatcher La classe GridColumn définit une colonne d’un contrôle de grille Spark, tel que le contrôle Spark DataGrid ou Grid. Chaque élément de fournisseur de données pour le contrôle correspond à une rangée de la grille. La classe GridColumn spécifie le champ de l’élément de fournisseur de données dont la valeur doit être affichée dans la colonne. Elle indique également le rendu d’élément utilisé pour afficher cette valeur, l’éditeur d’élément utilisé pour modifier la valeur, et d’autres propriétés de la colonne. spark.components.Gridspark.components.DataGridGridColumn Constructeur.columnNamenullValeur initiale des propriétés dataField et headerText. Constructeur. itemToDataTip Convertissez l'élément de fournisseur de données spécifié en chaîne datatip spécifique à une colonne.Chaîne spécifique à une colonne pour l’élément de fournisseur de données spécifié ou ERROR_TEXT. itemLa valeur de grid.dataProvider.getItemAt(rowIndex). Convertissez l'élément de fournisseur de données spécifié en chaîne datatip spécifique à une colonne.

Cette méthode utilise les valeurs dataTipField et dataTipFunction. Si ces propriétés ont la valeur null, elle utilise les propriétés correspondantes à partir du contrôle de grille associé. Si les propriétés dataTipField ont également la valeur null dans le contrôle de grille, utilisez la propriété dataField.

Si dataTipFunction et dataTipFormatter sont null, cette méthode sa valeur est identique à : élément[dataTipField].toString(). Si dataTipFormatter est spécifié, cette méthode sa valeur est identique à : dataTipFormatter.format(élément[dataTipField]) si la résolution des l'élément dataField entraîne le renvoi d'une erreur, ERROR_TEXT est renvoyé.

Si item et dataTipFunction n’ont pas la valeur null, cette méthode renvoie dataTipFunction(item,this), où le second argument est cette classe GridColumn.

itemToLabel Convertissez l’élément de fournisseur de données spécifié en chaîne spécifique à une colonne.Une chaîne spécifique à une colonne pour l'élément dataProvider spécifié ou ERROR_TEXT. itemLa valeur de grid.dataProvider.getItemAt(rowIndex). Convertissez l’élément de fournisseur de données spécifié en chaîne spécifique à une colonne. Cette méthode est utilisée pour initialiser la propriété label des rendus d’élément.

Si labelFunction a la valeur null et que la propriété dataField est une chaîne qui ne contient pas de caractères "." Nom du champ caractères de séparation et formateur est null, cette méthode équivaut à la suivante :

item[dataField].toString()

Si l'outil de formatage a été spécifiée, cette méthode sa valeur est :

formatter.format(item[dataField])

Si la propriété dataField est un chemin "." séparé, cette méthode recherche chaque élément de chemin successif. Par exemple, si ="foo.bar.baz", cette méthode renvoie une chaîne basée sur la valeur de item.foo.bar.baz. Si la résolution de la propriété dataField de l’élément génère une erreur, ERROR_TEXT est renvoyé.

Si item et labelFunction n’ont pas la valeur null, cette méthode renvoie labelFunction(item, this), où le second argument est cette classe GridColumn.

itemToRenderer Convertissez l’élément de fournisseur de données spécifié en fabrique de rendu d’élément spécifique à une colonne.Une fabrique d'option de rendu d'élément spécifique à une colonne pour l'élément dataProvider spécifié. itemLa valeur de grid.dataProvider.getItemAt(rowIndex). Convertissez l'élément de fournisseur de données spécifié en fabrique de rendu d'élément spécifique à une colonne. Par défaut, cette méthode appelle itemRendererFunction si cette fonction n’est pas null, et dans le cas contraire elle renvoie simplement la valeur de la propriété itemRenderer de la colonne. ERROR_TEXT La valeur de retour de la méthode itemToLabel() ou itemToDataTip() en cas d’échec de la résolution du nom (chemin) de la propriété correspondante.unknown La valeur de retour de la méthode itemToLabel() ou itemToDataTip() en cas d’échec de la résolution du nom (chemin) de la propriété correspondante. La valeur de cette constante est une chaîne composée d’un espace unique : " ". itemToLabelitemToDataTipcolumnIndex La position de cette colonne dans la liste des colonnes de la grille, ou -1 si la grille de cette colonne est null. La position de cette colonne dans la liste des colonnes de la grille, ou -1 si la grille de cette colonne est null. dataField Nom du champ ou de la propriété de l’élément de fournisseur de données associé à la colonne.null Nom du champ ou de la propriété de l’élément de fournisseur de données associé à la colonne. Chaque GridColumn nécessite que cette propriété ou la propriété labelFunction soit définie afin de calculer le texte affichable pour le rendu d’élément. Si les propriétés dataField et labelFunction sont définies, les données s’affichent à l’aide de la propriété labelFunction et sont triées à l’aide de la propriété dataField.

La valeur de cette propriété n’est pas nécessairement la chaîne qui est affichée dans l’en-tête de colonne. Cette propriété est utilisée uniquement pour accéder aux données dans le fournisseur de données. Pour plus d’informations, voir la propriété headerText.

Si la colonne ou sa grille spécifie une propriété labelFunction, la propriété dataField n’est pas utilisée.

itemToLabellabelFunctiondataTipField Nom du champ dans le fournisseur de données à afficher comme astuce sur les données.null Nom du champ dans le fournisseur de données à afficher comme astuce sur les données. Par défaut, si showDataTips a la valeur true, le contrôle de grille associé recherche une propriété appelée label sur chaque élément de fournisseur de données et l’affiche. Toutefois, si le fournisseur de données ne contient pas de propriété label, vous pouvez définir la propriété dataTipField pour qu’elle spécifie un autre nom de propriété. Par exemple, vous pouvez définir la valeur sur « FullName » lorsqu’un utilisateur affiche un ensemble de noms de personnes incluses dans une base de données.

GridColumn.dataTipField est prioritaire par rapport à cette propriété.

Si cette colonne ou sa grille spécifie une valeur pour la propriété dataTipFunction, la propriété dataTipField est ignorée.

dataTipFunctionitemToDataTipdataTipFormatter Spécifie l’outil de formatage utilisé par la méthode itemToDataTip() de la colonne pour convertir les éléments de fournisseur de données en chaînes.null Spécifie l’outil de formatage utilisé par la méthode itemToDataTip() de la colonne pour convertir les éléments de fournisseur de données en chaînes.

Si l'élément styleParent de l'outil de formatage n'a pas été spécifié, il est défini sur la grille de la colonne, de sorte que l'outil de formatage hérite du style locale de la grille.

itemToDataTipoutil de formatagedataTipFunction Indique une fonction de rappel à exécuter sur chaque élément du fournisseur de données afin d’en déterminer les astuces sur les données.null Indique une fonction de rappel à exécuter sur chaque élément du fournisseur de données afin d’en déterminer les astuces sur les données. Cette propriété est utilisée par la méthode itemToDataTip.

Par défaut, si showDataTips a la valeur true, la colonne recherche une propriété nommée label sur chaque élément de fournisseur de données et l’affiche comme son astuce de données. Toutefois, certains fournisseurs de données n’ont pas de propriété label ni aucune autre propriété que vous pouvez utiliser pour afficher les données dans les rangées.

Par exemple, vous disposez d’un fournisseur de données contenant les champs lastName et firstName, mais vous souhaitez afficher les noms complets en tant qu’astuce de données. Vous pouvez spécifier une fonction pour la propriété dataTipFunction qui renvoie une seule chaîne contenant la valeur des deux champs. Vous pouvez également utiliser la propriété dataTipFunction pour gérer la mise en forme et la localisation.

La signature de la fonction dataTipFunction doit correspondre à la suivante : 

dataTipFunction(item:Object, column:GridColumn):String
Le paramètre item est l’élément de fournisseur de données d’une rangée entière. Le second paramètre est cet objet de colonne.

Une fonction standard peut concaténer les propriétés firstName et lastName d’un élément ou personnaliser la mise en forme d’une propriété de valeur de date.

itemToDataTipdataTipFieldeditable Indique si les éléments de la colonne peuvent être modifiés. true Indique si les éléments de la colonne peuvent être modifiés. Si la valeur est true et si la propriété editable de la grille associée a également la valeur true, les éléments d’une colonne sont modifiables et peuvent être modifiés individuellement en cliquant sur un élément sélectionné ou en naviguant jusqu’à lui et en appuyant sur la touche F2. formatter Spécifie l’outil de formatage utilisé par la méthode itemToLabel() de la colonne pour convertir les éléments de fournisseur de données en chaînes.null Spécifie l’outil de formatage utilisé par la méthode itemToLabel() de la colonne pour convertir les éléments de fournisseur de données en chaînes.

Si l'élément styleParent de l'outil de formatage n'a pas été spécifié, il est défini sur la grille de la colonne, de sorte que l'outil de formatage hérite du style locale de la grille.

itemToLabelDatatipformattergrid L’objet Grid associé à cette colonne.spark.components:Grid L’objet Grid associé à cette colonne. headerRenderer Fabrique de classe de la classe IGridItemRenderer utilisée comme en-tête de cette colonne.null Fabrique de classe de la classe IGridItemRenderer utilisée comme en-tête de cette colonne. Si elle n’est pas spécifiée, la partie d’habillage columnHeaderGroup du contrôle DataGrid définit le rendu d’en-tête par défaut. headerTextIGridItemRendererheaderText Texte de l’en-tête de cette colonne. Texte de l’en-tête de cette colonne. Par défaut, le contrôle de grille associé utilise la valeur de la propriété dataField en tant que texte d’en-tête. imeMode null flash.system.IMEConversionModeitemEditor Fabrique de classe pour la classe IGridItemEditor utilisée pour modifier les cellules de grille individuelles dans cette colonne.null Fabrique de classe pour la classe IGridItemEditor utilisée pour modifier les cellules de grille individuelles dans cette colonne. Si la valeur de cette propriété est null et que le propriétaire de la grille de colonne est un contrôle DataGrid, la valeur de la propriété itemEditor du contrôle DataGrid est utilisée. Si aucun éditeur d’élément n’est spécifié par le contrôle DataGrid, utilisez la classe DefaultGridItemEditor.

L’éditeur d’élément par défaut est la classe DefaultGridItemEditor, qui vous permet de modifier un champ de texte simple. Vous pouvez créer des rendus d’élément personnalisés en créant une sous-classe de la classe GridItemEditor. Votre éditeur d’élément personnalisé peut écrire des données dans la rangée entière de la grille pour définir un éditeur plus complexe.

spark.components.gridClasses.DefaultGridItemEditorspark.components.gridClasses.GridItemEditoritemRendererFunction Si elle est spécifiée, la valeur de cette propriété doit être une fonction idempotent qui renvoie un rendu d’élément IFactory en fonction de ses paramètres de colonne et d’élément de fournisseur de données.null Si elle est spécifiée, la valeur de cette propriété doit être une fonction idempotent qui renvoie un rendu d’élément IFactory en fonction de ses paramètres de colonne et d’élément de fournisseur de données. La spécification d’une valeur pour la propriété itemRendererFunction permet d’utiliser plusieurs rendus d’élément dans cette colonne.

La fonction spécifiée pour la propriété itemRendererFunction doit présenter la signature suivante :

itemRendererFunction(item:Object, column:GridColumn):IFactory

Le paramètre item est l’élément de fournisseur de données d’une rangée entière. Le second paramètre est cet objet de colonne.

Vous trouverez ci-dessous un exemple de fonction de rendu d’élément :

      function myItemRendererFunction(item:Object, column:GridColumn):IFactory
      {
          return (item is Array) ? myArrayItemRenderer : myItemRenderer;
      }
itemRenderer Fabrique de classe de la classe IGridItemRenderer utilisée pour effectuer le rendu des cellules de grille individuelles. Fabrique de classe de la classe IGridItemRenderer utilisée pour effectuer le rendu des cellules de grille individuelles. Si elle n’est pas spécifiée, utilisez la valeur de la propriété itemRenderer issue du contrôle de grille associé.

Le rendu d’élément par défaut est la classe AdvancedDataGridItemRenderer, qui affiche l’élément de données sous forme de texte. Vous pouvez créer des rendus d’élément personnalisés en créant une sous-classe de la classe GridItemRenderer. Votre rendu d’élément personnalisé peut accéder aux données de la rangée entière de la grille pour définir une représentation visuelle plus complexe de la cellule.

La valeur par défaut est la valeur de la propriété itemRenderer issue du contrôle de grille associé, ou null.

dataFieldspark.skins.spark.DefaultGridItemRendererspark.components.gridClasses.GridItemRendererlabelFunction Fonction idempotent qui convertit un élément de fournisseur de données en chaîne spécifique à une colonne qui permet d’initialiser la propriété label du rendu d’élément.null Fonction idempotent qui convertit un élément de fournisseur de données en chaîne spécifique à une colonne qui permet d’initialiser la propriété label du rendu d’élément.

Vous pouvez utiliser une fonction d’étiquette pour combiner les valeurs de plusieurs éléments fournisseurs de données en une chaîne unique. Si elle est spécifiée, cette propriété est utilisée par la méthode itemToLabel(), qui calcule la valeur de la propriété label de chaque rendu d’élément dans cette colonne.

La fonction spécifiée pour la propriété labelFunction doit présenter la signature suivante :

labelFunction(item:Object, column:GridColumn):String

Le paramètre item est l’élément de fournisseur de données d’une rangée entière. Le second paramètre est cet objet de colonne.

Une fonction standard peut concaténer les propriétés firstName et lastName de l’élément de fournisseur de données ou personnaliser la mise en forme d’une propriété de valeur de date.

itemToLabeldataFieldmaxWidth La largeur maximale de cette colonne en pixels.NaN La largeur maximale de cette colonne en pixels. Si elle est spécifiée, la présentation de la grille spécifie comme largeur de la présentation de la colonne la plus petite valeur entre typicalItem et maxWidth. Si cette colonne est redimensionnable, cette propriété limite la largeur que l’utilisateur peut donner à la colonne. La définition de cette propriété ne change pas les propriétés width ni minWidth. minWidth La largeur minimale de cette colonne en pixels.20 La largeur minimale de cette colonne en pixels. Si elle est spécifiée, la présentation de la grille spécifie comme largeur de la présentation de la colonne la plus grande valeur entre typicalItem et minWidth. Si cette colonne est redimensionnable, cette propriété limite la grandeur que l’utilisateur peut donner à la colonne. La définition de cette propriété ne change pas les propriétés width ni maxWidth. rendererIsEditable Détermine si des contrôles du rendu d’élément sont modifiables.false Détermine si des contrôles du rendu d’élément sont modifiables. Si la colonne est modifiable, les contrôles pouvant recevoir le focus dans le rendu d’élément reçoivent le focus clavier lorsque l’utilisateur commence à modifier le rendu d’élément.

Lorsque vous définissez cette propriété sur true, la cellule devient modifiable quand l’utilisateur clique à l’intérieur de cette dernière. Etant donné que la cellule est modifiable, le composant DataGrid affiche la partie d’habillageeditorIndicator en haut de la partie d’habillageselectionIndicator. Par conséquent, l’utilisateur ne voit pas l’indicateur de sélection de la cellule jusqu’à ce que la session de modification soit terminée. Vous pouvez créer un habillage personnalisé pour supprimer ou modifier la partie d’habillage editorIndicator, de sorte que la partie d’habillage selectionIndicator s’affiche. Par exemple, vous pouvez définir la propriété alpha deeditorIndicator de sorte que selectionIndicator transparaisse, ou modifier la taille de editorIndicator pour qu’il soit plus petit que la cellule.

En définissant cette propriété sur true, vous assumez la responsabilité de la validation et de l’enregistrement de l’entrée recueillie par le rendu d’élément. Si le rendu d’élément contient un remplacement de la méthode IGridItemRenderer.prepare(), vous devez vous assurer que les modifications du champ d’entrée non enregistrées ne sont pas remplacées. Par exemple, rendererIsEditable a la valeur true et le rendu contient un élément TextInput unique qui affiche la valeur de data.myDataField. Si la méthode prepare() du rendu définit la propriété text du contrôle TextInput, la méthode prepare() ne doit pas définir la propriété text lorsqu’il existe des modifications en attente.

resizable Indique si l’utilisateur est autorisé à redimensionner la largeur de la colonne.true Indique si l’utilisateur est autorisé à redimensionner la largeur de la colonne. Si la valeur est true et que la propriété resizableColumns de la grille associée a également la valeur true, l’utilisateur peut faire glisser les rangées de la grille entre les en-têtes des colonnes pour redimensionner la colonne. showDataTips Indique si les astuces sur les données sont affichées dans la colonne. undefined Indique si les astuces sur les données sont affichées dans la colonne. Si la valeur est true, les astuces sur les données s’affichent pour le texte des rangées. Les astuces sur les données sont des infos-bulles conçues pour afficher le texte qui est trop long pour la rangée.

Si la valeur de cette propriété n’est pas définie (configuration par défaut), la propriété showDataTips de la grille associée détermine si les astuces sur les données sont affichées. Si cette propriété est définie, la propriété showDataTips de la grille est ignorée.

getShowDataTipssortCompareFunction La fonction qui compare deux éléments lors d’un tri sur les éléments de données de cette colonne.null La fonction qui compare deux éléments lors d’un tri sur les éléments de données de cette colonne. Si vous spécifiez une valeur pour la propriété labelFunction, en règle générale, vous fournissez également une propriété sortCompareFunction.

La signature de la propriété sortCompareFunction doit correspondre aux éléments suivants :

sortCompareFunction(obj1:Object, obj2:Object, column:GridColumn):int

La fonction doit renvoyer une valeur basée sur la comparaison des objets :

  • -1 si obj1 doit apparaître avant obj2 par ordre croissant.
  • 0 si obj1 = obj2.
  • 1 si obj1 doit apparaître après obj2 par ordre croissant.

La fonction peut utiliser le paramètre de colonne pour écrire des fonctions de comparaison génériques.

Remarque : les paramètres obj1 et obj2 sont des éléments entiers du fournisseur de données et pas uniquement les données de l’élément.

Si l’objet dataProvider n’est pas un objet ICollectionView, cette propriété n’a aucun effet.

sortDescending Si la valeur est true, cette colonne est triée dans l’ordre décroissant.false Si la valeur est true, cette colonne est triée dans l’ordre décroissant. Par exemple, si la propriété dataField de la colonne contient une valeur numérique, la première rangée serait celle dotée de la plus grande valeur pour cette colonne.

La définition de cette propriété ne permet pas de lancer un tri, mais seulement de définir le sens du tri. Lorsque la méthode dataProvider.refresh() est appelée, le tri est réalisé.

Si le fournisseur de données n’est pas un objet ICollectionView, cette propriété n’a aucun effet.

sortField Renvoie un objet SortField qui peut être utilisé pour trier une collection par la propriété dataField de cette colonne.spark.collections:SortField Renvoie un objet SortField qui peut être utilisé pour trier une collection par la propriété dataField de cette colonne.

Si la propriété sortCompareFunction est définie, alors la propriété compareFunction de SortField est automatiquement définie.

Si la propriété propriété sortCompareFunction n’est pas définie et que la propriété dataField est complexe, la fonction de comparaison SortField est affectée à une fermeture autour d’une fonction de comparaison par défaut qui gère la propriété dataField complexe.

Si les propriétés sortCompareFunction et dataField ne sont pas définies, mais que la propriété labelFunction est définie, elle affecte compareFunction à une fermeture qui effectue une comparaison de chaîne de base sur la propriété labelFunction appliquée aux objets de données.

spark.collections.SortFieldsortable Si la valeur est true et si le fournisseur de données de la grille est un objet ICollectionView, et si la propriété sortableColumns de la grille associée a la valeur true, cette colonne prend en charge le tri interactif.true Si la valeur est true et si le fournisseur de données de la grille est un objet ICollectionView, et si la propriété sortableColumns de la grille associée a la valeur true, cette colonne prend en charge le tri interactif. En règle générale, l’en-tête de la colonne gère les clics de souris en définissant la propriété sort du fournisseur de données sur un objet Sort dont l’objet SortField est la propriété dataField de cette colonne.

Si le fournisseur de données n’est pas un objet ICollectionView, cette propriété n’a aucun effet.

visible Si la valeur est true, il convient d’afficher cette colonne.true Si la valeur est true, affichez cette colonne. Si la valeur est false, aucun espace ne sera alloué pour cette colonne. Elle ne sera pas incluse dans la présentation. width La largeur de cette colonne en pixels.NaN La largeur de cette colonne en pixels. Si elle est spécifiée, la présentation de la grille ignore sa propriété typicalItem et les propriétés minWidth et maxWidth de cette colonne. IGridVisualElement Cette interface fournit une méthode que les éléments visuels créés de façon dynamique peuvent utiliser pour se configurer eux-mêmes avant d’être affichés. Cette interface fournit une méthode que les éléments visuels créés de façon dynamique peuvent utiliser pour se configurer eux-mêmes avant d’être affichés. Elle est appelée en fonction des besoins, lorsqu’un élément visuel généré par fabrique est créé ou réutilisé. Cette méthode n’est pas destinée à être appelée directement.

Il s’agit d’une interface optionnelle pour l’ensemble des éléments visuels générés par fabrique, à l’exception des éléments de rendus itemRenderers : caretIndicator, hoverIndicator, editorIndicator, selectionIndicator, columnSeparator, rowSeparator, alternatingRowColorsBackground (voir la section DataGrid), sortIndicator (voir la section GridColumnHeaderGroup). Elle permet généralement de configurer les éléments visuels générés avec les valeurs de style de DataGrid. Par exemple, pour utiliser la valeur du style « symbolColor » de DataGrid pour la couleur de remplissage du signe d’insertion, il est possible de définir la méthode prepareGridVisualElement() comme suit :

  public function prepareGridVisualElement(grid:Grid, rowIndex:int, columnIndex:int):void
  {
      caretStroke.color = grid.dataGrid.getStyle("caretColor");
  }

Les paramètres rowIndex et columnIndex indiquent la cellule que l’élément visuel va occuper. Si columnIndex = -1, alors l’élément visuel occupe une rangée de grille. Si rowIndex = -1 alors l’élément visuel occupe une colonne de grille.

DataGridSkin.mxml comporte de nombreux autres exemples de ce type. Notez que les éléments visuels d’habillage DataGrid personnalisés peuvent choisir de ne pas implémenter cette interface si la flexibilité qu’elle apporte n’est pas nécessaire.

prepareGridVisualElement Cette méthode est appelée avant le rendu d’un élément visuel de la grille afin que l’élément puisse se configurer lui-même.gridspark.components:GridLa grille associée à cet élément visuel. rowIndexLa coordonnée de ligne de la cellule que l’élément visuel va occuper, ou -1 columnIndexLa coordonnée de colonne de la cellule que l’élément visuel va occuper, ou -1 Cette méthode est appelée avant le rendu d’un élément visuel de la grille afin que l’élément puisse se configurer lui-même. Les paramètres de la méthode indiquent la cellule, la ligne (si columnIndex = -1) ou la colonne (si rowIndex = -1) que l’élément visuel va occuper.

Si l’élément visuel est généré par une partie d’habillage DataGrid de type fabrique, comme selectionIndicator ou hoverIndicator, grille.dataGrid représente l’objet DataGrid pour lequel la grille est une partie d’habillage.

CellPosition La classe CellPosition définit une structure de données utilisée par les classes de grille de données Spark pour représenter des cellules sélectionnées dans le contrôle.Object La classe CellPosition définit une structure de données utilisée par les classes de grille de données Spark pour représenter des cellules sélectionnées dans le contrôle. Chaque cellule sélectionnée est représentée par une occurrence de cette classe. spark.components.DataGrid.selectedCellspark.components.DataGrid.selectedCellsspark.components.Grid.selectedCellspark.components.Grid.selectedCellsCellPosition Constructeur.rowIndex-1L'indice de ligne à base 0 de la cellule. La valeur -1 indique que la valeur n’est pas définie. columnIndex-1L'index de colonne de base 0 de la cellule. La valeur -1 indique que la valeur n’est pas définie. Constructeur. columnIndex L'indice de colonne à base 0 de la cellule.-1 L'index de colonne de base 0 de la cellule. La valeur -1 indique que la valeur n’est pas définie. rowIndex L'index de ligne en base 0 de la cellule.-1 L'indice de ligne à base 0 de la cellule. La valeur -1 indique que la valeur n’est pas définie. IDataGridElement Les éléments visuels du contrôle Spark DataGrid qui doivent rester synchronisés avec la présentation et la position de défilement de la grille doivent implémenter cette interface.mx.core:IVisualElementmx.managers:ILayoutManagerClientmx.core:IInvalidating Les éléments visuels du contrôle Spark DataGrid qui doivent rester synchronisés avec la présentation et la position de défilement de la grille doivent implémenter cette interface. Lorsque la partie d’habillage grid du contrôle DataGrid est ajoutée, elle définit la propriété IDataGridElement.dataGrid. L’objet IDataGridElements peut répondre en ajoutant des écouteurs d’événement pour les modifications de la position de défilement. Lorsque le contrôle DataGrid est modifié d’une manière qui affecte sa disposition de rangées ou de colonnes, tous les objets IDataGridElement sont invalidés. dataGrid Contrôle DataGrid associé à cet élément.spark.components:DataGrid Contrôle DataGrid associé à cet élément. DefaultGridItemEditorLa classe DefaultGridItemEditor définit le rendu d’élément par défaut utilisé par les contrôles de grille Spark, tels que DataGrid et Grid.spark.components.gridClasses:GridItemEditorLa classe DefaultGridItemEditor définit le rendu d’élément par défaut utilisé par les contrôles de grille Spark, tels que DataGrid et Grid. La classe DefaultGridItemEditor affiche un contrôle de zone de texte. Entrez la nouvelle valeur de la cellule dans l’éditeur de texte.

Au lieu d’utiliser la classe DefaultGridItemEditor, vous pouvez créer un éditeur d’élément personnalisé. L’éditeur d’élément doit implémenter l’interface spark.components.gridClasses.IGridItemEditor. En règle générale, vous créez un éditeur d’élément en tant que sous-classe de la classe spark.components.gridClasses.GridItemEditor.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.IGridItemEditorspark.components.gridClasses.GridItemEditorspark.components.gridClasses.GridColumnDefaultGridItemEditorConstructeur.Constructeur.textAreaLe composant TextArea de l’éditeur.spark.components:TextAreaLe composant TextArea de l’éditeur. GridSelectionMode La classe GridSelectionMode définit les valeurs constantes valides de la propriété selectionMode des contrôles Spark DataGrid et Grid.Object La classe GridSelectionMode définit les valeurs constantes valides de la propriété selectionMode des contrôles Spark DataGrid et Grid.

Utilisez les constantes dans ActionsScript, comme l’illustre l’exemple suivant : 

    myDG.selectionMode = GridSelectionMode.MULTIPLE_CELLS;

Dans MXML, utilisez la valeur de chaîne des constantes, comme l’illustre l’exemple suivant :

    <s:DataGrid id="myGrid" width="350" height="150"
        selectionMode="multipleCells"> 
        ...
    </s:DataGrid>
spark.components.DataGrid.selectionModespark.components.Grid.selectionModeGridSelectionMode Constructeur. Constructeur. MULTIPLE_CELLS Spécifie qu'une ou plusieurs cellules peuvent être sélectionnées.multipleCells Spécifie qu'une ou plusieurs cellules peuvent être sélectionnées. MULTIPLE_ROWS Spécifie qu'une ou plusieurs lignes peuvent être sélectionnées.multipleRows Spécifie qu'une ou plusieurs lignes peuvent être sélectionnées. NONE Spécifie qu’aucune sélection n’est autorisée.none Spécifie qu’aucune sélection n’est autorisée. SINGLE_CELL Spécifie qu'une cellule peut être sélectionnée.singleCell Spécifie qu'une cellule peut être sélectionnée. SINGLE_ROW Spécifie qu'une ligne peut être sélectionnée.singleRow Spécifie qu'une ligne peut être sélectionnée. CellRegion La classe CellRegion définit une structure de données utilisée par les classes de grille de données Spark pour représenter une région rectangulaire de cellules dans le contrôleObject La classe CellRegion définit une structure de données utilisée par les classes de grille de données Spark pour représenter une région rectangulaire de cellules dans le contrôle L’origine de la région est spécifiée par les propriétés rowIndex et columnIndex. L’étendue de la région est spécifiée par les propriétés rowCount et columnCount. spark.components.DataGridspark.components.GridCellRegion Constructeur.rowIndex-1L'indice de ligne à base 0 de la cellule d'origine. La valeur -1 indique que la valeur n’est pas définie. columnIndex-1L'index de rangée de base 0 de la cellule d'origine. La valeur -1 indique que la valeur n’est pas définie. rowCount0Le nombre de lignes de la région de cellules. columnCount0Le nombre de colonnes dans la région de cellules. Constructeur. columnCount Le nombre de colonnes dans la région de cellules.0 Le nombre de colonnes dans la région de cellules. columnIndex L'index de colonne à base 0 de l'origine de la région de cellules.-1 L'index de colonne à base 0 de l'origine de la région de cellules. La valeur -1 indique que la valeur n’est pas définie. rowCount Le nombre de lignes de la région de cellules.0 Le nombre de lignes de la région de cellules. rowIndex L'index de ligne à base 0 de l'origine de la région de cellules.-1 L'index de ligne à base 0 de l'origine de la région de cellules. La valeur -1 indique que la valeur n’est pas définie. GridLayer La classe GridLayer définit un conteneur utilisé pour les calques des éléments visuels du contrôle Grid.spark.components:Group La classe GridLayer définit un conteneur utilisé pour les calques des éléments visuels du contrôle Grid. Le contrôle Grid crée et ajoute des éléments visuels à ses calques selon les besoins et il est responsable de leur présentation. spark.components.GridGridLayer Constructeur. Constructeur. GridItemRenderer La classe GridItemRenderer définit la classe de base des rendus d’élément personnalisés pour les contrôles de grille Spark, tels que DataGrid et Grid.spark.components.gridClasses:IGridItemRendererspark.components:Group La classe GridItemRenderer définit la classe de base des rendus d’élément personnalisés pour les contrôles de grille Spark, tels que DataGrid et Grid. Les rendus d’élément sont requis uniquement pour afficher des aspects spécifiques aux colonnes de leurs données. Ils ne sont pas chargés d’afficher les indicateurs de sélection ou de survol, la couleur d’arrière-plan changeante (le cas échéant) ni les séparateurs de rangées ou de colonnes.

Les rendus d’élément sont associés à chaque colonne d’une grille. Définissez le rendu d’élément d’une colonne à l’aide de la propriété GridColumn.itemRenderer.

Par défaut, un rendu d'élément ne s'écrête pas aux limites de la cellule. Si votre rendu s'étend au-delà des limites de la cellule, vous pouvez définir la valeur clipAndEnableScrolling sur true pour écrêter le rendu aux limites de la cellule.

Les transitions dans les rendus d’éléments DataGrid ne sont pas prises en charge. La classe GridItemRenderer ayant désactivé sa propriété transitions, le fait de la définir n’aura aucun effet.

Considérations d’efficacité

Les performances de défilement et de démarrage des composants DataGrid sont directement liées à la complexité du rendu d’élément et au nombre de rendus d’élément visibles au sein du défilement DataGrid. Les occurrences GridItemRenderer personnalisées sont utilisées et réutilisées à plusieurs reprises. Il est donc important de les définir de la manière la plus simple et la plus efficace possible.

Si la responsabilité d’un rendu d’élément est limitée à l’affichage d’une ou plusieurs lignes de texte, les développeurs doivent envisager d’utiliser la classe DefaultItemRenderer, très économique pour cette opération (pour une application à déployer uniquement sur Windows, vous pouvez obtenir des performances supplémentaires en utilisant plutôt la classe UITextFieldGridItemRenderer). La manière la plus efficace d’utiliser GridItemRenderer pour afficher l’élément dataField du composant GridColumn sous forme de texte consiste à identifier l’élément d’affichage de texte du composant GridItemRenderer avec id="labelDisplay". Le composant labelDisplay doit être une sous-classe de TextBase comme Label ou RichText. Vous pouvez suivre cette approche, au lieu d’utiliser simplement DefaultGridItemRenderer, si votre rendu d’élément comprend certains éléments supplémentaires qui ne dépendent pas des données du rendu d’élément, tels que les bordures ou d’autres éléments graphiques.

Un rendu d’élément contenant plusieurs éléments visuels dont les propriétés dépendent des données du rendu d’élément peut utiliser la liaison de données pour définir les valeurs de ces propriétés. Cette approche fournit du code MXML simple à lire et à entretenir et ses performances peuvent être suffisantes si le nombre de rendus d’élément visibles est limité (voir les propriétés requestedRowCount et requestedColumnCount du composant DataGrid). Le moyen le plus efficace pour configurer ce type de rendu d’élément consiste à remplacer sa méthode prepare() et à effectuer le travail à cet endroit. La méthode prepare() du rendu est appelée à chaque fois que le rendu est réaffiché et doit par conséquent être codée efficacement. Si votre rendu d’élément est avec état, par exemple s’il met en cache les valeurs internes, vous pouvez effacer son état dans sa méthode discard(). La méthode discard() est appelée à chaque fois que le rendu est déplacé vers la liste libre interne du composant DataGrid, où il reste disponible pour la réutilisation.

Les rendus GridItemRenderer doivent être aussi simples que possible. Pour obtenir les meilleures performances possibles, réduisez le nombre de composants et la profondeur de la hiérarchie. Si cela s’avère pratique, utilisez des positions et des tailles explicites plutôt que des contraintes pour définir la présentation. Les éléments DataGrid avec variableRowHeight="false" (par défaut) tendent à donner de meilleurs résultats, tout comme pour showDataTips="false" (par défaut) et clipAndEnableScrolling="false" (par défaut).

Des exemples concernant les différentes configurations GridItemRenderer décrites ici sont disponibles dans la section des exemples.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnspark.components.gridClasses.GridColumn.itemRendererspark.skins.spark.DefaultGridItemRendererdataChange Distribué lorsque la propriété data change.mx.events.FlexEvent.DATA_CHANGEmx.events.FlexEvent Distribué lorsque la propriété data change. GridItemRenderer Constructeur. Constructeur. discard Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible.willBeRecycledtrue si ce rendu est destiné à être ajouté à la liste libre interne du propriétaire en vue d’être réutilisé. Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible. Si le paramètre willBeRecycled a la valeur true, le propriétaire ajoute ce rendu à sa liste libre interne en vue de le réutiliser. Les implémentations peuvent utiliser cette méthode pour effacer toute propriété de rendu qui n’est plus nécessaire.

Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l'implémentation DataGrid.

getCurrentRendererState Renvoie le nom de l’état à appliquer au rendu.Chaîne spécifiant le nom de l’état à appliquer au rendu. Renvoie le nom de l’état à appliquer au rendu. Par exemple, un rendu d’élément élémentaire renvoie la chaîne "normal", "hovered" ou "selected" pour spécifier l’état du rendu. Dans le cas d’interactions tactiles (ou d’interactions de souris dans lesquelles la sélection est ignorée), les états "down" et "downAndSelected" peuvent également être renvoyés.

Une sous-classe de GridItemRenderer doit remplacer cette méthode pour renvoyer une valeur si le comportement souhaité est différent du comportement par défaut.

Dans Flex 4.0, les 3 états principaux étaient "normal", "hovered" et "selected". Dans Flex 4.5, "down" et "downAndSelected" ont été ajoutés.

L’ensemble complet des états pris en charge (par ordre de priorité) est le suivant :

  • dragging
  • downAndSelected
  • selectedAndShowsCaret
  • hoveredAndShowsCaret
  • normalAndShowsCaret
  • down
  • selected
  • hovered
  • normal

prepare Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies.hasBeenRecycled true si ce rendu est réutilisé. Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies. Le paramètre hasBeenRecycled a la valeur false si ce rendu n’a pas été utilisé avant, ce qui signifie qu’il n’a pas été recyclé. Cette méthode est appelée lorsqu’un rendu est sur le point de devenir visible et chaque fois qu’il est réaffiché en raison d’une modification d’une propriété du rendu ou du fait qu’un réaffichage a été explicitement demandé.

Cette méthode peut être utilisée pour configurer tous les éléments visuels et les propriétés d’un rendu. L'utilisation de cette méthode peut être plus efficace que la liaison des propriétés data des propriétés aux propriétés d'élément visuel. Remarque : puisque la méthode prepare() est appelée fréquemment, assurez-vous qu’elle est codée de manière efficace.

La méthode prepare() peut être appelée à de nombreuses reprises avant que la méthode discard() soit appelée.

Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l'implémentation DataGrid.

columnIndex L’index de colonne de la cellule de ce rendu d’élément. L’index de colonne de la cellule de ce rendu d’élément. Il s’agit de la même valeur que column.columnIndex. column L’objet GridColumn représentant la colonne associée à ce rendu d’élément.spark.components.gridClasses:GridColumnnull Objet GridColumn représentant la colonne associée à ce rendu d’élément. data La valeur de l’élément de fournisseur de données pour la rangée de la grille correspondant au rendu d’élément.null La valeur de l’élément de fournisseur de données pour la rangée de la grille correspondant au rendu d’élément. Cette valeur correspond à l’objet renvoyé par un appel à la méthode dataProvider.getItemAt(rowIndex).

Les rendus d’élément peuvent remplacer cette définition de propriété pour accéder aux données de la rangée entière de la grille.

down Cette propriété est définie sur true lorsque l’un de deux gestes d’entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l’écran tactile est activé.false Cette propriété est définie sur true lorsque l'un de deux gestes d'entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l'écran tactile est activé. La propriété down est réinitialisée sur false lorsque le bouton de la souris est relâché, l’utilisateur libère l’écran tactile ou le curseur/toucher est déplacé hors de la cellule de la grille.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille ne possèdent pas la responsabilité exclusive de l'affichage de l'indicateur vers le bas. La grille elle-même effectue le rendu de l'indicateur vers le bas pour la ligne ou la cellule sélectionnée. Le rendu d’élément peut également modifier ses propriétés visuelles pour mettre en évidence qu’il est actuellement sélectionné.

dragging Contient la valeur true si le rendu d'élément est en cours de glissement, généralement dans le cadre d'une opération glisser-déposer. Contient la valeur true si le rendu d'élément est en cours de glissement, généralement dans le cadre d'une opération glisser-déposer. Actuellement, le glisser-déposer n’est pas pris en charge par le contrôle Spark DataGrid. grid Renvoie le contrôle Grid associé à ce rendu d’élément.spark.components:Grid Renvoie le contrôle Grid associé à ce rendu d’élément. Il s’agit de la même valeur que column.grid. hovered Contient true si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL ou GridSelectionMode.MULTIPLE_CELLS, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW ou GridSelectionMode.MULTIPLE_ROWS.false Contient true si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL ou GridSelectionMode.MULTIPLE_CELLS, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW ou GridSelectionMode.MULTIPLE_ROWS.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant que le rendu ou sa ligne sont situés sous la souris. La grille elle-même affiche automatiquement la partie d'habillage hoverIndicator pour la ligne ou la cellule survolée. Les rendus d'élément de grille peuvent également modifier leurs propriétés pour mettre en évidence qu'ils sont survolés.

labelDisplay Composant visuel facultatif dans le rendu d’élément pour l’affichage de la propriété label.spark.components.supportClasses:TextBasenull Composant visuel facultatif dans le rendu d’élément pour l’affichage de la propriété label. Si vous utilisez cette propriété pour spécifier un composant visuel, la propriété text du composant est maintenue synchronisée avec la propriété label du rendu d’élément. label "" rowIndex L’index à base zéro de la ligne de la cellule faisant l’objet du rendu.-1 L’index de base zéro de la rangée de la cellule faisant l’objet du rendu. selected Contient la valeur true si la cellule du rendu d'élément fait partie de la sélection en cours.false Contient la valeur true si la cellule du rendu d'élément fait partie de la sélection en cours.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant qu'ils font partie de la sélection. La grille elle-même affiche automatiquement la partie d'habillage selectionIndicator pour les lignes ou les cellules sélectionnées. Le rendu d'élément peut également modifier ses propriétés visuelles pour souligner qu'elle fait partie de la sélection.

showsCaret Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret.false Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant que leur cellule ou ligne a le signe d'insertion. La grille elle-même affiche automatiquement la partie d'habillage caretIndicator pour la ligne ou la cellule du signe d'insertion. Le rendu d'élément peut également modifier ses propriétés visuelles pour mettre en évidence qu'il a le signe d'insertion.

IGridItemEditor L’interface IGridItemEditor définit l’interface que les éditeurs d’élément pour les contrôles Spark DataGrid et Spark Grid doivent implémenter.mx.core:IDataRenderermx.core:IVisualElementmx.managers:IFocusManagerComponentmx.core:IIMESupport L’interface IGridItemEditor définit l’interface que les éditeurs d’élément pour les contrôles Spark DataGrid et Spark Grid doivent implémenter. Les contrôles DataGrid et Grid sont appelés propriétaire du rendu d’élément ou composant hôte de l’éditeur d’élément.

Toutes les propriétés de l’éditeur d’élément sont définies par le propriétaire au début de la session de l’éditeur. La propriété data est la dernière propriété définie. Lorsque la propriété data est définie, un éditeur d’élément doit définir la valeur des contrôles de l’éditeur. Ensuite, la méthode prepare() de l’éditeur est appelée. Les implémentations de l’interface IGridItemEditor doivent remplacer la méthode prepare() pour effectuer d’éventuels ajustements finaux de ses propriétés ou de tout aspect de ses éléments visuels. Lors de la fermeture de l’éditeur, la méthode discard() est appelée.

Lorsque l’éditeur est fermé, la valeur d’entrée peut être enregistrée ou annulée. En cas d’enregistrement, la fonction save() est appelée par l’éditeur pour écrire les nouvelles valeurs dans l’élément de fournisseur de données correspondant à la rangée de la cellule modifiée.

spark.components.DataGridspark.components.Griddiscard Appelée juste avant que l’éditeur soit fermé. Appelée juste avant que l’éditeur soit fermé. Utilisez cette méthode pour effectuer tout nettoyage final, tel que le nettoyage de tout ce qui a été défini dans la méthode prepare().

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément.

prepare Appelée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible. Appelée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible. Utilisez cette méthode pour ajuster l’aspect de l’éditeur, ajouter des écouteurs d’événement ou effectuer toute autre initialisation avant qu’il ne devienne visible.

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément.

save Enregistre la valeur dans l’éditeur vers le fournisseur de données du propriétaire du rendu d’élément.true si l’opération d’enregistrement a réussi et false dans le cas contraire. Enregistre la valeur dans l’éditeur vers le fournisseur de données du propriétaire du rendu d’élément. Cette méthode met à jour l’élément de fournisseur de données correspondant à la rangée de la cellule modifiée. Cette fonction appelle GridItemEditor.validate() pour vérifier que les données peuvent être enregistrées. Si les données ne sont pas valides, les données ne sont pas enregistrées et l’éditeur n’est pas fermé.

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément. Pour enregistrer et fermer l’éditeur, appelez la méthode endItemEditorSession() du propriétaire du rendu d’élément.

spark.components.DataGridcolumnIndex L’index de base zéro de la colonne en cours de modification. L’index de base zéro de la colonne en cours de modification. column La colonne de la cellule en cours de modification.spark.components.gridClasses:GridColumn La colonne de la cellule en cours de modification. dataGrid Le contrôle qui est propriétaire de cet éditeur d’élément.spark.components:DataGrid Le contrôle qui est propriétaire de cet éditeur d’élément. rowIndex L’index de base zéro de la rangée de la cellule en cours de modification. L’index de base zéro de la rangée de la cellule en cours de modification. GridItemEditor La classe GridItemEditor définit la classe de base des éditeurs d’élément personnalisés pour les contrôles de grille Spark, tels que DataGrid et Grid.The <s:GridItemEditor> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GridItemEditor
    Properties
    column="null"
    data="null"
    imeMode="null"
    itemRenderer="null"
    rowIndex="0"
    value="null"
  />
]]>spark.components.gridClasses:IGridItemEditorspark.components:Group La classe GridItemEditor définit la classe de base des éditeurs d’élément personnalisés pour les contrôles de grille Spark, tels que DataGrid et Grid. Les éditeurs d’élément vous permettent de modifier la valeur de la cellule de la grille, puis d’enregistrer cette valeur dans le fournisseur de données du contrôle.

Les éditeurs d’élément sont associés à chaque colonne d’une grille. Définissez l’éditeur d’élément d’une colonne à l’aide de la propriété GridColumn.itemEditor.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnspark.components.gridClasses.GridColumn.itemEditorGridItemEditor Constructeur. Constructeur. discard Appelée juste avant que l’éditeur soit fermé. Appelée juste avant que l’éditeur soit fermé. Utilisez cette méthode pour effectuer tout nettoyage final, tel que le nettoyage de tout ce qui a été défini dans la méthode prepare().

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément.

prepare Appelée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible. Appelée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible. Utilisez cette méthode pour ajuster l’aspect de l’éditeur, ajouter des écouteurs d’événement ou effectuer toute autre initialisation avant qu’il ne devienne visible.

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément.

save Enregistre la valeur dans l’éditeur vers le fournisseur de données du propriétaire du rendu d’élément.true si l’opération d’enregistrement a réussi et false dans le cas contraire. Enregistre la valeur dans l’éditeur vers le fournisseur de données du propriétaire du rendu d’élément. Cette méthode met à jour l’élément de fournisseur de données correspondant à la rangée de la cellule modifiée. Cette fonction appelle GridItemEditor.validate() pour vérifier que les données peuvent être enregistrées. Si les données ne sont pas valides, les données ne sont pas enregistrées et l’éditeur n’est pas fermé.

N’appelez pas cette méthode directement. Elle doit être appelée uniquement par le contrôle qui héberge l’éditeur d’élément. Pour enregistrer et fermer l’éditeur, appelez la méthode endItemEditorSession() du propriétaire du rendu d’élément.

validate Vérifie si la valeur dans l’éditeur est valide et peut être enregistrée.true si la valeur dans l’éditeur est valide. Dans le cas contraire, renvoyez false. Vérifie si la valeur dans l’éditeur est valide et peut être enregistrée. columnIndex L’index de base zéro de la colonne en cours de modification. L’index de base zéro de la colonne en cours de modification. column La colonne de la cellule en cours de modification.spark.components.gridClasses:GridColumnnull La colonne de la cellule en cours de modification. dataGrid Le contrôle qui est propriétaire de cet éditeur d’élément.spark.components:DataGrid Le contrôle qui est propriétaire de cet éditeur d’élément. data null enableIME Indicateur qui signale si l’IME doit être activé lorsque le composant reçoit le focus. true Indicateur qui signale si l’IME doit être activé lorsque le composant reçoit le focus. imeMode Spécifie le mode IME (éditeur de méthode d’entrée).null Spécifie le mode IME (éditeur de méthode d’entrée). L’éditeur IME permet aux utilisateurs d’entrer du texte en chinois, japonais et coréen. Flex définit le mode IME spécifié lorsque le contrôle est mis en focus et rétablit la valeur précédente lorsque le contrôle est désactivé.

La classe flash.system.IMEConversionMode définit des constantes pour les valeurs possibles de cette propriété. Vous pouvez également spécifier null si vous ne souhaitez pas spécifier d’éditeur IME.

flash.system.IMEConversionModeitemRenderer Le rendu d’élément associé à la cellule modifiée.spark.components.gridClasses:IGridItemRenderernull Le rendu d’élément associé à la cellule modifiée. rowIndex L’index de base zéro de la rangée de la cellule en cours de modification.0 L’index de base zéro de la rangée de la cellule en cours de modification. value Par défaut, cette propriété est initialisée par la méthode Set de la propriété data.null Par défaut, cette propriété est initialisée par la méthode Set de la propriété data. La valeur par défaut de cette propriété correspond aux données de cellule issues du fournisseur de données du contrôle de grille. L’éditeur d’élément peut utiliser cette propriété pour initialiser tout élément visuel dans l’éditeur d’élément.

Par défaut, la méthode save() écrit la valeur de cette propriété dans le fournisseur de données du contrôle de grille lorsque l’éditeur se ferme avec un enregistrement.

Un grand nombre de rendus d’élément personnalisés remplacent les méthodes Get et Set de cette propriété. Remplacez la méthode Set pour initialiser l’éditeur en fonction de la valeur de la cellule. Remplacez la méthode Get pour renvoyer une nouvelle valeur de cellule à la méthode save().

IGridItemRenderer L’interface IGridItemRenderer doit être implémentée par des rendus d’élément DataGrid.mx.core:IDataRenderermx.core:IVisualElement L'interface IGridItemRenderer doit être implémentée par des rendus d'élément DataGrid. Le composant DataGrid utilise cette API pour fournir le rendu d’élément avec les informations requises pour rendre une cellule de grille ou d’en-tête.

Toutes les propriétés du rendu sont définies au cours de l’exécution de la méthode updateDisplayList() de son parent. Après la définition des propriétés , la méthode prepare() du rendu d’élément est appelée. Une implémentation de l’interface IGridItemRenderer doit remplacer la méthode prepare() pour effectuer d’éventuels ajustements finaux de ses propriétés ou de tout aspect de ses éléments visuels. En règle générale, la fonction prepare() permet de configurer les éléments visuels du rendu en fonction de la propriété data .

Lorsqu’un rendu d’élément n’est plus nécessaire, soit parce qu’il sera ajouté à la liste « libre » interne de rendus réutilisables, soit parce qu’il n’a plus d’utilité, la méthode discard() du composant IGridItemRenderer est appelée.

spark.components.DataGridspark.components.Griddiscard Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible.willBeRecycledtrue si ce rendu est destiné à être ajouté à la liste libre interne du propriétaire en vue d’être réutilisé. Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible. Si le paramètre willBeRecycled a la valeur true, le propriétaire ajoute ce rendu à sa liste libre interne en vue de le réutiliser. Les implémentations peuvent utiliser cette méthode pour effacer toute propriété de rendu qui n’est plus nécessaire.

Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l'implémentation DataGrid.

prepare Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies.hasBeenRecycled true si ce rendu est réutilisé. Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies. Le paramètre hasBeenRecycled a la valeur false si ce rendu n’a pas été utilisé avant, ce qui signifie qu’il n’a pas été recyclé. Cette méthode est appelée lorsqu’un rendu est sur le point de devenir visible et chaque fois qu’il est réaffiché en raison d’une modification d’une propriété du rendu ou du fait qu’un réaffichage a été explicitement demandé.

Cette méthode peut être utilisée pour configurer tous les éléments visuels et les propriétés d’un rendu. L'utilisation de cette méthode peut être plus efficace que la liaison des propriétés data des propriétés aux propriétés d'élément visuel. Remarque : puisque la méthode prepare() est appelée fréquemment, assurez-vous qu’elle est codée de manière efficace.

La méthode prepare() peut être appelée à de nombreuses reprises avant que la méthode discard() soit appelée.

Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l'implémentation DataGrid.

columnIndex L’index de colonne de la cellule de ce rendu d’élément. L’index de colonne de la cellule de ce rendu d’élément. Il s’agit de la même valeur que column.columnIndex. column L’objet GridColumn représentant la colonne associée à ce rendu d’élément.spark.components.gridClasses:GridColumn Objet GridColumn représentant la colonne associée à ce rendu d’élément. down Cette propriété est définie sur true lorsque l’un de deux gestes d’entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l’écran tactile est activé. Cette propriété est définie sur true lorsque l'un de deux gestes d'entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l'écran tactile est activé. La propriété down est réinitialisée sur false lorsque le bouton de la souris est relâché, l’utilisateur libère l’écran tactile ou le curseur/toucher est déplacé hors de la cellule de la grille.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille ne possèdent pas la responsabilité exclusive de l'affichage de l'indicateur vers le bas. La grille elle-même effectue le rendu de l'indicateur vers le bas pour la ligne ou la cellule sélectionnée. Le rendu d’élément peut également modifier ses propriétés visuelles pour mettre en évidence qu’il est actuellement sélectionné.

dragging Contient la valeur true si le rendu d'élément est en cours de glissement, généralement dans le cadre d'une opération glisser-déposer. Contient la valeur true si le rendu d'élément est en cours de glissement, généralement dans le cadre d'une opération glisser-déposer. Actuellement, le glisser-déposer n’est pas pris en charge par le contrôle Spark DataGrid. grid Le contrôle Grid associé à ce rendu d’élément, en règle générale, simplement la valeur de column.grid.spark.components:Grid Le contrôle Grid associé à ce rendu d’élément, en règle générale, simplement la valeur de column.grid. hovered Contient true si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL ou GridSelectionMode.MULTIPLE_CELLS, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW ou GridSelectionMode.MULTIPLE_ROWS. Contient true si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL ou GridSelectionMode.MULTIPLE_CELLS, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW ou GridSelectionMode.MULTIPLE_ROWS.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant que le rendu ou sa ligne sont situés sous la souris. La grille elle-même affiche automatiquement la partie d'habillage hoverIndicator pour la ligne ou la cellule survolée. Les rendus d'élément de grille peuvent également modifier leurs propriétés pour mettre en évidence qu'ils sont survolés.

label Chaîne à afficher dans le rendu d'élément. La chaîne à afficher dans l'option de rendu d'élément.

La classe GridItemRenderer copie automatiquement la valeur de cette propriété vers la propriété text de son élément labelDisplay, si cet élément a été spécifié. Le contrôle Grid définit la propriété label sur la valeur renvoyée par la méthode itemToLabel() de la colonne.

spark.components.gridClasses.GridItemRendererrowIndex L’index à base zéro de la ligne de la cellule faisant l’objet du rendu. L’index de base zéro de la rangée de la cellule faisant l’objet du rendu. selected Contient la valeur true si la cellule du rendu d'élément fait partie de la sélection en cours. Contient la valeur true si la cellule du rendu d'élément fait partie de la sélection en cours.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant qu'ils font partie de la sélection. La grille elle-même affiche automatiquement la partie d'habillage selectionIndicator pour les lignes ou les cellules sélectionnées. Le rendu d'élément peut également modifier ses propriétés visuelles pour souligner qu'elle fait partie de la sélection.

showsCaret Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret. Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret.

Contrairement à un rendu d'élément de liste, les rendus d'élément de grille n'ont pas la responsabilité exclusive d'afficher un élément indiquant que leur cellule ou ligne a le signe d'insertion. La grille elle-même affiche automatiquement la partie d'habillage caretIndicator pour la ligne ou la cellule du signe d'insertion. Le rendu d'élément peut également modifier ses propriétés visuelles pour mettre en évidence qu'il a le signe d'insertion.

ComboBoxGridItemEditorLa classe ComboBoxGridItemEditor définit un rendu d’élément à utiliser avec les contrôles de grille Spark, tels que DataGrid et Grid.mx.binding:IBindingClientspark.components.gridClasses:GridItemEditorLa classe ComboBoxGridItemEditor définit un rendu d’élément à utiliser avec les contrôles de grille Spark, tels que DataGrid et Grid. La classe ComboBoxGridItemEditor affiche une liste déroulante de valeurs de cellules. Sélectionnez une valeur pour définir la nouvelle valeur de la cellule.

L’exemple suivant illustre un objet GridColumn qui utilise la classe ComboBoxGridItemEditor comme éditeur d’élément :

        <s:GridColumn dataField="quant" 
            headerText="Qty">
                <s:itemEditor>
                    <fx:Component>
                        <s:ComboBoxGridItemEditor>
                            <s:dataProvider>
                                <s:ArrayList>
                                    <fx:int>0</fx:int>
                                    <fx:int>1</fx:int>
                                    <fx:int>2</fx:int>
                                    <fx:int>3</fx:int>
                                </s:ArrayList>
                            </s:dataProvider>
                        </s:ComboBoxGridItemEditor>
                    </fx:Component>
                </s:itemEditor>
        </s:GridColumn>
spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnComboBoxGridItemEditorConstructeur.Constructeur.comboBoxLe contrôle ComboBox de l’éditeur d’élément.spark.components:ComboBoxLe contrôle ComboBox de l’éditeur d’élément. dataProvider Le fournisseur de données de la liste déroulante dans l’éditeur d’élément. Le fournisseur de données de la liste déroulante dans l’éditeur d’élément.