mx.core
public class FlexVersion
继承FlexVersion Inheritance Object

此类控制框架的向后兼容性。对于每个新版本,框架的某些方面(如行为、样式和默认设置)都会发生变化,这可能会对您的应用程序产生影响。通过设置 compatibilityVersion 属性,可以将行为更改为与先前版本匹配。这是一个“全局”标志;您不能对一个组件或一组组件应用一个版本,而对另一个组件或另一组组件应用另一版本。

另请参见

Backward compatibility


公共属性
 属性定义方
  compatibilityErrorFunction : Function
[静态] 当多次设置兼容版本或在读取后设置兼容版本时调用的函数。
FlexVersion
  compatibilityVersion : uint
[静态] 框架维护其兼容性的当前版本。
FlexVersion
  compatibilityVersionString : String
[静态] 兼容版本,“X.X.X”格式的字符串。
FlexVersion
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量定义方
  CURRENT_VERSION : uint = 0x03000000
[静态] Flex SDK 的当前发布版本,编码为 uint。
FlexVersion
  VERSION_2_0 : uint = 0x02000000
[静态] Flex 2.0 的 compatibilityVersion 值,使用数字编码为 uint。
FlexVersion
  VERSION_2_0_1 : uint = 0x02000001
[静态] Flex 2.0.1 的 compatibilityVersion 值,使用数字编码为 uint.
FlexVersion
  VERSION_3_0 : uint = 0x03000000
[静态] Flex 3.0 的 compatibilityVersion 值,使用数字编码为 uint。
FlexVersion
  VERSION_ALREADY_READ : String = "versionAlreadyRead"
[静态] 作为参数传递给 compatibilityErrorFunction() 方法的 String(如果已读取兼容版本)。
FlexVersion
  VERSION_ALREADY_SET : String = "versionAlreadySet"
[静态] 作为参数传递给 compatibilityErrorFunction() 方法的 String(如果已设置兼容版本)。
FlexVersion
属性详细信息
compatibilityErrorFunction属性
compatibilityErrorFunction:Function  [读写]

当多次设置兼容版本或在读取后设置兼容版本时调用的函数。如果未设置此函数,SDK 将引发错误。如果已设置此函数,File 将调用此函数,但如何处理此调用由开发人员决定。当多次设置该函数时,也会调用此函数。该函数包含两个参数:第一个是 uint,即试图设置的版本;第二个是指示失败原因的字符串,可以是 VERSION_ALREADY_SETVERSION_ALREADY_READ



实现
    public static function get compatibilityErrorFunction():Function
    public function set compatibilityErrorFunction(value:Function):void
compatibilityVersion属性 
compatibilityVersion:uint  [读写]

框架维护其兼容性的当前版本。默认为 CURRENT_VERSION。它只能更改一次;另外更改时会导致调用 compatibilityErrorFunction() 方法(如果存在),或导致运行时错误。在读取 compatibilityVersion 属性后对其进行更改会导致错误,因为依赖于该版本的代码已在运行。不会发出任何通知,系统将假定此版本只设置了一次,并且早在依赖它的版本运行之前就已进行了设置。

默认值为 FlexVersion.CURRENT_VERSION.



实现
    public static function get compatibilityVersion():uint
    public function set compatibilityVersion(value:uint):void
compatibilityVersionString属性 
compatibilityVersionString:String  [读写]

兼容版本,“X.X.X”格式的字符串。该字符串将传递给 compatibilityVersion 属性,此属性可将数字转换为便于人们理解的 String 版本,或逆向转换。



实现
    public static function get compatibilityVersionString():String
    public function set compatibilityVersionString(value:String):void
常量详细信息
CURRENT_VERSION常量
public static const CURRENT_VERSION:uint = 0x03000000

Flex SDK 的当前发布版本,编码为 uint。

VERSION_2_0常量 
public static const VERSION_2_0:uint = 0x02000000

Flex 2.0 的 compatibilityVersion 值,使用数字编码为 uint。代码可以将此常数与 compatibilityVersion 进行比较,以实现版本特定的行为。

VERSION_2_0_1常量 
public static const VERSION_2_0_1:uint = 0x02000001

Flex 2.0.1 的 compatibilityVersion 值,使用数字编码为 uint。代码可以将此常数与 compatibilityVersion 进行比较,以实现版本特定的行为。

VERSION_3_0常量 
public static const VERSION_3_0:uint = 0x03000000

Flex 3.0 的 compatibilityVersion 值,使用数字编码为 uint。代码可以将此常数与 compatibilityVersion 进行比较,以实现版本特定的行为。

VERSION_ALREADY_READ常量 
public static const VERSION_ALREADY_READ:String = "versionAlreadyRead"

作为参数传递给 compatibilityErrorFunction() 方法的 String(如果已读取兼容版本)。

VERSION_ALREADY_SET常量 
public static const VERSION_ALREADY_SET:String = "versionAlreadySet"

作为参数传递给 compatibilityErrorFunction() 方法的 String(如果已设置兼容版本)。