| Package | spark.components.gridClasses |
| Interface | public interface IGridItemRenderer extends IDataRenderer , IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Implémenteurs | DefaultGridItemRenderer, GridItemRenderer, UITextFieldGridItemRenderer |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | IVisualElement | |
| baseline : Object
Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle. | ILayoutElement | |
| baselinePosition : Number [lecture seule]
Coordonnée y de la ligne de base de la première ligne de texte du composant. | ILayoutElement | |
| bottom : Object
Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage. | ILayoutElement | |
| column : GridColumn
L’objet GridColumn représentant la colonne associée à ce rendu d’élément. | IGridItemRenderer | ||
| columnIndex : int [lecture seule]
L’index de colonne de la cellule de ce rendu d’élément. | IGridItemRenderer | ||
| data : Object
Données à rendre ou à modifier. | IDataRenderer | |
| depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | IVisualElement | |
| designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | IVisualElement | |
| down : Boolean
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é. | IGridItemRenderer | ||
| dragging : Boolean
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. | IGridItemRenderer | ||
| grid : Grid [lecture seule]
Le contrôle Grid associé à ce rendu d’élément, en règle générale, simplement la valeur de column.grid. | IGridItemRenderer | ||
| hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | ILayoutElement | |
| height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | IVisualElement | |
| horizontalCenter : Object
Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | ILayoutElement | |
| hovered : Boolean
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. | IGridItemRenderer | ||
| includeInLayout : Boolean
Indique si ce composant est inclus dans la présentation du conteneur parent. | ILayoutElement | |
| is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | IVisualElement | |
| label : String
Chaîne à afficher dans le rendu d’élément. | IGridItemRenderer | ||
| layoutDirection : String
Spécifie la direction de mise en forme souhaitée pour un élément : l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée). | ILayoutDirectionElement | |
| left : Object
Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage. | ILayoutElement | |
| owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | IVisualElement | |
| parent : DisplayObjectContainer [lecture seule]
Conteneur ou composant parent de ce composant. | IVisualElement | |
| percentHeight : Number
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. | ILayoutElement | |
| percentWidth : Number
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent. | IVisualElement | |
| right : Object
Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage. | ILayoutElement | |
| rowIndex : int
L’index à base zéro de la ligne de la cellule faisant l’objet du rendu. | IGridItemRenderer | ||
| selected : Boolean
Contient la valeur true si la cellule du rendu d’élément fait partie de la sélection en cours. | IGridItemRenderer | ||
| showsCaret : Boolean
Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret. | IGridItemRenderer | ||
| top : Object
Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage. | ILayoutElement | |
| verticalCenter : Object
Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | ILayoutElement | |
| visible : Boolean
Contrôle la visibilité de cet élément visuel. | IVisualElement | |
| width : Number
Indique la largeur de l’objet d’affichage, en pixels. | IVisualElement | |
| x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement | |
| y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement | |
| Méthode | Défini par | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | IEventDispatcher | |
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. | IGridItemRenderer | ||
|
Distribue un événement dans le flux d’événements. | IEventDispatcher | |
|
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | |
|
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | |
|
Renvoie la hauteur de présentation de l’élément. | ILayoutElement | |
|
Renvoie la largeur de la présentation de l’élément. | ILayoutElement | |
|
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | ILayoutElement | |
|
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | ILayoutElement | |
|
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | ILayoutElement | |
|
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | ILayoutElement | |
|
Renvoie la hauteur maximale de l’élément. | ILayoutElement | |
|
Renvoie la largeur maximale de l’élément. | ILayoutElement | |
|
Renvoie la hauteur minimale de l’élément. | ILayoutElement | |
|
Renvoie la largeur minimale de l’élément. | ILayoutElement | |
|
Renvoie la hauteur préférée de l’élément. | ILayoutElement | |
|
Renvoie la largeur préférée de l’élément. | ILayoutElement | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | |
|
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. | ILayoutDirectionElement | |
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. | IGridItemRenderer | ||
|
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | |
|
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | ILayoutElement | |
|
Définit la taille de la présentation de l’élément. | ILayoutElement | |
|
Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères. | ILayoutElement | |
|
Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères. | ILayoutElement | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. | ILayoutElement | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | IEventDispatcher | |
column | propriété |
column:GridColumn| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Objet GridColumn représentant la colonne associée à ce rendu d’élément.
Implémentation
public function get column():GridColumn public function set column(value:GridColumn):voidcolumnIndex | propriété |
columnIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
L’index de colonne de la cellule de ce rendu d’élément. Il s’agit de la même valeur que column.columnIndex.
Implémentation
public function get columnIndex():intdown | propriété |
down:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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é.
Implémentation
public function get down():Boolean public function set down(value:Boolean):voiddragging | propriété |
dragging:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Implémentation
public function get dragging():Boolean public function set dragging(value:Boolean):voidgrid | propriété |
hovered | propriété |
hovered:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Implémentation
public function get hovered():Boolean public function set hovered(value:Boolean):voidlabel | propriété |
label:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Chaîne à afficher dans le 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.
Implémentation
public function get label():String public function set label(value:String):voidEléments de l’API associés
rowIndex | propriété |
rowIndex:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
L’index de base zéro de la rangée de la cellule faisant l’objet du rendu.
Implémentation
public function get rowIndex():int public function set rowIndex(value:int):voidselected | propriété |
selected:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Implémentation
public function get selected():Boolean public function set selected(value:Boolean):voidshowsCaret | propriété |
showsCaret:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Implémentation
public function get showsCaret():Boolean public function set showsCaret(value:Boolean):voiddiscard | () | méthode |
public function discard(willBeRecycled:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Paramètres
willBeRecycled:Boolean — true si ce rendu est destiné à être ajouté à la liste libre interne du propriétaire en vue d’être réutilisé.
|
prepare | () | méthode |
public function prepare(hasBeenRecycled:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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.
Paramètres
hasBeenRecycled:Boolean — true si ce rendu est réutilisé.
|
Tue Jun 12 2018, 09:30 AM Z