IGridItemEditor - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	spark.components.gridClasses
Interface	public interface IGridItemEditor extends IDataRenderer , IVisualElement , IFocusManagerComponent , IIMESupport , ILayoutElement , ILayoutDirectionElement , IEventDispatcher
Implémenteurs	GridItemEditor

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’interface IGridItemEditor définit l’interface que les éditeurs d’élément pour les contrôles Spark DataGrid et Spark Grid doivent implémenter. Les contrôles DataGrid et Grid sont appelés propriétaire du rendu d’élément ou composant hôte de l’éditeur d’élément.

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

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

Eléments de l’API associés

spark.components.DataGrid
spark.components.Grid

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		alpha : Number Indique la valeur de transparence alpha de l’objet spécifié.	IVisualElement
		baseline : Object Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle.	ILayoutElement
		baselinePosition : Number [lecture seule] Coordonnée y de la ligne de base de la première ligne de texte du composant.	ILayoutElement
		bottom : Object Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage.	ILayoutElement
		column : GridColumn La colonne de la cellule en cours de modification.	IGridItemEditor
		columnIndex : int [lecture seule] L’index de base zéro de la colonne en cours de modification.	IGridItemEditor
		data : Object Données à rendre ou à modifier.	IDataRenderer
		dataGrid : DataGrid [lecture seule] Le contrôle qui est propriétaire de cet éditeur d’élément.	IGridItemEditor
		depth : Number Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs.	IVisualElement
		designLayer : DesignLayer Spécifie l’instance DesignLayer facultative associée à cet élément visuel.	IVisualElement
		enableIME : Boolean [lecture seule] Spécifie si l’IME doit être activé lorsque ce composant a le focus.	IIMESupport
		focusEnabled : Boolean Indicateur qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné.	IFocusManagerComponent
		hasFocusableChildren : Boolean Indicateur qui signale si les objets enfant peuvent recevoir le focus	IFocusManagerComponent
		hasLayoutMatrix3D : Boolean [lecture seule] Contient true si l’élément possède une matrice 3D.	ILayoutElement
		height : Number Indique la hauteur de l’objet d’affichage, en pixels.	IVisualElement
		horizontalCenter : Object Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	ILayoutElement
		imeMode : String Mode IME du composant.	IIMESupport
		includeInLayout : Boolean Indique si ce composant est inclus dans la présentation du conteneur parent.	ILayoutElement
		is3D : Boolean [lecture seule] Contient true lorsque l’élément est en 3D.	IVisualElement
		layoutDirection : String Spécifie la direction de mise en forme souhaitée pour un élément : l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée).	ILayoutDirectionElement
		left : Object Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage.	ILayoutElement
		mouseFocusEnabled : Boolean [lecture seule] Indicateur qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné avec la souris.	IFocusManagerComponent
		owner : DisplayObjectContainer Propriétaire de cet objet IVisualElement.	IVisualElement
		parent : DisplayObjectContainer [lecture seule] Conteneur ou composant parent de ce composant.	IVisualElement
		percentHeight : Number Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent.	ILayoutElement
		percentWidth : Number Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent.	ILayoutElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent.	IVisualElement
		right : Object Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage.	ILayoutElement
		rowIndex : int L’index de base zéro de la rangée de la cellule en cours de modification.	IGridItemEditor
		tabFocusEnabled : Boolean [lecture seule] Indicateur qui spécifie s’il est possible de déplacer le focus avec la touche de tabulation.	IFocusManagerComponent
		tabIndex : int Si la valeur est tabFocusEnabled, l’ordre dans lequel le composant reçoit le focus.	IFocusManagerComponent
		top : Object Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage.	ILayoutElement
		verticalCenter : Object Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	ILayoutElement
		visible : Boolean Contrôle la visibilité de cet élément visuel.	IVisualElement
		width : Number Indique la largeur de l’objet d’affichage, en pixels.	IVisualElement
		x : Number Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	IVisualElement
		y : Number Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	IVisualElement

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	IEventDispatcher
		discard():void Appelée juste avant que l’éditeur soit fermé.	IGridItemEditor
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	IEventDispatcher
		drawFocus(isFocused:Boolean):void Appelé par le FocusManager lorsque le composant reçoit le focus.	IFocusManagerComponent
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée.	ILayoutElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée.	ILayoutElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur de présentation de l’élément.	ILayoutElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur de la présentation de l’élément.	ILayoutElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.	ILayoutElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.	ILayoutElement
		getLayoutMatrix():Matrix Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.	ILayoutElement
		getLayoutMatrix3D():Matrix3D Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.	ILayoutElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur maximale de l’élément.	ILayoutElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur maximale de l’élément.	ILayoutElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur minimale de l’élément.	ILayoutElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur minimale de l’élément.	ILayoutElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur préférée de l’élément.	ILayoutElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur préférée de l’élément.	ILayoutElement
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	IEventDispatcher
		invalidateLayoutDirection():void Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change.	ILayoutDirectionElement
		prepare():void Appelée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible.	IGridItemEditor
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	IEventDispatcher
		save():Boolean Enregistre la valeur dans l’éditeur vers le fournisseur de données du propriétaire du rendu d’élément.	IGridItemEditor
		setFocus():void Appelé par le FocusManager lorsque le composant reçoit le focus.	IFocusManagerComponent
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.	ILayoutElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Définit la taille de la présentation de l’élément.	ILayoutElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères.	ILayoutElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères.	ILayoutElement
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent.	ILayoutElement
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	IEventDispatcher

Détails de la propriété

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

La colonne de la cellule en cours de modification.

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 base zéro de la colonne en cours de modification.

Implémentation
public function get columnIndex():int

dataGrid

propriété

dataGrid:DataGrid [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

Le contrôle qui est propriétaire de cet éditeur d’élément.

Implémentation
public function get dataGrid():DataGrid

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 en cours de modification.

Implémentation
public function get rowIndex():int
public function set rowIndex(value:int):void

Détails de la méthode

discard

()

méthode

public function discard():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ée juste avant que l’éditeur soit fermé. Utilisez cette méthode pour effectuer tout nettoyage final, tel que le nettoyage de tout ce qui a été défini dans la méthode prepare().

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

prepare

()

méthode

public function prepare():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ée une fois que l’éditeur a été créé et dimensionné mais avant que l’éditeur soit visible. Utilisez cette méthode pour ajuster l’aspect de l’éditeur, ajouter des écouteurs d’événement ou effectuer toute autre initialisation avant qu’il ne devienne visible.

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

save

()

méthode

public function save():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

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

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

Valeur renvoyée

Boolean — true si l’opération d’enregistrement a réussi et false dans le cas contraire.

Eléments de l’API associés

spark.components.DataGrid

Informations juridiques | Politique de confidentialité en ligne

IGridItemEditor - AS3 Flex

Classes x

column

columnIndex

dataGrid

rowIndex

discard

prepare

save