mx.effects
接口public interface IEffectTargetHost
实现器 AdvancedListBase, ListBase

IEffectTargetHost 接口定义允许您访问数据效果的基于目标 list 控件的接口。所有基于列表的控件实现此接口。此接口启用效果类的实例与播放效果的基于列表的控件进行通信。此接口还用于确定是否基于已在目标控件中添加、删除或替换数据项目播放效果。

另请参见

mx.controls.listClasses.ListBase


公共方法
 方法定义方
  
如果正在运行数据更改效果,则添加项目渲染器。
IEffectTargetHost
  
getRendererSemanticValue(target:Object, semanticProperty:String):Object
返回 true 或 false 以指示是否应在目标上播放效果。
IEffectTargetHost
  
如果正在运行数据更改效果,则移除项目渲染器。
IEffectTargetHost
  
如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。
IEffectTargetHost
方法详细信息
addDataEffectItem()方法
public function addDataEffectItem(target:Object):void

如果正在运行数据更改效果,则添加项目渲染器。项目渲染器应与数据提供程序集合中最近添加但尚未显示的数据项目对应。

此函数将作为数据更改效果的一部分由 AddItemAction 效果调用,用以指定使用项目渲染器的控件开始显示添加到集合中的项目的时间点。

参数

target:Object — 要添加到控件布局中的项目渲染器。

getRendererSemanticValue()方法 
public function getRendererSemanticValue(target:Object, semanticProperty:String):Object

返回 truefalse 以指示是否应在目标上播放效果。当您在数据效果上设置 filter 属性时,EffectTargetFilter 类调用此方法。例如,将 filter 属性设置为 addItemremoveItem

参数

target:Object — 项目渲染器
 
semanticProperty:String — 要返回其值的渲染器的语义属性。

返回
Objecttruefalse,指示是否应在目标对象中播放效果。
removeDataEffectItem()方法 
public function removeDataEffectItem(target:Object):void

如果正在运行数据更改效果,则移除项目渲染器。项目渲染器必须与从数据提供程序集合中移除的数据对应。此函数将作为数据更改效果的一部分由 RemoveItemAction 效果调用,用以指定使用项目渲染器的控件停止显示数据项目的时间点。

参数

target:Object — 要从控件布局中删除的项目渲染器。

unconstrainRenderer()方法 
public function unconstrainRenderer(item:Object):void

如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。该控件不会尝试定位效果的持续时间的项目渲染器。

参数

item:Object — 作为效果目标的项目渲染器。