Package | fl.controls |
Classe | public class DataGrid |
Héritage | DataGrid SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implémente | IFocusManagerComponent |
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 |
Le composant DataGrid est conçu pour l’affichage d’objets qui contiennent plusieurs propriétés. Les données qui sont affichées par le composant DataGrid peuvent être contenues dans un objet DataProvider ou correspondre à un tableau d’objets. Les colonnes d’un composant DataGrid peuvent être représentées par une liste d’objets DataGridColumn, qui comportent tous des informations propres à la colonne.
Le composant DataGrid offre les fonctionnalités suivantes :
- Colonnes de largeur variable ou fixe
- Colonnes que l’utilisateur peut redimensionner
- Colonnes que l’utilisateur peut réorganiser pendant la période d’exécution à l’aide du code ActionScript
- En-têtes de colonne personnalisables en option
- Prise en charge du rendu d’éléments personnalisés pour afficher des données autres que du texte dans des colonnes
- Prise en charge du tri des données en cliquant sur la colonne qui les contient
Le composant DataGrid inclut des sous-composants, dont ScrollBar, HeaderRenderer, CellRenderer, DataGridCellEditor et ColumnDivider, qui peuvent être associés à une enveloppe lors de la création ou pendant la période d’exécution.
Le composant DataGrid exploite les classes suivantes qui figurent dans le package dataGridClasses :
- DataGridColumn : décrit une colonne dans un composant DataGrid. Contient les index, largeurs et autres propriétés de la colonne. Ne contient pas de données de cellules.
- HeaderRenderer : affiche l’en-tête de colonne de la colonne DataGrid actuelle. Contient l’étiquette et autres propriétés de l’en-tête de colonne.
- DataGridCellEditor : gère la modification des données pour chaque cellule.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | ||
allowMultipleSelection : Boolean
Lit une valeur booléenne qui indique si plusieurs éléments de la liste peuvent être sélectionnés en même temps. | SelectableList | ||
alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | ||
blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | ||
blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | ||
buttonMode : Boolean
Spécifie le mode de bouton du sprite. | Sprite | ||
cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | ||
columns : Array
Lit ou définit un tableau d’objets DataGridColumn, un pour chaque colonne pouvant être affichée. | DataGrid | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | ||
dataProvider : DataProvider
Lit ou définit le modèle de données de la liste d’éléments à afficher. | SelectableList | ||
doubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [lecture seule]
Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé. | Sprite | ||
editable : Boolean = false
Indique si l’utilisateur peut ou non modifier les éléments du fournisseur de données. | DataGrid | ||
editedItemPosition : Object
Lit ou définit l’index de colonne de ligne de la fonctionnalité de rendu d’élément pour l’élément du fournisseur de données qui est en cours de modification. | DataGrid | ||
editedItemRenderer : ICellRenderer [lecture seule]
Récupère une référence au rendu d’élément du composant DataGrid dont l’élément est en cours de modification. | DataGrid | ||
enabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur. | UIComponent | ||
filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | ||
focusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | ||
focusManager : IFocusManager
Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues. | UIComponent | ||
focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | ||
graphics : Graphics [lecture seule]
Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel. | Sprite | ||
headerHeight : Number
Lit ou définit la hauteur de l’en-tête du composant DataGrid, en pixels. | DataGrid | ||
height : Number [override]
Récupère ou définit la hauteur du composant, en pixels. | UIComponent | ||
hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | ||
horizontalLineScrollSize : Number
Récupère ou définit une valeur décrivant la quantité de contenu à faire défiler horizontalement lorsque l’utilisateur clique sur un bouton fléché. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Récupère ou définit le nombre de pixels selon lequel le curseur de la barre de défilement horizontal se déplace lorsque l’utilisateur clique sur le rail de la barre de défilement. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [lecture seule]
Lit une référence à la barre de défilement horizontale. | BaseScrollPane | ||
horizontalScrollPolicy : String [override]
Lit ou définit une valeur booléenne qui indique si la barre de défilement horizontale doit toujours rester affichée. | DataGrid | ||
horizontalScrollPosition : Number
Récupère ou définit une valeur décrivant la position horizontale de la barre de défilement horizontale dans le panneau défilant, en pixels. | BaseScrollPane | ||
imeMode : String
Lit ou définit le mode de l’éditeur de méthode d’entrée (IME). | DataGrid | ||
itemEditorInstance : Object
Référence à l’occurrence actuellement active de l’éditeur d’éléments, s’il existe. | DataGrid | ||
labelFunction : Function
Lit ou définit une fonction qui détermine les champs de chaque élément à utiliser pour le texte d’étiquette. | DataGrid | ||
length : uint [lecture seule]
Lit le nombre d’éléments présents dans le fournisseur de données. | SelectableList | ||
loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | ||
mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | ||
maxHorizontalScrollPosition : Number [override]
Lit ou définit le nombre de pixels jusqu’où la liste peut défiler vers la droite, lorsque la propriété horizontalScrollPolicy est définie sur ScrollPolicy.ON. | SelectableList | ||
maxVerticalScrollPosition : Number [lecture seule]
Obtient la position de défilement vertical maximale pour le contenu actif, en pixels. | BaseScrollPane | ||
metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | ||
minColumnWidth : Number
Lit ou définit la largeur minimale de la colonne d’un DataGrid, en pixels. | DataGrid | ||
mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée. | UIComponent | ||
mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | ||
numChildren : int [lecture seule]
Renvoie le nombre d’enfants de l’objet. | DisplayObjectContainer | ||
opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | ||
parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | ||
resizableColumns : Boolean = true
Indique si l’utilisateur peut modifier la taille des colonnes. | DataGrid | ||
root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | ||
rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | ||
rotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
rowCount : uint [override]
Lit ou définit le nombre de lignes au moins partiellement visibles dans la liste. | DataGrid | ||
rowHeight : Number
Récupère ou définit la hauteur de chaque ligne du composant DataGrid, en pixels. | DataGrid | ||
scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | ||
scaleX : Number [override]
Multiplie la largeur actuelle du composant par un facteur de redimensionnement. | UIComponent | ||
scaleY : Number [override]
Multiplie la hauteur actuelle du composant par un facteur de redimensionnement. | UIComponent | ||
scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | ||
scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | ||
selectable : Boolean
Lit ou définit une valeur booléenne qui indique si les éléments de la liste peuvent être sélectionnés. | SelectableList | ||
selectedIndex : int
Lit ou définit l’index de l’élément qui est sélectionné dans une liste à sélection unique. | SelectableList | ||
selectedIndices : Array
Lit ou définit un tableau qui contient les articles qui ont été sélectionnés à partir d’une liste à sélections multiples. | SelectableList | ||
selectedItem : Object
Lit ou définit l’élément qui a été sélectionné à partir d’une liste à sélection unique. | SelectableList | ||
selectedItems : Array
Lit ou définit un tableau qui contient les objets qui ont été sélectionnés à partir d’une liste à sélections multiples. | SelectableList | ||
showHeaders : Boolean
Récupère ou définit une valeur booléenne qui indique si le composant DataGrid affiche les en-têtes des colonnes. | DataGrid | ||
softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | ||
sortableColumns : Boolean = true
Indique que l’utilisateur peut trier les éléments du fournisseur de données en cliquant sur une cellule d’en-tête de colonnes. | DataGrid | ||
sortDescending : Boolean [lecture seule]
Lit l’ordre de tri de la colonne lorsque l’utilisateur clique sur son en-tête. | DataGrid | ||
sortIndex : int [lecture seule]
Lit l’index de la colonne à trier. | DataGrid | ||
soundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite. | Sprite | ||
stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | ||
tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation. | DisplayObjectContainer | ||
tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | ||
tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [lecture seule]
Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | ||
useBitmapScrolling : Boolean
Si définie sur true, la valeur de la propriété cacheAsBitmap du contenu de défilement est true ; si définie sur false, cette valeur est désactivée. | BaseScrollPane | ||
useHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. | Sprite | ||
verticalLineScrollSize : Number
Récupère ou définit une valeur décrivant la quantité de pixels à faire défiler verticalement lorsque l’utilisateur clique sur un bouton fléché. | BaseScrollPane | ||
verticalPageScrollSize : Number
Récupère ou définit le nombre de pixels selon lequel le curseur de la barre de défilement vertical se déplace lorsque l’utilisateur clique sur le rail de la barre de défilement. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [lecture seule]
Récupère une référence à la barre de défilement vertical. | BaseScrollPane | ||
verticalScrollPolicy : String
Récupère ou définit une valeur indiquant l’état de la barre de défilement verticale. | BaseScrollPane | ||
verticalScrollPosition : Number
Récupère ou définit une valeur décrivant la position verticale de la barre de défilement verticale dans le panneau défilant, en pixels. | BaseScrollPane | ||
visible : Boolean [override]
Récupère ou définit une valeur indiquant si l’occurrence du composant actif est visible. | UIComponent | ||
width : Number [override]
Récupère ou définit la largeur du composant, en pixels. | UIComponent | ||
x : Number [override]
Récupère ou définit la coordonnée x représentant la position du composant le long de l’axe x au sein de son conteneur parent. | UIComponent | ||
y : Number [override]
Récupère ou définit la coordonnée y représentant la position du composant le long de l’axe y au sein de son conteneur parent. | UIComponent | ||
z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject |
Méthode | Défini par | ||
---|---|---|---|
DataGrid()
Crée une nouvelle occurrence du composant DataGrid. | DataGrid | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
Ajoute une colonne à la fin du tableau de colonnes. | DataGrid | ||
Insère une colonne à l’index spécifié dans le tableau de colonnes. | DataGrid | ||
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. | EventDispatcher | ||
Ajoute un élément à la fin de la liste d’éléments. | SelectableList | ||
Insère un élément dans la liste, à l’index spécifié. | SelectableList | ||
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié. | DisplayObjectContainer | ||
Supprime un style qui est défini sur les fonctionnalités de rendu de la liste. | SelectableList | ||
Efface l’élément actuellement sélectionné dans la liste et définit la propriété selectedIndex sur -1. | SelectableList | ||
Définit une propriété de style depuis cette occurrence de composant. | UIComponent | ||
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | ||
Exploite l’éditeur spécifié par la propriété itemEditor pour créer un éditeur d’éléments pour le rendu de ces derniers aux index de colonne et de ligne identifiés par la propriété editedItemPosition. | DataGrid | ||
Ferme l’éditeur d’éléments qui est en cours d’utilisation pour le rendu. | DataGrid | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Affiche ou masque l’indicateur de focus dans ce composant. | UIComponent | ||
Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow. | UIComponent | ||
Modifie un champ ou une propriété dans le composant DataGrid. | DataGrid | ||
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | ||
Récupère une occurrence de la classe CellRenderer à la position spécifiée dans le composant DataGrid. | DataGrid | ||
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié. | DisplayObjectContainer | ||
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | ||
Renvoie la position d’index d’une occurrence enfant de DisplayObject. | DisplayObjectContainer | ||
Extrait la colonne qui est située à l’index spécifié du tableau de colonnes. | DataGrid | ||
Récupère le nombre de colonnes présentes dans le composant DataGrid. | DataGrid | ||
Récupère l’index de la colonne correspondant au nom spécifié, ou -1 lorsqu’il n’y a pas de correspondance. | DataGrid | ||
Récupère l’objet qui détient actuellement le focus. | UIComponent | ||
Récupère l’élément à l’index spécifié. | SelectableList | ||
Renvoie l’index du prochain élément du dataProvider dans lequel le premier caractère de l’étiquette correspond à un caractère de chaîne spécifié. | SelectableList | ||
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | ||
Récupère un style qui est défini sur les fonctionnalités de rendu de la liste. | SelectableList | ||
Extrait une propriété de style définie dans la chaîne de recherche de style du composant. | UIComponent | ||
[statique]
Récupère la texture de style par défaut du composant actif. | DataGrid | ||
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | ||
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | ||
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | ||
Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire. | UIComponent | ||
Invalide un rendu d’élément spécifique. | SelectableList | ||
Invalide le rendu de l’élément présent à l’index spécifié. | SelectableList | ||
Invalide l’ensemble de la liste et impose un nouveau dessin de tous les éléments. | SelectableList | ||
Vérifie si l’élément spécifié est sélectionné dans la liste. | SelectableList | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
[override]
Comme le composant DataGrid comporte plusieurs cellules pour n’importe quel élément donné, la méthode itemToCellRenderer renvoie toujours null. | DataGrid | ||
Extrait la chaîne affichée par l’objet de rendu pour l’objet de données fourni en fonction des propriétés label de l’objet. | SelectableList | ||
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | ||
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | ||
[statique]
Fusionne les styles de plusieurs classes en un seul objet. | UIComponent | ||
Déplace le composant à la position spécifiée dans son parent. | UIComponent | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime tous les éléments de la liste. | SelectableList | ||
Supprime toutes les colonnes du composant DataGrid. | DataGrid | ||
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime la colonne qui est située à l’index spécifié du tableau de colonnes. | DataGrid | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Supprime l’élément spécifié de la liste. | SelectableList | ||
Supprime l’élément présent à l’emplacement d’index spécifié. | SelectableList | ||
Remplace l’élément, à l’index spécifié, par un autre élément. | SelectableList | ||
Affiche un clavier virtuel. | InteractiveObject | ||
[override]
Fait défiler la liste jusqu’à l’élément, à l’index spécifié. | DataGrid | ||
Fait défiler la liste jusqu’à l’élément, à l’emplacement indiqué par la valeur actuelle de la propriété selectedIndex. | SelectableList | ||
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. | DisplayObjectContainer | ||
Définit le focus sur ce composant. | UIComponent | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit un style pour les fonctionnalités de rendu dans la liste. | SelectableList | ||
Définit le composant en fonction de la largeur et de la hauteur spécifiées. | UIComponent | ||
Définit une propriété de style pour cette occurrence de composant. | UIComponent | ||
Trie les éléments du fournisseur de données actuel. | SelectableList | ||
Trie les éléments du fournisseur de données actuel en fonction d’un ou plusieurs de ses champs. | SelectableList | ||
Uniformise les largeurs des colonnes visibles. | DataGrid | ||
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | ||
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | ||
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | ||
Met fin à la méthode startDrag(). | Sprite | ||
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. | DisplayObjectContainer | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. | DisplayObjectContainer | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire. | UIComponent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
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é. | EventDispatcher |
Evénement | Synthèse | Défini par | ||
---|---|---|---|---|
[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | |||
Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | |||
Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | |||
Distribué lorsqu’un autre élément est sélectionné dans la liste. | SelectableList | |||
Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur agrandit une colonne horizontalement. | DataGrid | |||
Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR. | InteractiveObject | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. | InteractiveObject | |||
[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | |||
Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true. | InteractiveObject | |||
[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | |||
[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | |||
Distribué après la prise de focus par un objet d’affichage. | InteractiveObject | |||
Distribué après la perte de focus par un objet d’affichage. | InteractiveObject | |||
[événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. | DisplayObject | |||
Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). | InteractiveObject | |||
Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur clique sur une cellule d’en-tête. | DataGrid | |||
Distribué après que la visibilité du composant soit passée de visible à invisible. | UIComponent | |||
Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | |||
Distribué lorsque l’utilisateur clique sur un élément du composant. | SelectableList | |||
Distribué lorsque l’utilisateur clique rapidement à deux reprises sur un élément du composant. | SelectableList | |||
Distribué lorsque la propriété editedItemPosition est définie et que l’élément peut être modifié. | DataGrid | |||
Distribué lorsque l’utilisateur se prépare à modifier un élément, par exemple en y relâchant le bouton de sa souris. | DataGrid | |||
Distribué lorsqu’une session de modification d’élément se termine pour une raison quelconque. | DataGrid | |||
Distribué après qu’un élément reçoit le focus. | DataGrid | |||
Distribué après qu’un élément perd le focus. | DataGrid | |||
Distribué lorsque le pointeur de la souris cesse de survoler un élément du composant. | SelectableList | |||
Distribué lorsque le pointeur de la souris survole un élément du composant. | SelectableList | |||
Distribué lorsque l’utilisateur appuie sur une touche. | InteractiveObject | |||
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. | InteractiveObject | |||
Distribué lorsque l’utilisateur relâche une touche. | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. | InteractiveObject | |||
Distribué à la suite du déplacement du composant. | UIComponent | |||
Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser. | InteractiveObject | |||
Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop(). | InteractiveObject | |||
Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites. | InteractiveObject | |||
Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites. | InteractiveObject | |||
Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites. | InteractiveObject | |||
Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. | InteractiveObject | |||
Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran). | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. | DisplayObject | |||
Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | |||
[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. | DisplayObject | |||
Distribué à la suite du redimensionnement du composant. | UIComponent | |||
Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | |||
Distribué lorsque le pointeur de la souris cesse de survoler le composant. | SelectableList | |||
Distribué lorsque le pointeur de la souris survole le composant. | SelectableList | |||
Distribué lorsque l’utilisateur effectue un défilement horizontal ou vertical. | SelectableList | |||
Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. | InteractiveObject | |||
Distribué après que la visibilité du composant soit passée de invisible à visible. | UIComponent | |||
Distribué immédiatement après l’affichage du clavier logiciel. | InteractiveObject | |||
Distribué immédiatement avant l’affichage du clavier logiciel. | InteractiveObject | |||
Distribué immédiatement après la disparition du clavier logiciel. | InteractiveObject | |||
Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change. | InteractiveObject | |||
Distribué lorsque l’indicateur tabEnabled de l’objet change. | InteractiveObject | |||
Distribué lorsque la valeur de la propriété tabIndex de l’objet change. | InteractiveObject | |||
Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. | InteractiveObject | |||
Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. | InteractiveObject | |||
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). | InteractiveObject | |||
Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | |||
Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). | InteractiveObject |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Style | Description | Défini par | ||
---|---|---|---|---|
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Classe qui fournit le rendu de cellule pour chaque élément du composant. | SelectableList | |||
columnDividerSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit le séparateur qui apparaît entre les colonnes. La valeur par défaut est DataGrid_columnDividerSkin . | DataGrid | ||
columnStretchCursorSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit le curseur utilisé lorsque la souris est entre deux en-têtes de colonne et que la propriété resizableColumns est définie sur true .
La valeur par défaut est DataGrid_columnStretchCursorSkin . | DataGrid | ||
Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare la bordure de la liste et son contenu, en pixels. | SelectableList | |||
Type: Number Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Valeur alpha à attribuer à la liste lorsque la propriété enabled est définie sur false . | SelectableList | |||
Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant lorsque le bouton est désactivé. | UIComponent | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsqu’il est désactivé. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque vous cliquez sur le bouton flèche. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement lorsque le pointeur de la souris le survole. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche basse de la barre de défilement. | BaseScrollPane | |||
Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l’indicateur du focus, en pixels. | UIComponent | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe à utiliser pour afficher les indicateurs de focus. | UIComponent | |||
headerDisabledSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan de chaque en-tête de colonne lorsque le composant est désactivé. La valeur par défaut est HeaderRenderer_disabledSkin . | DataGrid | ||
headerDisabledTextFormat | Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Format à appliquer au texte contenu dans chaque en-tête de colonne lorsque le composant est désactivé. La valeur par défaut est null . | DataGrid | ||
headerDownSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan de chaque en-tête de colonne lorsque le bouton de la souris est enfoncé. La valeur par défaut est HeaderRenderer_downSkin . | DataGrid | ||
headerOverSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan de chaque en-tête de colonne lorsque la souris le survole. La valeur par défaut est HeaderRenderer_overSkin . | DataGrid | ||
headerRenderer | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit chaque en-tête de colonne. La valeur par défaut est fl.controls.dataGridClasses.HeaderRenderer . | DataGrid | ||
headerSortArrowAscSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit la flèche du tri lorsque la colonne triée est en ordre croissant. La valeur par défaut est HeaderSortArrow_ascIcon . | DataGrid | ||
headerSortArrowDescSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit la flèche du tri lorsque la colonne triée est en ordre décroissant. La valeur par défaut est HeaderSortArrow_descIcon . | DataGrid | ||
headerTextFormat | Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Format à appliquer au texte contenu dans chaque en-tête de colonne. La valeur par défaut est null . | DataGrid | ||
headerTextPadding | Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare la bordure de l’en-tête de colonne de son texte, en pixels. La valeur par défaut est 5 . | DataGrid | ||
headerUpSkin | Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe qui fournit l’arrière-plan de chaque en-tête de colonne. La valeur par défaut est HeaderRenderer_upSkin . | DataGrid | ||
Type: Number Format: Time Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nombre de millisecondes d’attente après la première diffusion de l’événement buttonDown et avant l’envoi d’un second événement buttonDown . | BaseScrollPane | |||
Type: Number Format: Time Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Intervalle, en millisecondes, entre les événements buttonDown distribués après le délai spécifié par le style repeatDelay . | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Classe qui fournit l’enveloppe de l’arrière-plan du composant. | SelectableList | |||
Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant. | UIComponent | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état désactivé du curseur. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque vous cliquez sur le curseur. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme icône du curseur de la barre de défilement. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme habillage du curseur de la barre de défilement lorsque le pointeur de la souris le survole. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe pour le curseur de la barre de défilement. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer un rail désactivé. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état enfoncé d’une enveloppe désactivée. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état de survol de la souris dans le rail de défilement. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe utilisée pour indiquer l’état relevé de la souris dans le rail de défilement. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsqu’il est désactivé. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque vous cliquez sur le bouton flèche. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement lorsque le pointeur de la souris le survole. | BaseScrollPane | |||
Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Nom de la classe à utiliser comme enveloppe du bouton de la flèche haute de la barre de défilement. | BaseScrollPane |
columns | propriété |
columns:Array
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 |
Lit ou définit un tableau d’objets DataGridColumn, un pour chaque colonne pouvant être affichée. S’il n’est pas défini de façon explicite, le composant DataGrid analyse le premier élément du fournisseur de données, recherche ses propriétés, puis affiche ces dernières par ordre alphabétique.
Vous pouvez modifier ces colonnes et leur ordre dans ce tableau DataGridColumn. Une fois les modifications appliquées, vous devez affecter de façon explicite le tableau modifié à la propriété columns
. En l’absence d’affectation explicite, l’ensemble des colonnes utilisées auparavant continue à être utilisé.
La valeur par défaut est [].
Implémentation
public function get columns():Array
public function set columns(value:Array):void
Exemple ( Comment utiliser cet exemple )
columns
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); function getRandomNumber():uint { return Math.round(Math.random() * 100); }
columns
et de la méthode getColumnCount()
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); trace("columns.length:", dg.columns.length); // 3 trace("getColumnCount():", dg.getColumnCount()); // 3 function getRandomNumber():uint { return Math.round(Math.random() * 100); }
editable | propriété |
public var editable:Boolean = false
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 |
Indique si l’utilisateur peut ou non modifier les éléments du fournisseur de données. La valeur true
indique que l’utilisateur peut modifier des éléments dans le fournisseur de données. La valeur false
indique le contraire.
Si cette valeur est true
, les fonctionnalités de rendu d’élément du composant sont modifiables. L’utilisateur peut cliquer sur un rendu d’élément pour ouvrir un éditeur.
Vous pouvez désactiver l’édition de colonnes individuelles du composant DataGrid à l’aide de la propriété DataGridColumn.editable
, ou en utilisant les événements itemEditBeginning
et itemEditBegin
.
La valeur par défaut est false.
Eléments de l’API associés
editedItemPosition | propriété |
editedItemPosition: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 |
Lit ou définit l’index de colonne de ligne de la fonctionnalité de rendu d’élément pour l’élément du fournisseur de données qui est en cours de modification. Si aucun élément n’est en cours de modification, cette propriété a la valeur null
.
Cet objet comporte deux champs :
columnIndex
: l’index de colonne à base zéro de l’élément actuelrowIndex
: l’index de ligne à base zéro de l’élément actuel
Exemple : { columnIndex:2, rowIndex:3 }
La définition de cette propriété ramène l’élément en vue et distribue l’événement itemEditBegin
pour ouvrir un éditeur d’élément dans le rendu d’élément spécifié.
La valeur par défaut est null.
Implémentation
public function get editedItemPosition():Object
public function set editedItemPosition(value:Object):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.data.DataProvider; import fl.controls.*; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.columns = [ "col1", "col2", "col3" ]; dg.editable = true; dg.dataProvider = dp; dg.move(200,10); dg.setSize(200,300); addChild(dg); var rowIntro:Label = new Label(); rowIntro.text = "Row to edit:"; rowIntro.move(10,10); var colIntro:Label = new Label(); colIntro.text = "Column to edit:"; colIntro.move(10,30); var rowInputField:TextInput = new TextInput(); rowInputField.move(100,10); rowInputField.setSize(30,20); var colInputField:TextInput = new TextInput(); colInputField.move(100,30); colInputField.setSize(30,20); var editButton:Button = new Button(); editButton.move(10,60); editButton.label = "Edit"; editButton.addEventListener(MouseEvent.CLICK,editGrid); addChild(rowIntro); addChild(colIntro); addChild(rowInputField); addChild(colInputField); addChild(editButton); function editGrid(e:MouseEvent):void { dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) }; }
editedItemRenderer | propriété |
editedItemRenderer:ICellRenderer
[lecture 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 |
Récupère une référence au rendu d’élément du composant DataGrid dont l’élément est en cours de modification. Si aucun élément n’est en cours de modification, cette propriété a la valeur null
.
Vous pouvez obtenir la valeur actuelle de l’élément en cours de modification à l’aide de la propriété editedItemRenderer.data
et à partir d’un écouteur d’événements pour l’événement itemEditBegin
ou itemEditEnd
.
Cette propriété est en lecture seule. Pour définir un éditeur d’élément personnalisé, utilisez la propriété itemEditor
de la classe qui représente la colonne voulue.
Implémentation
public function get editedItemRenderer():ICellRenderer
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.data.DataProvider; import fl.controls.*; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.columns = [ "col1", "col2", "col3" ]; dg.editable = true; dg.dataProvider = dp; dg.move(200,10); dg.setSize(200,300); addChild(dg); var rowIntro:Label = new Label(); rowIntro.text = "Row to edit:"; rowIntro.move(10,10); var colIntro:Label = new Label(); colIntro.text = "Column to edit:"; colIntro.move(10,30); var rowInputField:TextInput = new TextInput(); rowInputField.move(100,10); rowInputField.setSize(30,20); var colInputField:TextInput = new TextInput(); colInputField.move(100,30); colInputField.setSize(30,20); var editButton:Button = new Button(); editButton.move(10,60); editButton.label = "Edit"; editButton.addEventListener(MouseEvent.CLICK,editGrid); addChild(rowIntro); addChild(colIntro); addChild(rowInputField); addChild(colInputField); addChild(editButton); function editGrid(e:MouseEvent):void { dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) }; }
headerHeight | propriété |
headerHeight:Number
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 |
Lit ou définit la hauteur de l’en-tête du composant DataGrid, en pixels.
La valeur par défaut est 25.
Implémentation
public function get headerHeight():Number
public function set headerHeight(value:Number):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
headerHeight
d’une occurrence du composant DataGrid :
import fl.controls.DataGrid; import fl.controls.Slider; import fl.events.SliderEvent; var headerHeightSlider:Slider = new Slider(); headerHeightSlider.minimum = 20; headerHeightSlider.maximum = 40; headerHeightSlider.snapInterval = 2; headerHeightSlider.tickInterval = 4; headerHeightSlider.liveDragging = true; headerHeightSlider.move(10, 10); headerHeightSlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(headerHeightSlider); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.headerHeight = headerHeightSlider.value; myDataGrid.addColumn("name"); myDataGrid.addColumn("value"); myDataGrid.addItem({name:"Person A", value:0.85}); myDataGrid.addItem({name:"Person B", value:0.87}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 30); addChild(myDataGrid); function changeHandler(event:SliderEvent):void { myDataGrid.headerHeight = event.value; myDataGrid.rowCount = myDataGrid.length; }
horizontalScrollPolicy | propriété |
horizontalScrollPolicy:String
[override] 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 |
Lit ou définit une valeur booléenne qui indique si la barre de défilement horizontale doit toujours rester affichée. La liste suivante décrit les valeurs valides :
ScrollPolicy.ON
: La barre de défilement est toujours affichée.ScrollPolicy.OFF
: La barre de défilement est toujours masquée.ScrollPolicy.AUTO
: L’état de la barre de défilement change en fonction des paramètres qui sont transmis à la méthodesetScrollBarProperties()
.
Remarque : lorsque la largeur combinée des colonnes visibles du composant DataGrid est inférieure à la largeur disponible du composant DataGrid, les colonnes ne peuvent pas être étendues pour remplir l’espace disponible du DataGrid, selon la valeur de la propriété horizontalScrollPolicy
. La liste suivante décrit ces valeurs et leurs effets :
ScrollPolicy.ON
: la barre de défilement horizontale est désactivée. Les colonnes ne se développent pas pour remplir l’espace disponible du composant DataGrid.ScrollPolicy.AUTO
: la barre de défilement horizontale n’est pas visible. Les colonnes ne se développent pas pour remplir l’espace disponible du composant DataGrid.
La valeur par défaut est ScrollPolicy.OFF.
Implémentation
override public function get horizontalScrollPolicy():String
override public function set horizontalScrollPolicy(value:String):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber(), col5:getRandomNumber(), col6:getRandomNumber(), col7:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200,300); dg.addColumn("col1"); dg.addColumn("col2"); dg.addColumn("col3"); dg.addColumn("col4"); dg.addColumn("col5"); dg.addColumn("col6"); dg.addColumn("col7"); dg.dataProvider = dp; dg.horizontalScrollPolicy = ScrollPolicy.ON; addChild(dg); function getRandomNumber():uint { return Math.round(Math.random() * 100); }
imeMode | propriété |
imeMode:String
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 |
Lit ou définit le mode de l’éditeur de méthode d’entrée (IME). L’IME permet aux utilisateur d’utiliser un clavier AZERTY pour saisir des caractères chinois, japonais ou coréens.
Flash définit l’IME sur le mode spécifié lorsque le composant obtient le focus et restaure sa valeur d’origine lorsque ce composant perd le focus.
La classe flash.system.IMEConversionMode définit des constantes pour les valeurs possibles de cette propriété. Définissez cette propriété sur null
pour empêcher l’utilisation de l’éditeur IME avec le composant.
Implémentation
public function get imeMode():String
public function set imeMode(value:String):void
Eléments de l’API associés
itemEditorInstance | propriété |
public var itemEditorInstance: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éférence à l’occurrence actuellement active de l’éditeur d’éléments, s’il existe.
Pour accéder à l’occurrence de l’éditeur d’élément et à la nouvelle valeur de l’élément lorsqu’un élément est modifié, utilisez la propriété itemEditorInstance
. La propriété itemEditorInstance
n’est valide qu’après l’exécution de l’écouteur d’événement de l’événement itemEditBegin
. Par conséquent, la propriété itemEditorInstance
est généralement accessible à partir de l’écouteur d’événement pour l’événement itemEditEnd
.
La propriété DataGridColumn.itemEditor
définit la classe de l’éditeur d’élément et, de ce fait, le type de données de l’occurrence d’éditeur d’élément.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
itemEditorInstance
d’une grille de données pour déterminer le texte d’une cellule après qu’il a été modifié :
import fl.data.DataProvider; import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridCellEditor; import fl.controls.listClasses.ListData; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i=0; i<totalEntries; i++) { dp.addItem( { col1:"CellName", col2:"CellName", col3:"CellName" } ); } var dg:DataGrid = new DataGrid(); dg.addEventListener(DataGridEvent.ITEM_EDIT_END,onItemEditEnd); dg.dataProvider = dp; dg.editable = true; dg.setSize(300,200); addChild(dg); function onItemEditEnd(e:DataGridEvent):void { var cellEditor:DataGridCellEditor = dg.itemEditorInstance as DataGridCellEditor; var listData:ListData = cellEditor.listData; trace("After Edit: " + cellEditor.text); }
labelFunction | propriété |
labelFunction:Function
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 |
Lit ou définit une fonction qui détermine les champs de chaque élément à utiliser pour le texte d’étiquette.
La valeur par défaut est null.
Implémentation
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var c1:DataGridColumn = new DataGridColumn("col1"); c1.sortOptions = Array.NUMERIC; var c2:DataGridColumn = new DataGridColumn("col2"); c2.sortOptions = Array.NUMERIC; var c3:DataGridColumn = new DataGridColumn("col3"); c3.sortOptions = Array.NUMERIC; var dg:DataGrid = new DataGrid(); dg.addColumn(c1); dg.addColumn(c2); dg.addColumn(c3); dg.dataProvider = dp; dg.labelFunction = currencyFormatter; dg.move(10, 10); dg.setSize(200, 300); addChild(dg); function getRandomNumber():Number { return Math.random() * 100; } function currencyFormatter(data:Object, column:DataGridColumn):String { return "$" + data[column.dataField].toFixed(2); }
minColumnWidth | propriété |
minColumnWidth:Number
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 |
Lit ou définit la largeur minimale de la colonne d’un DataGrid, en pixels. Lorsque cette valeur est définie sur NaN
, la largeur minimale de colonne peut être définie de façon individuelle pour chaque colonne du composant DataGrid.
La valeur par défaut est NaN.
Implémentation
public function get minColumnWidth():Number
public function set minColumnWidth(value:Number):void
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getString(), col2:getString(), col3:getString(), col4:getString(), col5:getString(), col6:getString(), col7:getString()}); } var dg:DataGrid = new DataGrid(); dg.setSize(450,300); dg.addColumn("col1"); dg.addColumn("col2"); dg.addColumn("col3"); dg.addColumn("col4"); dg.addColumn("col5"); dg.addColumn("col6"); dg.addColumn("col7"); dg.dataProvider = dp; dg.horizontalScrollPolicy = ScrollPolicy.ON; dg.minColumnWidth = 185; addChild(dg); function getString():String { return "This string requires a wide column"; }
resizableColumns | propriété |
public var resizableColumns:Boolean = true
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 |
Indique si l’utilisateur peut modifier la taille des colonnes. La valeur true
indique que l’utilisateur peut modifier la taille de la colonne. La valeur false
indique une taille fixe.
Si cette valeur est true
, l’utilisateur peut agrandir ou rétrécir les colonnes du composant DataGrid en faisant glisser les lignes séparant les cellules d’en-tête. En outre, si cette valeur est true
, l’utilisateur peut redimensionner les colonnes, sauf si les propriétés resizeable
des différentes colonnes sont définies sur false
.
La valeur par défaut est true.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
resizableColumns
et sortableColumns
sur false
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var nameCol:DataGridColumn = new DataGridColumn("name"); nameCol.headerText = "NAME:"; nameCol.width = 120; var valueCol:DataGridColumn = new DataGridColumn("value"); valueCol.headerText = "VALUE:"; valueCol.width = 80; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name A", value:"Value A"}); myDataGrid.addItem({name:"Name B", value:"Value B"}); myDataGrid.addItem({name:"Name C", value:"Value C"}); myDataGrid.resizableColumns = false; myDataGrid.sortableColumns = false; myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
rowCount | propriété |
rowCount:uint
[override] 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 |
Lit ou définit le nombre de lignes au moins partiellement visibles dans la liste.
Implémentation
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
rowCount
:
import fl.controls.DataGrid; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.move(10, 10); myDataGrid.setSize(300, 200); addChild(myDataGrid); var fixedHeight:uint = Math.min(myDataGrid.rowCount, myDataGrid.length); myDataGrid.rowCount = fixedHeight; trace(myDataGrid.width, myDataGrid.height); // 300 105
rowHeight | propriété |
rowHeight:Number
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 la hauteur de chaque ligne du composant DataGrid, en pixels.
La valeur par défaut est 20.
Implémentation
public function get rowHeight():Number
public function set rowHeight(value:Number):void
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.managers.StyleManager; var dp:DataProvider = new DataProvider(); var totalEntries:uint = 42; var i:uint; for(i = 0; i < totalEntries; i++) { dp.addItem( { col1:Math.random(), col2:Math.random(), col3:Math.random() } ); } var smallText:TextFormat = new TextFormat(); smallText.size = 9; smallText.font = "Verdana"; var dg:DataGrid = new DataGrid(); dg.columns = ["col1", "col2", "col3"]; dg.rowHeight = 14; dg.move(10, 10); dg.setSize(400, 300); dg.dataProvider = dp; dg.setStyle("textFormat", smallText); addChild(dg); StyleManager.setStyle("textFormat", smallText);
showHeaders | propriété |
showHeaders: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 qui indique si le composant DataGrid affiche les en-têtes des colonnes. La valeur true
indique que le composant DataGrid affiche des en-têtes de colonne, tandis que false
indique le contraire.
La valeur par défaut est true.
Implémentation
public function get showHeaders():Boolean
public function set showHeaders(value:Boolean):void
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 42; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:Math.random(), col2:Math.random()}); } var dg1:DataGrid = new DataGrid(); dg1.move(10,10); dg1.setSize(200,300); dg1.dataProvider = dp; addChild(dg1); var dg2:DataGrid = new DataGrid(); dg2.move(250,10); dg2.setSize(200,300); dg2.dataProvider = dp; dg2.showHeaders = false; addChild(dg2);
sortableColumns | propriété |
public var sortableColumns:Boolean = true
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 |
Indique que l’utilisateur peut trier les éléments du fournisseur de données en cliquant sur une cellule d’en-tête de colonnes. Lorsque cette valeur est true
, l’utilisateur peut trier les éléments du fournisseur de données en cliquant sur une cellule d’en-tête de colonne. Ceci est impossible lorsque cette valeur est définie sur false
.
Lorsque cette valeur est true
définissez la propriété sortable
de cette colonne sur false
pour empêcher les colonnes de réagir lorsque l’utilisateur clique sur une cellule d’en-tête.
Le champ de tri d’une colonne correspond soit à la propriété dataField
ou sortCompareFunction
du composant DataGridColumn. Lorsque l’utilisateur clique plusieurs fois sur une colonne, l’opération de tri passe de croissant à décroissant en boucle.
Si cette propriété et la propriété sortable
d’une colonne sont définies sur true
, le composant DataGrid distribue un événement headerRelease
dès que l’utilisateur relâche le bouton de la souris sur la cellule d’en-tête. Si la méthode preventDefault()
d’une méthode de gestionnaire de l’événement headerRelease
n’est pas appelée, le composant DataGrid procède à un tri en fonction des valeurs des propriétés dataField
ou sortCompareFunction
.
La valeur par défaut est true.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
sortableColumns
sur false
pour que l’utilisateur ne puisse pas trier la liste :
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var data:XML = <dataProvider> <data col1="Person A" col2="11.383" /> <data col1="Person B" col2="3.399" /> <data col1="Person C" col2="25.624" /> </dataProvider> var dp:DataProvider = new DataProvider(data); var c1:DataGridColumn = new DataGridColumn("col1"); var c2:DataGridColumn = new DataGridColumn("col2"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(c1); myDataGrid.addColumn(c2); myDataGrid.dataProvider = dp; myDataGrid.move(10, 10); myDataGrid.setSize(160, 120); myDataGrid.sortableColumns = false; addChild(myDataGrid);
sortDescending | propriété |
sortDescending:Boolean
[lecture 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 |
Lit l’ordre de tri de la colonne lorsque l’utilisateur clique sur son en-tête. La valeur true
indique que cette colonne est triée par ordre décroissant et false
désigne l’ordre croissant.
La propriété sortDescending
n’a aucun effet sur le mode de tri. Par défaut, le tri se fait en tenant compte des majuscules et des minuscules. Pour modifier ce comportement, modifiez les propriétés sortOptions
et sortCompareFunction
de la classe DataGridColumn.
Remarque : si vous demandez cette propriété à l’écouteur de l’événement headerRelease
, la valeur de la propriété identifie l’ordre du tri de la précédente opération de tri. En effet, le tri suivant, n’a pas encore eu lieu.
La valeur par défaut est false.
Implémentation
public function get sortDescending():Boolean
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
headerRelease
et recherche les propriétés sortDescending
, sortIndex
et dataField
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dataXML:XML = <dataProvider> <data col1="Person A" col2="11.383" /> <data col1="Person B" col2="3.399" /> <data col1="Person C" col2="25.624" /> </dataProvider> var dp:DataProvider = new DataProvider(dataXML); var c1:DataGridColumn = new DataGridColumn("col1"); var c2:DataGridColumn = new DataGridColumn("col2"); c2.sortOptions = Array.NUMERIC; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(c1); myDataGrid.addColumn(c2); myDataGrid.dataProvider = dp; myDataGrid.width = 160; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler); addChild(myDataGrid); function headerReleaseHandler(event:DataGridEvent):void { var myDG:DataGrid = event.currentTarget as DataGrid; var whichColumn:DataGridColumn = myDG.getColumnAt(event.columnIndex); trace("sortDescending:", myDG.sortDescending); trace("sortIndex:", myDG.sortIndex); trace("dataField:", whichColumn.dataField); trace(""); }
sortIndex | propriété |
DataGrid | () | Constructeur |
public function DataGrid()
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 |
Crée une nouvelle occurrence du composant DataGrid.
addColumn | () | méthode |
public function addColumn(column:*):DataGridColumn
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 |
Ajoute une colonne à la fin du tableau columns
.
Paramètres
column:* — String ou objet DataGridColumn.
|
DataGridColumn — Objet DataGridColumn qui a été ajouté.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
addColumn()
:
import fl.controls.DataGrid; var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("name"); myDataGrid.addColumn("value"); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
addColumn()
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; var nameCol:DataGridColumn = new DataGridColumn("name"); var valueCol:DataGridColumn = new DataGridColumn("value"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); addChild(myDataGrid);
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { stateName:"California", stateAbbreviation:"CA" } ); dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } ); var dg:DataGrid = new DataGrid(); var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation")); var nameColumn:DataGridColumn = dg.addColumn("stateName"); abbreviationColumn.width = 100; nameColumn.width = 200; dg.move(10,10); dg.width = 300; dg.rowCount = 2; dg.dataProvider = dp; addChild(dg);
addColumnAt | () | méthode |
public function addColumnAt(column:*, index:uint):DataGridColumn
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 |
Insère une colonne à l’index spécifié dans le tableau columns
.
Paramètres
column:* — La chaîne ou l’objet DataGridColumn qui représente la colonne à insérer.
| |
index:uint — L’index de tableau qui identifie l’emplacement d’insertion de la colonne.
|
DataGridColumn — L’objet DataGridColumn qui a été inséré dans le tableau de colonnes.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { stateName:"California", stateAbbreviation:"CA" } ); dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } ); var dg:DataGrid = new DataGrid(); var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation")); var nameColumn:DataGridColumn = dg.addColumn("stateName"); abbreviationColumn.width = 100; nameColumn.width = 200; dg.move(10,10); dg.width = 300; dg.rowCount = 2; dg.dataProvider = dp; addChild(dg);
createItemEditor | () | méthode |
public function createItemEditor(colIndex:uint, rowIndex:uint):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 |
Exploite l’éditeur spécifié par la propriété itemEditor
pour créer un éditeur d’éléments pour le rendu de ces derniers à l’index de colonne et de ligne identifié par la propriété editedItemPosition
.
Cette méthode définit l’occurrence de l’éditeur sous forme de propriété itemEditorInstance
.
Vous ne pouvez appeler cette méthode que de l’intérieur de l’écouteur d’événement pour l’événement itemEditBegin
. Pour créer un éditeur à partir d’un autre code, définissez la propriété editedItemPosition
pour générer l’événement itemEditBegin
.
Paramètres
colIndex:uint — Index de la colonne de l’élément à modifier dans le fournisseur de données.
| |
rowIndex:uint — Index de la ligne de l’élément à modifier dans le fournisseur de données.
|
destroyItemEditor | () | méthode |
public function destroyItemEditor():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 |
Ferme l’éditeur d’éléments qui est en cours d’utilisation pour le rendu. Cette méthode est généralement appelée à partir de l’écouteur d’événement pour l’événement itemEditEnd
, après avoir appelé la méthode preventDefault()
pour empêcher l’exécution de l’écouteur d’événement par défaut.
editField | () | méthode |
public function editField(index:uint, dataField:String, data:Object):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 |
Modifie un champ ou une propriété dans le composant DataGrid.
Paramètres
index:uint — L’index de l’élément fournisseur de données à modifier.
| |
dataField:String — Nom du champ ou de la propriété de l’élément de fournisseur de données à modifier.
| |
data:Object — La nouvelle valeur de données.
|
Valeur émise
RangeError — L’index spécifié est inférieur à 0 ou supérieur ou égal à la longueur du fournisseur de données.
|
getCellRendererAt | () | méthode |
public function getCellRendererAt(row:uint, column:uint):ICellRenderer
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 une occurrence de la classe CellRenderer à la position spécifiée dans le composant DataGrid.
Remarque : cette méthode renvoie null
pour les positions qui ne sont pas visibles (placées hors de vue par le défilement).
Paramètres
row:uint — Index de ligne.
| |
column:uint — Index de colonne.
|
ICellRenderer — L’objet ICellRenderer à la position spécifiée ou null lorsque aucun objet ICellRenderer n’est présent à cet endroit.
|
getColumnAt | () | méthode |
public function getColumnAt(index:uint):DataGridColumn
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 la colonne qui est située à l’index spécifié du tableau columns
.
Paramètres
index:uint — L’index de la colonne à récupérer ou null si aucune colonne n’est trouvée.
|
DataGridColumn — L’objet DataGridColumn qui a été trouvé à l’index spécifié.
|
Eléments de l’API associés
getColumnCount | () | méthode |
public function getColumnCount():uint
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 le nombre de colonnes présentes dans le composant DataGrid.
Valeur renvoyéeuint — Nombre de colonnes présentes dans le composant DataGrid.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
columns
et de la méthode getColumnCount()
:
import fl.controls.DataGrid; import fl.controls.ScrollPolicy; import fl.data.DataProvider; var i:uint; var totalRows:uint = 16; var dp:DataProvider = new DataProvider(); for (i = 0; i < totalRows; i++) { dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()}); } var dg:DataGrid = new DataGrid(); dg.setSize(200, 300); dg.columns = ["col1", "col2", "col3"]; dg.dataProvider = dp; addChild(dg); trace("columns.length:", dg.columns.length); // 3 trace("getColumnCount():", dg.getColumnCount()); // 3 function getRandomNumber():uint { return Math.round(Math.random() * 100); }
columnStretch
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.events.DataGridEvent; var nameCol:DataGridColumn = new DataGridColumn("name"); var valueCol:DataGridColumn = new DataGridColumn("value"); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn(nameCol); myDataGrid.addColumn(valueCol); myDataGrid.addItem({name:"Name 1", value:"Value 1"}); myDataGrid.addItem({name:"Name 2", value:"Value 2"}); myDataGrid.addItem({name:"Name 3", value:"Value 3"}); myDataGrid.width = 200; myDataGrid.rowCount = myDataGrid.length; myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler); addChild(myDataGrid); function columnStretchHandler(event:DataGridEvent):void { var col:DataGridColumn; for each (col in myDataGrid.columns) { trace(col.dataField + ":", col.width + "px") } trace(""); }
getColumnIndex | () | méthode |
public function getColumnIndex(name:String):int
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 l’index de la colonne correspondant au nom spécifié, ou -1 lorsqu’il n’y a pas de correspondance.
Paramètres
name:String — Champ de données de la colonne à trouver.
|
int — L’index de l’emplacement auquel figure la colonne spécifiée.
|
Eléments de l’API associés
getStyleDefinition | () | méthode |
public static function getStyleDefinition():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 la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat
contient la valeur null
ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle()
pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat
dans le composant spécifié :
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Objet de styles par défaut.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToCellRenderer | () | méthode |
override public function itemToCellRenderer(item:Object):ICellRenderer
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 |
Comme le composant DataGrid comporte plusieurs cellules pour n’importe quel élément donné, la méthode itemToCellRenderer
renvoie toujours null
.
Paramètres
item:Object — Elément dans le fournisseur de données.
|
ICellRenderer — null .
|
removeAllColumns | () | méthode |
public function removeAllColumns():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 |
Supprime toutes les colonnes du composant DataGrid.
Eléments de l’API associés
removeColumnAt | () | méthode |
public function removeColumnAt(index:uint):DataGridColumn
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 |
Supprime la colonne qui est située à l’index spécifié du tableau columns
.
Paramètres
index:uint — Index de la colonne à supprimer.
|
DataGridColumn — Objet DataGridColumn qui a été supprimé. Cette méthode renvoie null si aucune colonne n’est trouvée à l’index spécifié.
|
Eléments de l’API associés
scrollToIndex | () | méthode |
override public function scrollToIndex(newCaretIndex:int):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 |
Fait féfiler la liste jusqu’à l’élément, à l’index spécifié. Lorsque l’index est hors de portée, la position de défilement ne change pas.
Paramètres
newCaretIndex:int — L’index auquel le défilement doit s’arrêter.
|
spaceColumnsEqually | () | méthode |
public function spaceColumnsEqually():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 |
Uniformise les largeurs des colonnes visibles.
columnStretch | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.COLUMN_STRETCH
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 |
Distribué lorsque l’utilisateur agrandit une colonne horizontalement.
La constanteDataGridEvent.COLUMN_STRETCH
définit la valeur de la propriété type
d’un objet de l’événement columnStretch
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | Nom du champ ou de la propriété des données associées à la colonne de l’élément. |
itemRenderer | Le rendu de l’en-tête de la colonne a été étiré. |
reason | null |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Exemple ( Comment utiliser cet exemple )
columnStretch
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler); addChild(myDataGrid); function columnStretchHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; var column:DataGridColumn; var columnArray:Array = dg.columns; var dgColWidth:String; trace("resized column:", event.dataField); trace("columnIndex:", event.columnIndex); for each (column in columnArray) { dgColWidth = Number(column.width / dg.width * 100).toFixed(1); trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)"); } trace("----------"); }
headerRelease | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.HEADER_RELEASE
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 |
Distribué lorsque l’utilisateur clique sur une cellule d’en-tête.
La constanteDataGridEvent.HEADER_RELEASE
définit la valeur de la propriété type
d’un objet de l’événement headerRelease
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | Nom du champ ou de la propriété des données associées à la colonne de l’élément. |
itemRenderer | Rendu d’en-tête sur lequel l’utilisateur a cliqué. |
reason | null |
rowIndex | -1 |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Exemple ( Comment utiliser cet exemple )
headerRelease
:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler); addChild(myDataGrid); function headerReleaseHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")"); trace("sortIndex:", dg.sortIndex); trace("sortDescending:", dg.sortDescending); trace("----------"); }
itemEditBegin | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_BEGIN
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 |
Distribué lorsque la propriété editedItemPosition
est définie et que l’élément peut être modifié.
DataGridEvent.ITEM__EDIT_BEGIN
définit la valeur de la propriété type
d’un objet de l’événement itemEditBegin
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | null |
itemRenderer | Rendu de l’élément à modifier. |
reason | null |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
itemEditBeginning | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_BEGINNING
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 |
Distribué lorsque l’utilisateur se prépare à modifier un élément, par exemple en y relâchant le bouton de sa souris.
La constanteDataGridEvent.ITEM__EDIT_BEGINNING
définit la valeur de la propriété type
d’un objet de l’événement itemEditBeginning
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | Nom du champ ou de la propriété des données associées à la colonne de l’élément. |
itemRenderer | Rendu de l’élément à modifier. |
reason | null |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
itemEditEnd | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.ITEM_EDIT_END
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 |
Distribué lorsqu’une session de modification d’élément se termine pour une raison quelconque.
La constanteDataGridEvent.ITEM_EDIT_END
définit la valeur de la propriété type
d’un objet de l’événement itemEditEnd
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | Nom du champ ou de la propriété des données associées à la colonne de l’élément. |
itemRenderer | Rendu de l’élément à modifier. |
reason | Constante qui justifie l’événement. La valeur doit être membre de la classe DataGridEventReason . |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
itemFocusIn | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.ITEM_FOCUS_IN
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 |
Distribué après qu’un élément reçoit le focus.
La constanteDataGridEvent.ITEM_FOCUS_IN
définit la valeur de la propriété type
d’un objet de l’événement itemFocusIn
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | null |
itemRenderer | Rendu de l’élément à modifier. |
reason | null |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
itemFocusOut | Evénement |
fl.events.DataGridEvent
propriété DataGridEvent.type =
fl.events.DataGridEvent.ITEM_FOCUS_OUT
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 |
Distribué après qu’un élément perd le focus.
La constanteDataGridEvent.ITEM_FOCUS_OUT
définit la valeur de la propriété type
d’un objet de l’événement itemFocusOut
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
columnIndex | Index de base zéro de la colonne d’en-tête dans le tableau columns de l’objet DataGrid. |
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. |
dataField | null |
itemRenderer | Rendu de l’élément à modifier. |
reason | null |
rowIndex | Index de base zéro de l’élément dans le fournisseur de données. |
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
Eléments de l’API associés
- Ajoutez le composant DataGrid dans votre bibliothèque.
- Enregistrez ce code sous le nom DataGridExample.as dans le même répertoire que votre fichier FLA.
- Dans le fichier FLA, définissez DocumentClass sur DataGridExample.
package { import flash.display.Sprite; import flash.events.Event; import flash.text.TextField; import fl.controls.DataGrid; public class DataGridExample extends Sprite { var sampleItem1:Object = { Name:"John Alpha", Number:"555-123-0101", Email:"jalpha@fictitious.com" }; var sampleItem2:Object = { Name:"Mary Bravo", Number:"555-372-3322", Email:"mbravo@fictitious.com" }; var sampleItem3:Object = { Name:"Trevor Gamma", Number:"555-485-1212", Email:"tgamma@fictitious.com" }; var sampleItem4:Object = { Name:"Susan Delta", Number:"555-987-3434", Email:"sdelta@fictitious.com" }; var dg:DataGrid; var tf1:TextField; var tf2:TextField; var tf3:TextField; public function DataGridExample() { createDataGrid(); createTextFields(); } private function createDataGrid():void { dg = new DataGrid(); dg.move(10,10); dg.setSize(500,125); dg.columns = ["Name","Number","Email"]; dg.addItem(sampleItem1); dg.addItem(sampleItem2); dg.addItem(sampleItem3); dg.addItem(sampleItem4); dg.addEventListener("change",gridItemSelected); dg.minColumnWidth = dg.width / 3; addChild(dg); } private function createTextFields():void { tf1 = new TextField(); tf2 = new TextField(); tf3 = new TextField(); tf1.x = tf2.x = tf3.x = 10; tf1.autoSize = tf2.autoSize = tf3.autoSize = "left"; tf1.y = 150; tf2.y = 175; tf3.y = 200; addChild(tf1); addChild(tf2); addChild(tf3); } private function gridItemSelected(e:Event):void { tf1.text = "Name: " + e.target.selectedItem.Name; tf2.text = "Number: " + e.target.selectedItem.Number; tf3.text = "Email: " + e.target.selectedItem.Email; } } }
Tue Jun 12 2018, 09:30 AM Z