(仅限 Flex 数据可视化组件)
mx.charts.chartClasses
public class InstanceCache
继承InstanceCache Inheritance Object

InstanceCache 是一个实用程序,用于控制一组(n 个)对象实例的创建和管理任务,其中 n 可以随意更改。



公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  count : int
缓存中当前需要的项数。
InstanceCache
  creationCallback : Function
创建新实例时调用的回调。
InstanceCache
  discard : Boolean = false
确定是否放弃不需要的实例。
InstanceCache
  factory : IFactory
生成要缓存的对象类型的类工厂。
InstanceCache
  format : TextFormat
要应用到已创建的所有实例的 TextFormat。
InstanceCache
  hide : Boolean = true
确定是否应隐藏不需要的实例。
InstanceCache
  insertPosition : int
[只写] 实例在父项的子列表中的位置。
InstanceCache
  instances : Array
[只读 (read-only)] 缓存的实例的 Array。
InstanceCache
  properties : Object
要分配给新实例的属性 hashmap。
InstanceCache
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  remove : Boolean = false
确定是否应将不需要的实例从其父项中删除。
InstanceCache
公共方法
 方法定义方
  
InstanceCache(type:Object, parent:Object = null, insertPosition:int = -1)
构造函数。
InstanceCache
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
count属性
count:int  [读写]

缓存中当前需要的项数。



实现
    public function get count():int
    public function set count(value:int):void
creationCallback属性 
public var creationCallback:Function

创建新实例时调用的回调。此回调包含以下签名:

            function creationCallback(
            newInstance
            :Object,
            cache
            :InstanceCache):void;
          

discard属性 
public var discard:Boolean = false

确定是否放弃不需要的实例。如果设置为 true,则当缓存计数减少时将放弃额外的元素。否则,额外的元素将保留在单独的缓存中,并在计数增加时重新使用。

factory属性 
factory:IFactory  [读写]

生成要缓存的对象类型的类工厂。分配此项将放弃当前所有实例,并重新创建正确类型的新实例。



实现
    public function get factory():IFactory
    public function set factory(value:IFactory):void
format属性 
format:TextFormat  [读写]

要应用到已创建的所有实例的 TextFormat。如果设置此属性,则此格式将用作已创建的所有实例内容的当前格式和默认格式。此属性仅在类工厂生成 TextField 实例时相关。



实现
    public function get format():TextFormat
    public function set format(value:TextFormat):void
hide属性 
public var hide:Boolean = true

确定是否应隐藏不需要的实例。如果为 true,则当缓存计数减少时将每个额外元素的 visible 设置为 false,当缓存计数增加时设置为 true

此属性仅当类工厂生成 DisplayObjects 时相关。将其它类工厂类型的此属性设置为 true 将生成运行时错误。

insertPosition属性 
insertPosition:int  [只写]

实例在父项的子列表中的位置。



实现
    public function set insertPosition(value:int):void
instances属性 
instances:Array  [只读 (read-only)]

缓存的实例的 Array。此 Array 中包含的实例数可能多于当前所需数目。您应遵循实例缓存的 count 属性而不是此 Array 的长度。



实现
    public function get instances():Array
properties属性 
properties:Object  [读写]

要分配给新实例的属性 hashmap。此 hashmap 中的每个键/值对都将分配到创建的各个新实例中。设置此属性后,属性 hashmap 将分配到现有的所有实例中。

hashmap 中的值不进行克隆,对象值由所有的实例共享。



实现
    public function get properties():Object
    public function set properties(value:Object):void
remove属性 
public var remove:Boolean = false

确定是否应将不需要的实例从其父项中删除。如果为 true,则当缓存计数减少时,在每个额外元素的父项上调用 removeChild() 方法。

此属性仅当类工厂生成 DisplayObjects 时相关。将其它类工厂类型的此属性设置为 true 将生成运行时错误。

构造函数详细信息
InstanceCache()构造函数
public function InstanceCache(type:Object, parent:Object = null, insertPosition:int = -1)

构造函数。

参数
type:Object — 要构建的对象的类型。可以是类也可以是 IFactory。
 
parent:Object (default = null) — 可添加新实例的 DisplayObject(可选)。
 
insertPosition:int (default = -1) — 在父项的子列表中插入实例的位置。设置为 -1 表示将子项添加到子列表的末端。