Package | spark.components.gridClasses |
Classe | public class GridItemRenderer |
Héritage | GridItemRenderer Group GroupBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implémente | IGridItemRenderer |
Sous-classes | AXMEnterpriseGridHeaderRenderer, DataGridItemRenderer, DefaultGridHeaderRenderer, DefaultGridHeaderRenderer |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Les rendus d’élément sont associés à chaque colonne d’une grille. Définissez le rendu d’élément d’une colonne à l’aide de la propriété GridColumn.itemRenderer
.
Par défaut, un rendu d’élément ne s’écrête pas aux limites de la cellule. Si votre rendu s’étend au-delà des limites de la cellule, vous pouvez définir la valeur clipAndEnableScrolling
sur true
pour écrêter le rendu aux limites de la cellule.
Les transitions dans les rendus d’éléments DataGrid ne sont pas prises en charge. La classe GridItemRenderer ayant désactivé sa propriété transitions
, le fait de la définir n’aura aucun effet.
Considérations d’efficacité
Les performances de défilement et de démarrage des composants DataGrid sont directement liées à la complexité du rendu d’élément et au nombre de rendus d’élément visibles au sein du défilement DataGrid. Les instances GridItemRenderer personnalisées sont utilisées et réutilisées à plusieurs reprises. Il est donc important de les définir de la manière la plus simple et la plus efficace possible.
Si la responsabilité d’un rendu d’élément est limitée à l’affichage d’une ou plusieurs lignes de texte, les développeurs doivent envisager d’utiliser la classe DefaultItemRenderer, très économique pour cette opération (pour une application à déployer uniquement sur Windows, vous pouvez obtenir des performances supplémentaires en utilisant plutôt la classe UITextFieldGridItemRenderer). La manière la plus efficace d’utiliser GridItemRenderer pour afficher l’élément dataField du composant GridColumn sous forme de texte consiste à identifier l’élément d’affichage de texte du composant GridItemRenderer avec id="labelDisplay"
. Le composant labelDisplay doit être une sous-classe de TextBase
comme Label
ou RichText
. Vous pouvez suivre cette approche, au lieu d’utiliser simplement DefaultGridItemRenderer, si votre rendu d’élément comprend certains éléments supplémentaires qui ne dépendent pas des données du rendu d’élément, tels que les bordures ou d’autres éléments graphiques.
Un rendu d’élément contenant plusieurs éléments visuels dont les propriétés dépendent des données du rendu d’élément peut utiliser la liaison de données pour définir les valeurs de ces propriétés. Cette approche fournit du code MXML simple à lire et à entretenir et ses performances peuvent être suffisantes si le nombre de rendus d’élément visibles est limité (voir les propriétés requestedRowCount
et requestedColumnCount
du composant DataGrid). Le moyen le plus efficace pour configurer ce type de rendu d’élément consiste à remplacer sa méthode prepare()
et à effectuer le travail à cet endroit. La méthode prepare()
du rendu est appelée à chaque fois que le rendu est réaffiché et doit par conséquent être codée efficacement. Si votre rendu d’élément est avec état, par exemple s’il met en cache les valeurs internes, vous pouvez effacer son état dans sa méthode discard()
. La méthode discard()
est appelée à chaque fois que le rendu est déplacé vers la liste libre interne du composant DataGrid, où il reste disponible pour la réutilisation.
Les rendus GridItemRenderer doivent être aussi simples que possible. Pour obtenir les meilleures performances possibles, réduisez le nombre de composants et la profondeur de la hiérarchie. Si cela s’avère pratique, utilisez des positions et des tailles explicites plutôt que des contraintes pour définir la présentation. Les éléments DataGrid avec variableRowHeight="false"
(par défaut) tendent à donner de meilleurs résultats, tout comme pour showDataTips="false"
(par défaut) et clipAndEnableScrolling="false"
(par défaut).
Des exemples concernant les différentes configurations GridItemRenderer décrites ici sont disponibles dans la section des exemples.
Propriété MXML par défautmxmlContent
Eléments de l’API associés
spark.components.Grid
spark.components.gridClasses.GridColumn
spark.components.gridClasses.GridColumn.itemRenderer
spark.skins.spark.DefaultGridItemRenderer
Propriété | Défini par | ||
---|---|---|---|
accessibilityDescription : String
Accesseur pratique pour la propriété description de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | ||
accessibilityEnabled : Boolean
Accesseur pratique pour la propriété silent de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | ||
accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | ||
accessibilityName : String
Accesseur pratique pour la propriété name de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | ||
accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | ||
accessibilityShortcut : String
Accesseur pratique pour la propriété shortcut de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | ||
activeEffects : Array [lecture seule]
Liste des effets en cours de lecture sur le composant, sous forme d’un tableau d’instances EffectInstance. | UIComponent | ||
alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | ||
autoLayout : Boolean
Si la valeur est true, la mesure et la présentation sont effectuées lorsque la position ou la taille de l’enfant est modifiée. | GroupBase | ||
automationDelegate : Object
Objet délégué qui traite la fonction d’automatisation. | UIComponent | ||
automationEnabled : Boolean [lecture seule]
True si ce composant est activé pour l’automatisation, false dans le cas contraire. | UIComponent | ||
automationName : String
Nom pouvant être utilisé comme identifiant de cet objet. | UIComponent | ||
automationOwner : DisplayObjectContainer [lecture seule]
Propriétaire de ce composant à des fins d’automatisation. | UIComponent | ||
automationParent : DisplayObjectContainer [lecture seule]
Parent de ce composant à des fins d’automatisation. | UIComponent | ||
automationTabularData : Object [lecture seule]
Implémentation de l’interface IAutomationTabularData, qui peut être utilisée pour récupérer les données. | UIComponent | ||
automationValue : Array [lecture seule]
Cette valeur correspond généralement à l’apparence rendue de l’objet et doit être utilisable pour associer l’identifiant à l’objet lorsqu’il apparaît visuellement dans l’application. | UIComponent | ||
automationVisible : Boolean [lecture seule]
True si ce composant est visible pour l’automatisation, false dans le cas contraire. | UIComponent | ||
baseline : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
baselinePosition : Number [override] [lecture seule]
Coordonnée y de la ligne de base de la première ligne de texte du composant. | Group | ||
baselinePositionElement : IVisualElement
L’élément utilisé pour calculer la position de base de GroupBase
| Group | ||
blendMode : String [override]
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | Group | ||
blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | ||
bottom : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
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 | ||
cacheHeuristic : Boolean [écriture seule]
Utilisé par Flex pour suggérer la mise en cache sous forme de bitmap de l’objet. | UIComponent | ||
cachePolicy : String
Spécifie la stratégie de mise en cache sous forme de bitmap de cet objet. | UIComponent | ||
className : String [lecture seule]
Nom de la classe de cette instance, par exemple « Button ». | UIComponent | ||
clipAndEnableScrolling : Boolean
Si la valeur est true, indique d’écrêter les enfants aux limites de la fenêtre. | GroupBase | ||
column : GridColumn
L’objet GridColumn représentant la colonne associée à ce rendu d’élément. | GridItemRenderer | ||
columnIndex : int [lecture seule]
L’index de colonne de la cellule de ce rendu d’élément. | GridItemRenderer | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
contentHeight : Number [lecture seule]
La hauteur du contenu de la fenêtre d’affichage. | GroupBase | ||
contentMouseX : Number [lecture seule]
Renvoie la position x de la souris, dans le système de coordonnées du contenu. | UIComponent | ||
contentMouseY : Number [lecture seule]
Renvoie la position y de la souris, dans le système de coordonnées du contenu. | UIComponent | ||
contentWidth : Number [lecture seule]
La largeur du contenu de la fenêtre d’affichage. | GroupBase | ||
contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | ||
currentState : String
Etat d’affichage actuel du composant. | UIComponent | ||
cursorManager : ICursorManager [lecture seule]
Récupère le gestionnaire CursorManager qui contrôle le curseur pour ce composant et ses homologues. | UIComponent | ||
data : Object
La valeur de l’élément de fournisseur de données pour la rangée de la grille correspondant au rendu d’élément. | GridItemRenderer | ||
depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | UIComponent | ||
descriptor : UIComponentDescriptor
Référence à la classe UIComponentDescriptor, le cas échéant, utilisée par la méthode createComponentFromDescriptor() pour créer cette instance UIComponent. | UIComponent | ||
designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | UIComponent | ||
document : Object
Référence à l’objet de document associé à ce composant UIComponent. | UIComponent | ||
doubleClickEnabled : Boolean [override]
Spécifie si l’objet UIComponent reçoit les événements doubleClick. | UIComponent | ||
down : Boolean
Cette propriété est définie sur true lorsque l’un de deux gestes d’entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l’écran tactile est activé. | GridItemRenderer | ||
dragging : Boolean
Contient la valeur true si le rendu d’élément est en cours de glissement, généralement dans le cadre d’une opération glisser-déposer. | GridItemRenderer | ||
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 | ||
enabled : Boolean
Indique si le composant peut accepter une interaction de l’utilisateur. | UIComponent | ||
errorString : String
Texte affiché par le conseil d’erreur d’un composant lorsqu’un composant est surveillé par un programme de validation et que la validation échoue. | UIComponent | ||
explicitHeight : Number
Nombre définissant la hauteur explicite du composant en pixels, dans les coordonnées du composant. | UIComponent | ||
explicitMaxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
explicitMaxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
explicitMinHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
explicitMinWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
explicitWidth : Number
Nombre définissant la largeur explicite du composant en pixels, dans les coordonnées du composant. | UIComponent | ||
filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | ||
flexContextMenu : IFlexContextMenu
Menu contextuel pour ce composant UIComponent. | UIComponent | ||
focusEnabled : Boolean
Indique si le composant peut recevoir le focus par tabulation. | UIComponent | ||
focusManager : IFocusManager
Récupère le FocusManager qui contrôle le focus pour ce composant et ses homologues. | UIComponent | ||
focusPane : Sprite
Volet de focus associé à cet objet. | 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 | ||
grid : Grid [lecture seule]
Renvoie le contrôle Grid associé à ce rendu d’élément. | GridItemRenderer | ||
hasFocusableChildren : Boolean
Indicateur qui signale si les objets enfant peuvent recevoir le focus | UIComponent | ||
hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | UIComponent | ||
height : Number [override]
Nombre définissant la hauteur du composant en pixels, dans les coordonnées du parent. | UIComponent | ||
hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | ||
horizontalCenter : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
horizontalScrollPosition : Number
Coordonnée x de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut (0,0) correspond à l’angle supérieur gauche du composant. | GroupBase | ||
hovered : Boolean
Contient true si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL ou GridSelectionMode.MULTIPLE_CELLS, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW ou GridSelectionMode.MULTIPLE_ROWS. | GridItemRenderer | ||
id : String
ID du composant. | UIComponent | ||
includeInLayout : Boolean
Indique si ce composant est inclus dans la présentation du conteneur parent. | UIComponent | ||
inheritingStyles : Object
Début de la chaîne de styles hérités de ce composant. | UIComponent | ||
initialized : Boolean
Indicateur déterminant si un objet a traversé les trois phases de présentation : validation, mesure et présentation (si besoin était). | UIComponent | ||
instanceIndex : int [lecture seule]
Index d’un composant répété. | UIComponent | ||
instanceIndices : Array
Tableau contenant les indices requis pour faire référence à cet objet UIComponent à partir de son document parent. | UIComponent | ||
is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | UIComponent | ||
isDocument : Boolean [lecture seule]
Contient la valeur true si l’instance UIComponent est un objet document. | UIComponent | ||
isPopUp : Boolean
Défini sur true par le gestionnaire PopUpManager pour indiquer que composant a été ouvert sous forme de menu contextuel. | UIComponent | ||
label : String
Chaîne à afficher dans le rendu d’élément. | GridItemRenderer | ||
labelDisplay : spark.components.supportClasses:TextBase
Composant visuel facultatif dans le rendu d’élément pour l’affichage de la propriété label. | GridItemRenderer | ||
layout : LayoutBase
Objet de présentation de ce conteneur. | GroupBase | ||
layoutMatrix3D : Matrix3D [écriture seule]
Matrice de transformation utilisée pour calculer la présentation d’un composant par rapport à ses frères. | UIComponent | ||
left : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | ||
luminosityClip : Boolean
Propriété qui contrôle si le masque de luminosité écrête le contenu masqué. | GroupBase | ||
luminosityInvert : Boolean
Une propriété qui contrôle le calcul de la valeur de couleur RVB d’un élément graphique masqué par un masque de luminosité. | GroupBase | ||
maintainProjectionCenter : Boolean
Lorsque sa valeur est true, le composant garde sa matrice de projection centrée sur le milieu de son cadre de sélection. | UIComponent | ||
mask : DisplayObject [override]
Définit le masque. | GroupBase | ||
maskType : String
Type de masque. | GroupBase | ||
maxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
maxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
measuredHeight : Number
Hauteur par défaut du composant, en pixels. | UIComponent | ||
measuredMinHeight : Number
Hauteur minimale par défaut du composant, en pixels. | UIComponent | ||
measuredMinWidth : Number
Largeur minimale par défaut du composant, en pixels. | UIComponent | ||
measuredWidth : Number
Largeur par défaut du composant, en pixels. | UIComponent | ||
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 | ||
minHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
minWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | ||
moduleFactory : IFlexModuleFactory
Une fabrique de modules est utilisée comme contexte d’utilisation de polices intégrées et pour la recherche du gestionnaire de style qui contrôle les styles de ce composant. | UIComponent | ||
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 | ||
mouseEnabledWhereTransparent : Boolean
Lorsque la valeur est true, cette propriété s’assure que toutes les limites de l’instance Groupe répondent aux événements de souris (clics, survols, etc.). | GroupBase | ||
mouseFocusEnabled : Boolean
Indique si le composant peut recevoir le focus à l’aide de la souris. | 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 | ||
mxmlContent : Array [écriture seule]
Enfants de contenu visuel de cette instance Group. | Group | ||
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 | ||
nestLevel : int
Profondeur de cet objet dans la hiérarchie de confinement. | UIComponent | ||
nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | UIComponent | ||
numAutomationChildren : int [lecture seule]
Nombre d’enfants d’automatisation que ce conteneur comporte. | UIComponent | ||
numElements : int [lecture seule]
Nombre d’éléments visuels dans ce conteneur. | GroupBase | ||
opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | ||
overlay : DisplayLayer [lecture seule]
Plan d’incrustation de ce groupe. | GroupBase | ||
owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | UIComponent | ||
parent : DisplayObjectContainer [override] [lecture seule]
Conteneur ou composant parent de ce composant. | UIComponent | ||
parentApplication : Object [lecture seule]
Référence à l’objet d’application contenant cette instance UIComponent. | UIComponent | ||
parentDocument : Object [lecture seule]
Référence à l’objet de document parent pour ce composant UIComponent. | UIComponent | ||
percentHeight : Number
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. | UIComponent | ||
percentWidth : Number
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. | UIComponent | ||
postLayoutTransformOffsets : mx.geom:TransformOffsets
Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent. | UIComponent | ||
processedDescriptors : Boolean
Définie sur true après la création d’enfant immédiate ou différée, en fonction de celle effectuée. | UIComponent | ||
repeater : IRepeater [lecture seule]
Référence à l’objet Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | ||
repeaterIndex : int [lecture seule]
Index de l’élément dans le fournisseur de données de l’objet Repeater ayant produit ce composant UIComponent. | UIComponent | ||
repeaterIndices : Array
Tableau contenant les indices des éléments dans le fournisseur de données du des objets Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | ||
repeaters : Array
Tableau contenant des références aux objets Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | ||
resizeMode : String
Mode ResizeMode de ce conteneur. | GroupBase | ||
right : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
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 [override]
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | UIComponent | ||
rotationX : Number [override]
Indique la rotation de l’axe des x de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | ||
rotationY : Number [override]
Indique la rotation de l’axe des y de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | ||
rotationZ : Number [override]
Indique la rotation de l’axe des z de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | ||
rowIndex : int
L’index à base zéro de la ligne de la cellule faisant l’objet du rendu. | GridItemRenderer | ||
scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | ||
scaleGridBottom : Number
Spécifie la coordonnée inférieure de la grille d’échelle. | Group | ||
scaleGridLeft : Number
Spécifie la coordonnée gauche de la grille d’échelle. | Group | ||
scaleGridRight : Number
Spécifie la coordonnée droite de la grille d’échelle. | Group | ||
scaleGridTop : Number
Spécifie la coordonnée supérieure de la grille d’échelle. | Group | ||
scaleX : Number [override]
Nombre spécifiant le facteur de mise à l’échelle horizontale. | UIComponent | ||
scaleY : Number [override]
Nombre spécifiant le facteur de mise à l’échelle verticale. | UIComponent | ||
scaleZ : Number [override]
Nombre spécifiant le facteur de mise à l’échelle sur l’axe z. | UIComponent | ||
screen : Rectangle [lecture seule]
Renvoie un objet contenant la taille et la position de la surface de tracé de base pour cet objet. | UIComponent | ||
scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | ||
selected : Boolean
Contient la valeur true si la cellule du rendu d’élément fait partie de la sélection en cours. | GridItemRenderer | ||
showInAutomationHierarchy : Boolean
Indicateur qui détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. | UIComponent | ||
showsCaret : Boolean
Contient la valeur true si la cellule du rendu d’élément est indiquée par le caret. | GridItemRenderer | ||
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 | ||
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 | ||
states : Array
Etats d’affichage définis pour ce composant. | UIComponent | ||
styleDeclaration : CSSStyleDeclaration
Stockage pour les styles d’héritage intégrés sur cet objet. | UIComponent | ||
styleManager : IStyleManager2 [lecture seule]
Renvoie l’instance SystemManager utilisée par ce composant. | UIComponent | ||
styleName : Object
Style de classe utilisé par ce composant. | UIComponent | ||
styleParent : IAdvancedStyleClient
Le parent d’un composant permet d’évaluer les sélecteurs descendants. | UIComponent | ||
systemManager : ISystemManager
Renvoie l’objet SystemManager utilisé par ce composant. | UIComponent | ||
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 | ||
tabFocusEnabled : Boolean
Indicateur qui signale si cet objet peut recevoir le focus via la touche de tabulation. Cette fonction est similaire à la propriété tabEnabled utilisée par le lecteur Flash. Sa valeur est généralement true pour les composants qui gèrent l’entrée au clavier, mais certains composants des barres de contrôle les définissent sur false, car il est conseillé de ne pas voler le focus d’un autre composant (un éditeur, par exemple). | UIComponent | ||
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 | ||
toolTip : String
Texte à afficher dans l’info-bulle. | UIComponent | ||
top : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
transform : flash.geom:Transform [override]
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | UIComponent | ||
transformX : Number
Définit la coordonnée x du centre de la transformation du composant. | UIComponent | ||
transformY : Number
Définit la coordonnée y du centre de la transformation du composant. | UIComponent | ||
transformZ : Number
Définit la coordonnée z du centre de la transformation du composant. | UIComponent | ||
tweeningProperties : Array
Tableau de propriétés en cours d’interpolation sur cet objet. | UIComponent | ||
uid : String
Identifiant unique de l’objet. | UIComponent | ||
updateCompletePendingFlag : Boolean
Indicateur déterminant si un objet a traversé les trois phases de validation de mise en forme (si besoin était). | UIComponent | ||
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 | ||
validationSubField : String
Utilisé par un validateur pour associer un sous-champ à ce composant. | UIComponent | ||
verticalCenter : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | ||
verticalScrollPosition : Number
Coordonnée y de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut est (0,0) correspondant au coin supérieur gauche du composant. | GroupBase | ||
visible : Boolean [override]
Indique si l’objet d’affichage est visible ou non. | UIComponent | ||
width : Number [override]
Nombre définissant la largeur du composant en pixels, dans les coordonnées du parent. | UIComponent | ||
x : Number [override]
Nombre spécifiant la position horizontale du composant, en pixels, au sein de son conteneur parent. | UIComponent | ||
y : Number [override]
Nombre spécifiant la position verticale du composant, en pixels, au sein de son conteneur parent. | UIComponent | ||
z : Number [override]
Indique la position de coordonnée z le long de l’axe des z de l’instance DisplayObject par rapport au conteneur 3D parent. | UIComponent |
Méthode | Défini par | ||
---|---|---|---|
Constructeur. | GridItemRenderer | ||
Ajoute un élément visuel à ce conteneur. | Group | ||
Ajoute un élément visuel à ce conteneur. | Group | ||
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 client de style non visuel à cette instance de composant. | UIComponent | ||
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 | ||
Place en attente une fonction à appeler ultérieurement. | UIComponent | ||
Définit une propriété de style depuis cette instance 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 | ||
Détermine si l’objet IVisualElement spécifié est un enfant de l’instance du conteneur ou l’instance en tant que telle. | GroupBase | ||
Convertit un objet Point de coordonnées de contenu en coordonnées globales. | UIComponent | ||
Convertit un objet Point de coordonnées de contenu en coordonnées locales. | UIComponent | ||
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | ||
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | ||
Crée une référence id pour cet objet IUIComponent sur son objet document parent. | UIComponent | ||
Supprime la référence d’id à cet objet IUIComponent sur son objet de document parent. | UIComponent | ||
Renvoie un objet UITextFormat correspondant aux styles du texte pour ce composant UIComponent. | UIComponent | ||
Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible. | GridItemRenderer | ||
[override]
Distribue un événement dans le flux d’événements. | UIComponent | ||
Affiche ou masque l’indicateur de focus autour de ce composant. | UIComponent | ||
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Trace par programmation un rectangle dans l’objet Graphics de cet habillage. | UIComponent | ||
Appelé par l’instance d’effet lors de la fin de sa lecture sur le composant. | UIComponent | ||
Appelé par l’instance d’effet lors du début de sa lecture sur le composant. | UIComponent | ||
Termine tous les effets en cours de lecture sur le composant. | UIComponent | ||
Exécute toutes les liaisons dont l’objet UIComponent est la destination. | UIComponent | ||
Appelée après la fin de l’impression. | UIComponent | ||
Fournit l’objet d’automatisation à l’index spécifié. | UIComponent | ||
Fournit la liste d’objets d’automatisation. | UIComponent | ||
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 | ||
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | UIComponent | ||
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | UIComponent | ||
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | ||
Recherche les sélecteurs de type de cette instance UIComponent. | UIComponent | ||
Renvoie une valeur de contrainte de présentation, ce qui revient à obtenir le style de contrainte pour ce composant. | UIComponent | ||
Renvoie l’élément visuel à l’index spécifié. | GroupBase | ||
Renvoie la position d’index d’un élément visuel. | GroupBase | ||
Méthode pratique pour déterminer si la hauteur explicite ou mesurée doit être utilisée
| UIComponent | ||
Méthode pratique pour déterminer si la largeur explicite ou mesurée doit être utilisée
| UIComponent | ||
Récupère l’objet ayant actuellement le focus. | UIComponent | ||
Renvoie la modification de la position de défilement horizontal pour traiter différentes options de défilement. | GroupBase | ||
Renvoie la hauteur de présentation de l’élément. | UIComponent | ||
Renvoie la largeur de la présentation de l’élément. | UIComponent | ||
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | UIComponent | ||
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | UIComponent | ||
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | UIComponent | ||
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | UIComponent | ||
Renvoie la hauteur maximale de l’élément. | UIComponent | ||
Renvoie la largeur maximale de l’élément. | UIComponent | ||
Renvoie la hauteur minimale de l’élément. | UIComponent | ||
Renvoie la largeur minimale de l’élément. | UIComponent | ||
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 la hauteur préférée de l’élément. | UIComponent | ||
Renvoie la largeur préférée de l’élément. | UIComponent | ||
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 | ||
Renvoie l’élément de l’objet dataProvider utilisé par le composant Repeater spécifié pour produire ce composant Repeater, ou null si ce composant Repeater n’est pas répété. | UIComponent | ||
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant. | UIComponent | ||
Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement. | GroupBase | ||
Les présentations respectant l’indicateur useVirtualLayout utilisent cette méthode lors de l’exécution de la méthode updateDisplayList() pour obtenir des éléments de présentation « en vue », c’est-à-dire | GroupBase | ||
Convertit un objet Point de coordonnées globales en coordonnées de contenu. | UIComponent | ||
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 | ||
Renvoie true si la valeur currentCSSState n’est pas nulle. | UIComponent | ||
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 | ||
Détermine si l’état spécifié a été défini sur ce composant UIComponent. | UIComponent | ||
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 | ||
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé horizontal. | UIComponent | ||
Initialise la structure interne de ce composant. | UIComponent | ||
Initialise différentes propriétés qui effectuent le suivi des instances répétées de ce composant. | UIComponent | ||
Marque un composant de sorte que sa méthode updateDisplayList() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
Informe le composant hôte qu’un élément a été modifié et doit à nouveau être tracé. | Group | ||
Signale au composant hôte qu’un élément a été modifié et qu’il doit valider les propriétés. | Group | ||
Signale à l’hôte qu’une couche d’élément a été modifiée. | Group | ||
Signale au composant hôte qu’une taille d’élément a été modifiée. | Group | ||
Appelé par les éléments d’un composant pour indiquer que leur propriété de profondeur a changé. | UIComponent | ||
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. | UIComponent | ||
Marque un composant de sorte que sa méthode commitProperties() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
Marque un composant de sorte que sa méthode measure() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
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 | ||
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 un objet Point de coordonnées locales en coordonnées de contenu. | UIComponent | ||
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | ||
Renvoie la valeur true si cssState correspond à currentCSSState. | UIComponent | ||
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. | UIComponent | ||
Mesure le texte HTML spécifié, pouvant contenir des balises HTML telles que <font> et <b>, en supposant qu’il s’affiche sur un objet UITextField à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | ||
Mesure le texte spécifié, en supposant qu’il s’affiche sur un objet UITextField (ou UIFTETextField) à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | ||
Déplace le composant vers une position spécifiée dans son parent. | UIComponent | ||
Propage les modifications de style aux enfants. | UIComponent | ||
Renvoie true si la chaîne de propriétés du propriétaire pointe de l’enfant vers ce composant UIComponent. | UIComponent | ||
Appelé par Flex lorsqu’un composant UIComponent est ajouté à ou supprimé d’un parent. | UIComponent | ||
Appelé à partir de la méthode updateDisplayList() du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies. | GridItemRenderer | ||
Prépare un objet IFlexDisplayObject pour l’impression. | UIComponent | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Génère ou régénère le cache de style CSS pour ce composant et, si le paramètre recursive a la valeur true, pour tous les descendants de ce composant également. | UIComponent | ||
Pour chaque événement d’effet, enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement. | UIComponent | ||
Supprime tous les éléments visuels du conteneur. | Group | ||
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime l’élément visuel spécifié de la liste des enfants de ce conteneur. | Group | ||
Supprime un élément visuel du conteneur, à la position d’index spécifiée. | Group | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Supprime un client de style non visuel de cette instance de composant. | UIComponent | ||
Réexécute l’événement spécifié. | UIComponent | ||
Affiche un clavier virtuel. | InteractiveObject | ||
Résout un enfant en utilisant l’ID fourni. | UIComponent | ||
[statique]
Reprend le traitement en arrière-plan des méthodes mises en attente par la méthode callLater(), après un appel à la méthode suspendBackgroundProcessing(). | UIComponent | ||
Dimensionne l’objet. | UIComponent | ||
Définit une valeur de contrainte de présentation, ce qui revient à définir le style de contrainte pour ce composant. | UIComponent | ||
Définit les propriétés contentWidth et contentHeight. | GroupBase | ||
Définir l’état actuel. | UIComponent | ||
Modifie la position d’un élément visuel existant dans le conteneur visuel. | Group | ||
Définit le focus sur ce composant. | UIComponent | ||
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | UIComponent | ||
Définit la taille de la présentation de l’élément. | UIComponent | ||
Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères. | UIComponent | ||
Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères. | UIComponent | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit une propriété de style pour cette instance de composant. | UIComponent | ||
Appelé lorsque la propriété visible est modifiée. | UIComponent | ||
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 | ||
Détecte les modifications apportées aux propriétés de style. | UIComponent | ||
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés. | UIComponent | ||
[statique]
Bloque le traitement en arrière-plan des méthodes placées en attente par callLater(), jusqu’à l’appel de la méthode resumeBackgroundProcessing(). | UIComponent | ||
Intervertit l’index des deux éléments visuels spécifiés. | Group | ||
Intervertit les éléments visuels qui se trouvent aux deux positions d’index spécifiées dans le conteneur. | Group | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne indiquant l’emplacement de l’objet dans la hiérarchie des objets DisplayObject de l’application. | FlexSprite | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. | UIComponent | ||
Méthode utilitaire permettant de transformer un point spécifié dans les coordonnées locales de cet objet en emplacement dans les coordonnées du parent de l’objet. | UIComponent | ||
Valide la position et la taille des enfants, et trace d’autres effets visuels. | UIComponent | ||
Valide et actualise les propriétés et la présentation de cet objet, puis le retrace si nécessaire. | UIComponent | ||
Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). | UIComponent | ||
Valide la taille mesurée du composant si la méthode LayoutManager.invalidateSize() est appelée avec cette interface ILayoutManagerClient, puis la méthode validateSize() est appelée lorsqu’il est temps d’effectuer les mesures. | UIComponent | ||
Traite à la fois les événements valid et invalid d’une classe Validator assignée à ce composant. | UIComponent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé vertical. | UIComponent | ||
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 |
Méthode | Défini par | ||
---|---|---|---|
Ajuste le rectangle de focus. | UIComponent | ||
Valide la matrice calculée générée par combinaison de la matrice de présentation et des décalages de transformation de la transformation de l’objet flash displayObject. | UIComponent | ||
Il s’agit d’une méthode interne utilisée par la structure Flex pour prendre en charge l’effet Fondre. | UIComponent | ||
Détermine si l’appel à la méthode measure() peut être ignoré. | UIComponent | ||
Effectue les traitements finals éventuels après la création des objets enfant. | UIComponent | ||
Traite les propriétés définies sur le composant. | UIComponent | ||
[override]
Si l’objet de mise en page n’a pas encore été défini, createChildren() attribue à ce conteneur un objet de mise en page par défaut, BasicLayout.
| GroupBase | ||
Crée un nouvel objet à l’aide d’un contexte basé sur la police incorporée en cours d’utilisation. | UIComponent | ||
Crée l’objet à l’aide d’une fabrique moduleFactory donnée. | UIComponent | ||
Méthode d’assistance permettant la distribution d’un événement PropertyChangeEvent lorsqu’une propriété est actualisée. | UIComponent | ||
Gestionnaire d’événement appelé lorsqu’un objet UIComponent obtient le focus. | UIComponent | ||
Gestionnaire d’événement appelé lorsqu’un objet UIComponent perd le focus. | UIComponent | ||
Renvoie le nom de l’état à appliquer au rendu. | GridItemRenderer | ||
Initialise l’implémentation et le stockage de certaines des fonctions de présentation avancées d’un composant utilisées plus rarement. | UIComponent | ||
Termine l’initialisation de ce composant. | UIComponent | ||
Initialise le code d’accessibilité de ce composant. | UIComponent | ||
Méthode d’assistance permettant d’invalider la taille du parent et la liste d’affichage si cet objet affecte sa présentation (includeInLayout est défini sur true). | UIComponent | ||
Généralement remplacée par les composants contenant des objets UITextField, où l’objet UITextField obtient le focus. | UIComponent | ||
Gestionnaire d’événement appelé pour un événement keyDown. | UIComponent | ||
Gestionnaire d’événement appelé pour un événement keyUp. | UIComponent | ||
Calcule la taille par défaut du composant. Peut également calculer sa taille minimale par défaut. | UIComponent | ||
Cette méthode est appelée lors de la construction d’une classe UIComponent, puis chaque fois que ResourceManager envoie un événement « change » pour indiquer que les ressources localisées ont subi une modification. | UIComponent | ||
Spécifie un facteur d’étirement de transformation dans le sens horizontal et vertical. | UIComponent | ||
Cette méthode est appelée lorsqu’un état change pour vérifier si des styles spécifiques à l’état s’appliquent à ce composant. | UIComponent | ||
Trace l’objet et/ou dimensionne et place ses enfants. | UIComponent |
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é lorsque le composant est ajouté à un conteneur en tant que contenu enfant à l’aide de la méthode addChild(), addChildAt(), addElement() ou addElementAt(). | UIComponent | |||
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é 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’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 le composant a terminé sa construction, son traitement de propriétés, sa mesure, sa présentation et son tracé. | UIComponent | |||
Distribué après la modification de l’état d’affichage. | UIComponent | |||
Distribué après la modification de la propriété currentState, mais avant la modification de l’état d’affichage. | UIComponent | |||
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 | |||
Distribué lorsque la propriété data change. | GridItemRenderer | |||
[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 | |||
Distribué par l’initiateur de l’action glisser (le composant source des données en cours de déplacement) lorsque l’opération de glissement se termine, lorsque vous déposez les données glissées sur une cible de dépôt ou lorsque vous terminez l’opération de glisser-déposer sans avoir effectué un dépôt. | UIComponent | |||
Distribué par la cible de dépôt lorsque l’utilisateur libère le bouton de la souris au-dessus de la cible. | UIComponent | |||
Distribué par un composant lorsque l’utilisateur passe le pointeur de la souris sur le composant pendant une opération de déplacement. | UIComponent | |||
Distribué par le composant lorsque l’utilisateur effectue un déplacement en dehors du composant, mais ne dépose pas les données sur la cible. | UIComponent | |||
Distribué par un composant lorsque l’utilisateur déplace la souris en survolant le composant pendant une opération de glissement. | UIComponent | |||
Distribué par l’initiateur du déplacement lors du démarrage d’une opération de déplacement. | UIComponent | |||
Distribué après la fin d’un effet. | UIComponent | |||
Distribué juste avant le démarrage d’un effet. | UIComponent | |||
Distribué après l’arrêt d’un effet, ce qui se produit uniquement par l’appel de la méthode stop() sur l’effet. | UIComponent | |||
Distribué lorsqu’un élément visuel est ajouté à l’espace de contenu. | Group | |||
Distribué lorsqu’un élément visuel est supprimé de l’espace de contenu. | Group | |||
[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | |||
Distribué après l’entrée du composant dans un état d’affichage. | UIComponent | |||
[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | |||
Distribué juste avant que le composant quitte un état d’affichage. | UIComponent | |||
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é lorsqu’un objet passe de l’état visible à l’état invisible. | UIComponent | |||
Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | |||
Distribué lorsque le composant a terminé sa construction et dispose de toutes les propriétés d’initialisation définies. | UIComponent | |||
Distribué si un composant est contrôlé par un validateur et que la validation a échoué. | UIComponent | |||
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é par un composant ouvert à l’aide du gestionnaire PopUpManager lorsque l’utilisateur clique en dehors du composant. | UIComponent | |||
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é à partir d’un composant ouvert à l’aide du gestionnaire PopUpManager lorsque l’utilisateur fait défiler la molette de la souris en dehors de celui-ci. | UIComponent | |||
Distribué lorsque l’objet a été déplacé. | 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é au début de la séquence d’initialisation du composant. | UIComponent | |||
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é lorsque le composant est supprimé d’un conteneur en tant que contenu enfant en utilisant la méthode removeChild(), removeChildAt(), removeElement() ou removeElementAt(). | UIComponent | |||
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é lorsque le composant est redimensionné. | 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 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é 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é lorsqu’un objet passe de l’état invisible à l’état 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é après le basculement du composant dans un nouvel état et après la lecture de toute animation de transition d’état vers cet état. | UIComponent | |||
Distribué lorsqu’un composant interrompt une transition à son état actuel afin de basculer dans un nouvel état. | UIComponent | |||
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é par le composant lorsqu’il est nécessaire de créer un composant ToolTip. | UIComponent | |||
Distribué par le composant lorsque son objet ToolTip a été masqué et va être rapidement supprimé. | UIComponent | |||
Distribué par le composant lorsque son composant ToolTip est sur le point d’être masqué. | UIComponent | |||
Distribué par le composant lorsque son composant ToolTip est sur le point d’être affiché. | UIComponent | |||
Distribué par le composant lorsque son composant ToolTip a été affiché. | UIComponent | |||
Distribué par un composant dont la propriété toolTip est définie, dès que l’utilisateur le survole avec la souris. | UIComponent | |||
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 | |||
Evénement non annulable, distribué par un composant lorsque celui-ci a terminé de réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | |||
Evénement non annulable, distribué par un composant lorsque celui-ci commence à réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | |||
Evénement annulable, distribué par un composant tentant de réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | |||
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 | |||
Distribué lorsque les méthodes commitProperties(), measure() et updateDisplayList() d’un objet ont été appelées (si nécessaire). | UIComponent | |||
Distribué si un composant est contrôlé par un validateur et que la validation a réussi. | UIComponent | |||
Distribué lorsque les valeurs sont modifiées soit par programmation, soit par interaction de l’utilisateur. | UIComponent |
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.
column | propriété |
column:GridColumn
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Objet GridColumn représentant la colonne associée à ce rendu d’élément.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement columnChanged
.
Implémentation
public function get column():GridColumn
public function set column(value:GridColumn):void
columnIndex | propriété |
columnIndex:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
L’index de colonne de la cellule de ce rendu d’élément. Il s’agit de la même valeur que column.columnIndex
.
Implémentation
public function get columnIndex():int
data | propriété |
data:Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
La valeur de l’élément de fournisseur de données pour la rangée de la grille correspondant au rendu d’élément. Cette valeur correspond à l’objet renvoyé par un appel à la méthode dataProvider.getItemAt(rowIndex)
.
Les rendus d’élément peuvent remplacer cette définition de propriété pour accéder aux données de la rangée entière de la grille.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataChange
.
Implémentation
public function get data():Object
public function set data(value:Object):void
down | propriété |
down:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Cette propriété est définie sur true
lorsque l’un de deux gestes d’entrée se produit dans une cellule de la grille : soit le bouton de la souris, soit l’écran tactile est activé. La propriété down
est réinitialisée sur false
lorsque le bouton de la souris est relâché, l’utilisateur libère l’écran tactile ou le curseur/toucher est déplacé hors de la cellule de la grille.
Contrairement à un rendu d’élément de liste, les rendus d’élément de grille ne possèdent pas la responsabilité exclusive de l’affichage de l’indicateur vers le bas. La grille elle-même effectue le rendu de l’indicateur vers le bas pour la ligne ou la cellule sélectionnée. Le rendu d’élément peut également modifier ses propriétés visuelles pour mettre en évidence qu’il est actuellement sélectionné.
La valeur par défaut est false.
Implémentation
public function get down():Boolean
public function set down(value:Boolean):void
dragging | propriété |
dragging:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Contient la valeur true
si le rendu d’élément est en cours de glissement, généralement dans le cadre d’une opération glisser-déposer. Actuellement, le glisser-déposer n’est pas pris en charge par le contrôle Spark DataGrid.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement draggingChanged
.
Implémentation
public function get dragging():Boolean
public function set dragging(value:Boolean):void
grid | propriété |
hovered | propriété |
hovered:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Contient true
si le rendu d’élément se trouve sous la souris et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_CELL
ou GridSelectionMode.MULTIPLE_CELLS
, ou si le pointeur de la souris se trouve dans la rangée à laquelle appartient le rendu d’élément et que le mode selectionMode de la grille est GridSelectionMode.SINGLE_ROW
ou GridSelectionMode.MULTIPLE_ROWS
.
Contrairement à un rendu d’élément de liste, les rendus d’élément de grille n’ont pas la responsabilité exclusive d’afficher un élément indiquant que le rendu ou sa ligne sont situés sous la souris. La grille elle-même affiche automatiquement la partie d’habillage hoverIndicator pour la ligne ou la cellule survolée. Les rendus d’élément de grille peuvent également modifier leurs propriétés pour mettre en évidence qu’ils sont survolés.
La valeur par défaut est false.
Implémentation
public function get hovered():Boolean
public function set hovered(value:Boolean):void
label | propriété |
label:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Chaîne à afficher dans le rendu d’élément.
La classe GridItemRenderer copie automatiquement la valeur de cette propriété vers la propriété text
de son élément labelDisplay
, si cet élément a été spécifié. Le contrôle Grid définit la propriété label
sur la valeur renvoyée par la méthode itemToLabel()
de la colonne.
La valeur par défaut est "".
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelChanged
.
Implémentation
public function get label():String
public function set label(value:String):void
labelDisplay | propriété |
labelDisplay:spark.components.supportClasses:TextBase
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Composant visuel facultatif dans le rendu d’élément pour l’affichage de la propriété label
. Si vous utilisez cette propriété pour spécifier un composant visuel, la propriété text
du composant est maintenue synchronisée avec la propriété label
du rendu d’élément.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelDisplayChanged
.
Implémentation
public function get labelDisplay():spark.components.supportClasses:TextBase
public function set labelDisplay(value:spark.components.supportClasses:TextBase):void
rowIndex | propriété |
rowIndex:int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
L’index de base zéro de la rangée de la cellule faisant l’objet du rendu.
La valeur par défaut est -1.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement rowIndexChanged
.
Implémentation
public function get rowIndex():int
public function set rowIndex(value:int):void
selected | propriété |
selected:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Contient la valeur true
si la cellule du rendu d’élément fait partie de la sélection en cours.
Contrairement à un rendu d’élément de liste, les rendus d’élément de grille n’ont pas la responsabilité exclusive d’afficher un élément indiquant qu’ils font partie de la sélection. La grille elle-même affiche automatiquement la partie d’habillage selectionIndicator pour les lignes ou les cellules sélectionnées. Le rendu d’élément peut également modifier ses propriétés visuelles pour souligner qu’elle fait partie de la sélection.
La valeur par défaut est false.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement selectedChanged
.
Implémentation
public function get selected():Boolean
public function set selected(value:Boolean):void
showsCaret | propriété |
showsCaret:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Contient la valeur true
si la cellule du rendu d’élément est indiquée par le caret.
Contrairement à un rendu d’élément de liste, les rendus d’élément de grille n’ont pas la responsabilité exclusive d’afficher un élément indiquant que leur cellule ou ligne a le signe d’insertion. La grille elle-même affiche automatiquement la partie d’habillage caretIndicator pour la ligne ou la cellule du signe d’insertion. Le rendu d’élément peut également modifier ses propriétés visuelles pour mettre en évidence qu’il a le signe d’insertion.
La valeur par défaut est false.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement showsCaretChanged
.
Implémentation
public function get showsCaret():Boolean
public function set showsCaret(value:Boolean):void
GridItemRenderer | () | Constructeur |
public function GridItemRenderer()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Constructeur.
discard | () | méthode |
public function discard(willBeRecycled:Boolean):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Appelé à partir de la méthode updateDisplayList()
du parent du rendu d’élément une fois qu’il a été déterminé que ce rendu ne sera plus visible. Si le paramètre willBeRecycled
a la valeur true
, le propriétaire ajoute ce rendu à sa liste libre interne en vue de le réutiliser. Les implémentations peuvent utiliser cette méthode pour effacer toute propriété de rendu qui n’est plus nécessaire.
Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l’implémentation DataGrid.
Paramètres
willBeRecycled:Boolean — true si ce rendu est destiné à être ajouté à la liste libre interne du propriétaire en vue d’être réutilisé.
|
getCurrentRendererState | () | méthode |
protected function getCurrentRendererState():String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Renvoie le nom de l’état à appliquer au rendu. Par exemple, un rendu d’élément élémentaire renvoie la chaîne "normal", "hovered" ou "selected" pour spécifier l’état du rendu. Dans le cas d’interactions tactiles (ou d’interactions de souris dans lesquelles la sélection est ignorée), les états "down" et "downAndSelected" peuvent également être renvoyés.
Une sous-classe de GridItemRenderer doit remplacer cette méthode pour renvoyer une valeur si le comportement souhaité est différent du comportement par défaut.
Dans Flex 4.0, les 3 états principaux étaient "normal", "hovered" et "selected". Dans Flex 4.5, "down" et "downAndSelected" ont été ajoutés.
L’ensemble complet des états pris en charge (par ordre de priorité) est le suivant :
- dragging
- downAndSelected
- selectedAndShowsCaret
- hoveredAndShowsCaret
- normalAndShowsCaret
- down
- selected
- hovered
- normal
String — Chaîne spécifiant le nom de l’état à appliquer au rendu.
|
prepare | () | méthode |
public function prepare(hasBeenRecycled:Boolean):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Appelé à partir de la méthode updateDisplayList()
du parent du rendu d’élément une fois que toutes les propriétés du rendu ont été définies. Le paramètre hasBeenRecycled
a la valeur false
si ce rendu n’a pas été utilisé avant, ce qui signifie qu’il n’a pas été recyclé. Cette méthode est appelée lorsqu’un rendu est sur le point de devenir visible et chaque fois qu’il est réaffiché en raison d’une modification d’une propriété du rendu ou du fait qu’un réaffichage a été explicitement demandé.
Cette méthode peut être utilisée pour configurer tous les éléments visuels et les propriétés d’un rendu. L’utilisation de cette méthode peut être plus efficace que la liaison des propriétés data
des propriétés aux propriétés d’élément visuel. Remarque : puisque la méthode prepare()
est appelée fréquemment, assurez-vous qu’elle est codée de manière efficace.
La méthode prepare()
peut être appelée à de nombreuses reprises avant que la méthode discard()
soit appelée.
Cette méthode n’est pas destinée à être appelée directement. Elle est appelée par l’implémentation DataGrid.
Paramètres
hasBeenRecycled:Boolean — true si ce rendu est réutilisé.
|
dataChange | Evénement |
mx.events.FlexEvent
propriété FlexEvent.type =
mx.events.FlexEvent.DATA_CHANGE
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Distribué lorsque la propriété data
change.
FlexEvent.DATA_CHANGE
définit la valeur de la propriété type
de l’objet d’événement d’un événement dataChange
.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget . |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget . |
<?xml version="1.0" encoding="utf-8"?> <!-- Demonstate how to control text wrapping in DataGrid GridItemRenderer item renderer. This DataGrid example demonstrates how to control text wrapping with a simple custom item renderer based on GridItemRenderer. All cells in this example display the same lengthy string which does not contain newlines. Note that the Flex text components unconditionally render newline characters that appear in the text. The "Label Renderer" column's renderer is a custom GridItemRenderer that displays its text with an s:Label component. We use the Label's maxDisplayedLines property to control line breaking and to include "..." truncation when the single line of text doesn't fit. Note also: this example's column widths and row heights are defined by the DataGrid's typicalItem. The typical item uses explicit newlines to create a string that occupies three lines and a reasonable column width. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Declarations> <fx:String id="sampleText">Lorem Ipsum is the standard dummy text of the typesetting industry.</fx:String> <fx:int id="maxDisplayedLines">0</fx:int> </fx:Declarations> <s:Panel title="Spark DataGrid Control Example which demonstrates how to control text wrapping in a GridItemRenderer" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:controlBarContent> <s:VGroup> <s:CheckBox id="vrh" selected="@{dataGrid.variableRowHeight}" label="dataGrid.variableRowHeight={vrh.selected}"/> <s:CheckBox id="lb" selected="true" valueCommit="maxDisplayedLines=(lb.selected) ? 0 : 1" label="labelRenderer.maxDisplayedLines={maxDisplayedLines}"/> </s:VGroup> </s:controlBarContent> <s:DataGrid id="dataGrid" variableRowHeight="false" verticalCenter="0" horizontalCenter="0"> <s:columns> <s:ArrayList> <!-- Simple custom item renderer based on GridItemRenderer and Label. Prevent line breaking by setting maxDisplayedLines="1". --> <s:GridColumn dataField="value" headerText="Label Renderer"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer> <s:Label id="labelDisplay" left="5" top="9" right="5" bottom="5" maxDisplayedLines="{outerDocument.maxDisplayedLines}"/> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> </s:ArrayList> </s:columns> <!-- The typicalItem defines column widths and the default row height. The text occpies two lines because we've used '\n' to introduce two newlines. Alternatively we could have used the odd XML ' ' escape to introduce two newlines (the value of the newline character is decimal 10). <s:DataItem value="Lorem Ipsum sample text. Lorem Ipsum sample text. "/> --> <s:typicalItem> <s:DataItem value="{'Lorem Ipsum sample text.\nLorem Ipsum sample text\n'}"/> </s:typicalItem> <s:ArrayCollection> <s:DataItem value="{sampleText}"/> <s:DataItem value="{sampleText}"/> <s:DataItem value="{sampleText}"/> </s:ArrayCollection> </s:DataGrid> </s:Panel> </s:Application>
<?xml version="1.0" encoding="utf-8"?> <!-- Examples of custom GridItemRenderers that use data binding to configure visual properties. The application's control bar slider can be used to change the the dataProvider items. The GridItemRenderer class is a Group that implements IGridItemRenderer and can be used as the top level "container" for a custom item renderer. Its data property is the dataProvider item for the row the item renderer appears on and its components can configure themselves by binding to the data property, or by overriding the renderer's prepare() method and configuring themselves imperatively with ActionScript code. All of the item renderers in this example use binding, which makes the code a little easier to read and modify. It's also less efficient than using a prepare() method override. The performance difference is most noticeable when the DataGrid is configured so that a large number of item renderers are visible. DataGrid item renderers are always sized to exactly fit the cell that they're rendering: their size matches the width of their column and the height of their row. The DataGrid enables interactive column resizing by default, so all of the item renderers need to defend against the possibility that their width will become arbitrarily small. The first column's item renderer just contains a Label. By specifying maxDisplayedLines="1" we ensure that the Label will truncate its text to fit the width it's given. The other columns' item renderers specify clipAndEnableScrolling="true" which just means that their fixed size contents will always be clipped to the bounds of the GridItemRenderer. This property -enables- scrolling, which means that one could actually scroll the contents of the item renderers when their width gets small, by setting the renderer's horizontalScrollPosition property. We do not do as much here. The "Name" column's item renderer demonstrates a special case: if the renderer contains a text component with id="labelDisplay", GridItemRenderer automatically sets the labelDisplay's text property to the value of data[column.dataField] per the GridItemRenderer label property. The first colunm also demonstrates using the styleName property to configure the Label's left, right, top, and fontSize styles. The "Statistics" column's item renderer demonstrates how binding can be used to configure the geometry of graphic elememnts. The data items' min, max, and value properties have been normalized to the range [0 100] to keep the bindings simple. The "Value" column's item renderer allows one to change data item's value property with a Slider. The "Call" column's item renderer demonstrates a slightly more complicated component layout and it also demonstates how the data item's value can be both displayed and edited. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Script> <![CDATA[ // Incrementally change all of the date items' min, max, value, and call properties. private function changeData(delta:Number):void { for each (var item:Object in dataGrid.dataProvider) { item.value = (item.value + delta) % 100; item.min = item.value * 0.5; item.max = item.value + ((100 - item.value) * 0.5); item.call = item.value > 50; } } ]]> </fx:Script> <fx:Style> .nameColumn { fontSize: 18; left: 5; right: 5; top: 9; } </fx:Style> <s:Panel title="Spark DataGrid Control Example of custom GridItemRenderers that use data binding to configure visual properties" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:controlBarContent> <s:HGroup verticalAlign="baseline"> <s:Label text="Shake Data"/> <s:HSlider id="hsl" minimum="0" maximum="25" change="changeData(hsl.value)"/> </s:HGroup> </s:controlBarContent> <s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5"> <s:columns> <s:ArrayList> <!-- By specifying id="labelDisplay" the Label component's text property is automatically set to the renderer's label, which is effectively the value of the item's name property. We've used styleName here to refer to a set of styles that could have also have been set inline. --> <s:GridColumn dataField="name" headerText="Name"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer> <s:Label id="labelDisplay" maxDisplayedLines="1" styleName="nameColumn"/> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <!-- This column's renderer displays the item's value, min, and max properties with a simple dial and bar chart defined with graphic primitives. The bar chart s:Rect elements specify scaleY="-1" so that the rectangles grow from the bottom of the renderer upwards. To keep things simple, most of the elements geometry is specified explicitly. Note also that min, max, and value have all been normalized to [0, 100]. --> <s:GridColumn dataField="value" headerText="Statistics"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <s:Group left="5" top="5" bottom="5"> <s:Ellipse x="0" y="0" width="30" height="30"> <s:stroke> <s:SolidColorStroke color="0x272F32" weight="2"/> </s:stroke> <s:fill> <s:SolidColor color="0x9DBDC6"/> </s:fill> </s:Ellipse> <s:Line rotation="{(data.value / 100) * 360}" transformX="15" transformY="15" xFrom="15" yFrom="15" xTo="27" yTo="15"> <s:stroke> <s:SolidColorStroke color="0xFF3D2E" weight="3"/> </s:stroke> </s:Line> <s:Rect x="40" y="30" scaleY="-1" width="15" height="{(data.min / 100) * 30}"> <s:fill> <s:SolidColor color="0xFF3D2E"/> </s:fill> </s:Rect> <s:Rect x="60" y="30" scaleY="-1" width="15" height="{(data.max / 100) * 30}"> <s:fill> <s:SolidColor color="0xFF3D2E"/> </s:fill> </s:Rect> </s:Group> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <!-- This column's renderer displays the data item's value property with a slider. The binding is specified with "@{data.value}", which indicates that it's bidirection, so changing the slider also changes the dataProvider item. --> <s:GridColumn dataField="value" headerText="Value"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <s:HSlider left="5" right="5" verticalCenter="0" minimum="{data.min}" maximum="{data.max}" value="@{data.value}"/> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <!-- Display the boolean data item call property with a checkbox, radio button, and a text field. The call value can be changed with the checkbox. --> <s:GridColumn dataField="call" headerText="Call"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <s:HGroup left="5" top="9" right="5" verticalAlign="baseline"> <s:CheckBox selected="@{data.call}"/> <s:RadioButton selected="{data.call}" enabled="false"/> <s:TextInput text="{data.call}" enabled="false"/> </s:HGroup> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> </s:ArrayList> </s:columns> <s:ArrayCollection> <s:DataItem min="10" max="85" value="15" name="Abrasive" price="100.11" call="false"/> <s:DataItem min="15" max="75" value="25" name="Brush" price="110.01" call="true"/> <s:DataItem min="30" max="65" value="45" name="Clamp" price="120.02" call="false"/> <s:DataItem min="20" max="85" value="65" name="Drill" price="130.03" call="true"/> <s:DataItem min="40" max="95" value="85" name="Epoxy" price="140.04" call="false"/> <s:DataItem min="70" max="99" value="95" name="File" price="150.05" call="true"/> <s:DataItem min="60" max="85" value="80" name="Gouge" price="160.06" call="false"/> <s:DataItem min="40" max="70" value="60" name="Hook" price="170.07" call="true"/> <s:DataItem min="10" max="40" value="20" name="Ink" price="180.08" call="false"/> <s:DataItem min="5" max="30" value="10" name="Jack" price="190.09" call="true"/> </s:ArrayCollection> </s:DataGrid> </s:Panel> </s:Application>
<?xml version="1.0" encoding="utf-8"?> <!-- Examples of custom GridItemRenderers that use the prepare() method to configure visual properties. This example is identical to DataGridCustomBindingRenderer.as except that instead of using data bindings, all visual elements are configured by GridItemRenderer/prepare() method overrides. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Script> <![CDATA[ // Incrementally change all of the date items' min, max, value, and call properties. private function changeData(delta:Number):void { for each (var item:Object in dataGrid.dataProvider) { item.value = (item.value + delta) % 100; item.min = (item.min + delta) % 100; item.max = (item.max + delta) % 100; item.call = item.value > 50; } } ]]> </fx:Script> <fx:Style> .nameColumn { fontSize: 18; left: 5; right: 5; top: 9; } </fx:Style> <s:Panel title="Spark DataGrid Control Example of custom GridItemRenderers that use the prepare() method to configure visual properties" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:controlBarContent> <s:HGroup verticalAlign="baseline"> <s:Label text="Shake Data"/> <s:HSlider id="hsl" minimum="0" maximum="50" change="changeData(hsl.value)"/> </s:HGroup> </s:controlBarContent> <s:DataGrid id="dataGrid" left="5" right="5" top="5" bottom="5"> <s:columns> <s:ArrayList> <s:GridColumn dataField="name" headerText="Name"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer> <fx:Script> <![CDATA[ override public function prepare(hasBeenRecycled:Boolean):void { nameLabel.text = data.name; } ]]> </fx:Script> <s:Label id="nameLabel" maxDisplayedLines="1" styleName="nameColumn"/> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <s:GridColumn dataField="value" headerText="Statistics"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <fx:Script> <![CDATA[ override public function prepare(hasBeenRecycled:Boolean):void { valueDial.rotation = (data.value / 100) * 360; minBar.height = (data.min / 100) * 30; maxBar.height = (data.max / 100) * 30; } ]]> </fx:Script> <s:Group left="5" top="5" bottom="5"> <s:Ellipse x="0" y="0" width="30" height="30"> <s:stroke> <s:SolidColorStroke color="0x272F32" weight="2"/> </s:stroke> <s:fill> <s:SolidColor color="0x9DBDC6"/> </s:fill> </s:Ellipse> <s:Line id="valueDial" transformX="15" transformY="15" xFrom="15" yFrom="15" xTo="27" yTo="15"> <s:stroke> <s:SolidColorStroke color="0xFF3D2E" weight="3"/> </s:stroke> </s:Line> <s:Rect id="minBar" x="40" y="30" scaleY="-1" width="15"> <s:fill> <s:SolidColor color="0xFF3D2E"/> </s:fill> </s:Rect> <s:Rect id="maxBar" x="60" y="30" scaleY="-1" width="15"> <s:fill> <s:SolidColor color="0xFF3D2E"/> </s:fill> </s:Rect> </s:Group> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <s:GridColumn dataField="value" headerText="Value"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <fx:Script> <![CDATA[ override public function prepare(hasBeenRecycled:Boolean):void { valueSlider.minimum = data.min; valueSlider.maximum = data.max; valueSlider.value = data.value; } private function valueChange():void { data.value = valueSlider.value; } ]]> </fx:Script> <s:HSlider id="valueSlider" left="5" right="5" verticalCenter="0" change="valueChange()"/> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> <s:GridColumn dataField="call" headerText="Call"> <s:itemRenderer> <fx:Component> <s:GridItemRenderer clipAndEnableScrolling="true"> <fx:Script> <![CDATA[ override public function prepare(hasBeenRecycled:Boolean):void { callCheckBox.selected = data.call; callRadioButton.selected = data.call; callTextInput.text = String(data.call); } private function valueChange():void { data.call = callCheckBox.selected; } ]]> </fx:Script> <s:HGroup left="5" top="9" right="5" verticalAlign="baseline"> <s:CheckBox id="callCheckBox" change="valueChange()"/> <s:RadioButton id="callRadioButton" enabled="false"/> <s:TextInput id="callTextInput" enabled="false"/> </s:HGroup> </s:GridItemRenderer> </fx:Component> </s:itemRenderer> </s:GridColumn> </s:ArrayList> </s:columns> <s:ArrayCollection> <s:DataItem min="10" max="85" value="15" name="Abrasive" price="100.11" call="false"/> <s:DataItem min="15" max="75" value="25" name="Brush" price="110.01" call="true"/> <s:DataItem min="30" max="65" value="45" name="Clamp" price="120.02" call="false"/> <s:DataItem min="20" max="85" value="65" name="Drill" price="130.03" call="true"/> <s:DataItem min="40" max="95" value="85" name="Epoxy" price="140.04" call="false"/> <s:DataItem min="70" max="99" value="95" name="File" price="150.05" call="true"/> <s:DataItem min="60" max="85" value="80" name="Gouge" price="160.06" call="false"/> <s:DataItem min="40" max="70" value="60" name="Hook" price="170.07" call="true"/> <s:DataItem min="10" max="40" value="20" name="Ink" price="180.08" call="false"/> <s:DataItem min="5" max="30" value="10" name="Jack" price="190.09" call="true"/> </s:ArrayCollection> </s:DataGrid> </s:Panel> </s:Application>
Tue Jun 12 2018, 09:30 AM Z