IGridItemEditor - Referência da API Adobe ActionScript® 3 (AS3 Flex)

Pacote	spark.components.gridClasses
Interface	public interface IGridItemEditor extends IDataRenderer , IVisualElement , IFocusManagerComponent , IIMESupport , ILayoutElement , ILayoutDirectionElement , IEventDispatcher
Implementadores	GridItemEditor

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

The IGridItemEditor interface defines the interface that item editors for the Spark DataGrid and Spark Grid controls must implement. The DataGrid and Grid controls are referred to as the item renderer owner, or as the host component of the item editor.

All of the item editor's properties are set by the owner during the start of the editor session. The data property is the last property set. When the data property is set, an item editor should set the value of the editor's controls. Next, the editor's prepare() method is called. IGridItemEditor implementations should override the prepare() method to make any final adjustments to its properties or any aspect of its visual elements. When the editor is closing, the discard() method is called.

When the editor is closed, the input value can be saved or canceled. If saving, the save() function is called by the editor to write new values to the data provider element corresponding to the row of the edited cell.

Elementos da API relacionados

spark.components.DataGrid
spark.components.Grid

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		alpha : Number Indica o valor de transparência alfa do objeto especificado.	IVisualElement
		baseline : Object The vertical distance in pixels from the anchor target to the control's baseline position.	ILayoutElement
		baselinePosition : Number [somente leitura] The y-coordinate of the baseline of the first line of text of the component.	ILayoutElement
		bottom : Object The vertical distance in pixels from the bottom edge of the component to the anchor target's bottom edge.	ILayoutElement
		column : GridColumn The column of the cell being edited.	IGridItemEditor
		columnIndex : int [somente leitura] The zero-based index of the column being edited.	IGridItemEditor
		data : Object The data to render or edit.	IDataRenderer
		dataGrid : DataGrid [somente leitura] The control that owns this item editor.	IGridItemEditor
		depth : Number Determines the order in which items inside of containers are rendered.	IVisualElement
		designLayer : DesignLayer Specifies the optional DesignLayer instance associated with this visual element.	IVisualElement
		enableIME : Boolean [somente leitura] Specifies whether the IME should be enabled when this component has focus.	IIMESupport
		focusEnabled : Boolean A flag that indicates whether the component can receive focus when selected.	IFocusManagerComponent
		hasFocusableChildren : Boolean A flag that indicates whether child objects can receive focus.	IFocusManagerComponent
		hasLayoutMatrix3D : Boolean [somente leitura] Contains true if the element has 3D Matrix.	ILayoutElement
		height : Number Indica a altura do objeto de exibição, em pixels.	IVisualElement
		horizontalCenter : Object The horizontal distance in pixels from the center of the component to the center of the anchor target's content area.	ILayoutElement
		imeMode : String The IME mode of the component.	IIMESupport
		includeInLayout : Boolean Specifies whether this component is included in the layout of the parent container.	ILayoutElement
		is3D : Boolean [somente leitura] Contains true when the element is in 3D.	IVisualElement
		layoutDirection : String Specifies the desired layout direction for an element: one of LayoutDirection.LTR (left to right), LayoutDirection.RTL (right to left), or null (inherit).	ILayoutDirectionElement
		left : Object The horizontal distance in pixels from the left edge of the component to the anchor target's left edge.	ILayoutElement
		mouseFocusEnabled : Boolean [somente leitura] A flag that indicates whether the component can receive focus when selected with the mouse.	IFocusManagerComponent
		owner : DisplayObjectContainer The owner of this IVisualElement object.	IVisualElement
		parent : DisplayObjectContainer [somente leitura] The parent container or component for this component.	IVisualElement
		percentHeight : Number Specifies the height of a component as a percentage of its parent's size.	ILayoutElement
		percentWidth : Number Specifies the width of a component as a percentage of its parent's size.	ILayoutElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets Defines a set of adjustments that can be applied to the object's transform in a way that is invisible to its parent's layout.	IVisualElement
		right : Object The horizontal distance in pixels from the right edge of the component to the anchor target's right edge.	ILayoutElement
		rowIndex : int The zero-based index of the row of the cell being edited.	IGridItemEditor
		tabFocusEnabled : Boolean [somente leitura] A flag that indicates whether pressing the Tab key eventually moves focus to this component.	IFocusManagerComponent
		tabIndex : int If tabFocusEnabled, the order in which the component receives focus.	IFocusManagerComponent
		top : Object The vertical distance in pixels from the top edge of the component to the anchor target's top edge.	ILayoutElement
		verticalCenter : Object The vertical distance in pixels from the center of the component to the center of the anchor target's content area.	ILayoutElement
		visible : Boolean Controls the visibility of this visual element.	IVisualElement
		width : Number Indica a largura do objeto de exibição, em pixels.	IVisualElement
		x : Number Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai.	IVisualElement
		y : Number Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai.	IVisualElement

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	IEventDispatcher
		discard():void Called just before the editor is closed.	IGridItemEditor
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	IEventDispatcher
		drawFocus(isFocused:Boolean):void Called by the FocusManager when the component receives focus.	IFocusManagerComponent
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the x coordinate of the element's bounds at the specified element size.	ILayoutElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the y coordinate of the element's bounds at the specified element size.	ILayoutElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's layout height.	ILayoutElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's layout width.	ILayoutElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Returns the x coordinate that the element uses to draw on screen.	ILayoutElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Returns the y coordinate that the element uses to draw on screen.	ILayoutElement
		getLayoutMatrix():Matrix Returns the transform matrix that is used to calculate the component's layout relative to its siblings.	ILayoutElement
		getLayoutMatrix3D():Matrix3D Returns the layout transform Matrix3D for this element.	ILayoutElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's maximum height.	ILayoutElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's maximum width.	ILayoutElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's minimum height.	ILayoutElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's minimum width.	ILayoutElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's preferred height.	ILayoutElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's preferred width.	ILayoutElement
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	IEventDispatcher
		invalidateLayoutDirection():void An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes.	ILayoutDirectionElement
		prepare():void Called after the editor has been created and sized but before the editor is visible.	IGridItemEditor
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	IEventDispatcher
		save():Boolean Saves the value in the editor to the data provider of the item renderer's owner.	IGridItemEditor
		setFocus():void Called by the FocusManager when the component receives focus.	IFocusManagerComponent
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void Sets the coordinates that the element uses to draw on screen.	ILayoutElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Sets the layout size of the element.	ILayoutElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Sets the transform Matrix that is used to calculate the component's layout size and position relative to its siblings.	ILayoutElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Sets the transform Matrix3D that is used to calculate the component's layout size and position relative to its siblings.	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 A utility method to update the rotation, scale, and translation of the transform while keeping a particular point, specified in the component's own coordinate space, fixed in the parent's coordinate space.	ILayoutElement
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	IEventDispatcher

Detalhes da propriedade

column

propriedade

column:GridColumn

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

The column of the cell being edited.

Implementação
public function get column():GridColumn
public function set column(value:GridColumn):void

columnIndex

propriedade

columnIndex:int [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

The zero-based index of the column being edited.

Implementação
public function get columnIndex():int

dataGrid

propriedade

dataGrid:DataGrid [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

The control that owns this item editor.

Implementação
public function get dataGrid():DataGrid

rowIndex

propriedade

rowIndex:int

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

The zero-based index of the row of the cell being edited.

Implementação
public function get rowIndex():int
public function set rowIndex(value:int):void

Detalhes do método

discard

()

método

public function discard():void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

Called just before the editor is closed. Use this method to perform any final cleanup, such as cleaning up anything that was set in the prepare() method.

Do not call this method directly. It should only be called by the control hosting the item editor.

prepare

()

método

public function prepare():void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

Called after the editor has been created and sized but before the editor is visible. Use this method to adjust the appearance of the editor, add event listeners, or perform any other initializations before it becomes visible.

Do not call this method directly. It should only be called by the control hosting the item editor.

save

()

método

public function save():Boolean

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 4.5

Versões de runtime:

Flash Player 10, AIR 2.5

Saves the value in the editor to the data provider of the item renderer's owner. This method updates the data provider element corresponding to the row of the edited cell. This function calls GridItemEditor.validate() to verify the data may be saved. If the data is not valid, then the data is not saved and the editor is not closed.

Do not call this method directly. It should only be called by the control hosting the item editor. To save and close the editor, call the endItemEditorSession() method of the item renderer owner.

Retorna

Boolean — true if the save operation succeeded, and false if not.

Elementos da API relacionados

spark.components.DataGrid

Aspectos jurídicos | Política de privacidade on-line

IGridItemEditor - AS3 Flex

Pacotesx

Elementos de linguagem

Apêndices

Pacote spark.components.gridClasses

column

columnIndex

dataGrid

rowIndex

discard

prepare

save