mx.effects

# IEffectTargetHost - AS3 Flex

Package | mx.effects
Interface | public interface IEffectTargetHost
Implementors | AdvancedListBase, ListBase

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

The IEffectTargetHost interface defines the interface that lets you access the target list-based control of a data effect. All list-based controls implement this interface. This interface enables an instance of an effect class to communicate with the list-based control on which the effect is playing. This interface is also used for determining whether to play an effect based on if a data item is added, removed, or replaced in the target control.

Related API Elements

mx.controls.listClasses.ListBase

Public Methods

| Method | Defined By
--- | --- | ---
|  | addDataEffectItem(target:Object):void Adds an item renderer if a data change effect is running. | IEffectTargetHost
|  | getRendererSemanticValue(target:Object, semanticProperty:String):Object Returns true or false to indicates whether the effect should play on the target. | IEffectTargetHost
|  | removeDataEffectItem(target:Object):void Removes an item renderer if a data change effect is running. | IEffectTargetHost
|  | unconstrainRenderer(item:Object):void Called by an UnconstrainItemAction effect as part of a data change effect if the item renderers corresponding to certain data items need to move outside the normal positions of item renderers in the control. | IEffectTargetHost

Method Detail

### addDataEffectItem

()
method

`public function addDataEffectItem(target:Object):void`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

Adds an item renderer if a data change effect is running. The item renderer should correspond to a recently added data item in the data provider's collection that isn't yet being displayed.

This function will be called by an `AddItemAction` effect as part of a data change effect to specify the point at which a data item added to a collection begins to be displayed by the control using an item renderer.

Parameters

| `target:Object` — The item renderer to add to the control's layout.

### getRendererSemanticValue

()
method

`public function getRendererSemanticValue(target:Object, semanticProperty:String):Object`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

Returns `true` or `false` to indicates whether the effect should play on the target. The EffectTargetFilter class calls this method when you set the `filter` property on a data effect. For example, you set `filter` property to `addItem` or `removeItem`.

Parameters

| `target:Object` — An item renderer
| `semanticProperty:String` — The semantic property of the renderer whose value will be returned.

Returns

| `Object` — `true` or `false` to indicates whether the effect should play on the target.

### removeDataEffectItem

()
method

`public function removeDataEffectItem(target:Object):void`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

Removes an item renderer if a data change effect is running. The item renderer must correspond to data that has already been removed from the data provider collection. This function will be called by a `RemoveItemAction` effect as part of a data change effect to specify the point at which a data item ceases to displayed by the control using an item renderer.

Parameters

| `target:Object` — The item renderer to remove from the control's layout.

### unconstrainRenderer

()
method

`public function unconstrainRenderer(item:Object):void`

Language Version: | ActionScript 3.0

Product Version: | Flex 3

Runtime Versions: | Flash Player 9, AIR 1.1

Called by an `UnconstrainItemAction` effect as part of a data change effect if the item renderers corresponding to certain data items need to move outside the normal positions of item renderers in the control. The control does not attempt to position the item render for the duration of the effect.

Parameters

| `item:Object` — The item renderer that is a target of the effect.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00