包mx.managers
类public class CursorManager
继承CursorManager Inheritance Object

CursorManager 类控制光标的优先级列表，在该列表中，具有最高优先级的光标是当前可见的光标。如果光标列表中有多个光标具有同一优先级，则光标管理器将显示最近创建的光标。

例如，如果应用程序正在执行的处理过程要求用户等待处理完成，则可以对光标进行更改，使其反映等待期。在这种情况下，您可以将光标更改为沙漏或其它图像。

您可能还希望将光标更改为可以向用户提供反馈，用来指示用户可以执行的操作。例如，您可以使用一个光标图像来指示已启用用户输入，使用另一个光标图像来指示已禁用用户输入。您可以使用 JPEG、GIF、PNG 或 SVG 图像、Sprite 对象或者 SWF 文件来作为光标图像。

CursorManager 的所有方法和属性都是静态的，因此不需要为其创建实例。

在 AIR 中，每个 mx.core.Window 实例都使用自己的 CursorManager 类的实例。不直接引用 CursorManager 类的静态方法和属性，而是使用 Window.cursorManager 属性引用 Window 实例的 CursorManager 实例。

另请参见

mx.managers.CursorManagerPriority
mx.core.Window

公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  currentCursorID : int
[静态] 当前自定义光标的 ID；如果显示的是系统光标，则为 NO_CURSOR。
CursorManager
  currentCursorXOffset : Number
[静态] 自定义光标随鼠标指针变化的 x 偏移（以像素为单位）。
CursorManager
  currentCursorYOffset : Number
[静态] 自定义光标随鼠标指针变化的 y 偏移（以像素为单位）。
CursorManager
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
getInstance():ICursorManager
[静态] AIR 应用程序中的每个 mx.core.Window 实例都有自己的 CursorManager 实例。
CursorManager
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
  
hideCursor():void
[静态] 使光标不可见。
CursorManager
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
  
removeAllCursors():void
[静态] 删除光标列表中的所有光标并存储系统光标。
CursorManager
  
removeBusyCursor():void
[静态] 从光标列表中删除忙状态光标。
CursorManager
  
removeCursor(cursorID:int):void
[静态] 从光标列表中删除光标。
CursorManager
  
setBusyCursor():void
[静态] 显示忙状态光标。
CursorManager
  
setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
[静态] 创建新光标并为此光标设置可选优先级。
CursorManager
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
  
showCursor():void
[静态] 使光标可见。
CursorManager
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
样式
 样式 说明 定义方
  
busyCursor
类型: Class CSS 继承: no
忙状态光标的外观 默认值为 mx.skins.halo.BusyCursor.		CursorManager
公共常量
 常量定义方
  NO_CURSOR : int = 0
[静态] 一个常数，表示当由于 CursorManager 没有管理任何光标而显示系统光标时，currentCursorID 属性的值。
CursorManager
属性详细信息
currentCursorID属性
currentCursorID:int  [读写]

当前自定义光标的 ID；如果显示的是系统光标，则为 NO_CURSOR。



实现
    public static function get currentCursorID():int
    public function set currentCursorID(value:int):void
currentCursorXOffset属性 
currentCursorXOffset:Number  [读写]

自定义光标随鼠标指针变化的 x 偏移（以像素为单位）。

默认值为 0.



实现
    public static function get currentCursorXOffset():Number
    public function set currentCursorXOffset(value:Number):void
currentCursorYOffset属性 
currentCursorYOffset:Number  [读写]

自定义光标随鼠标指针变化的 y 偏移（以像素为单位）。

默认值为 0.



实现
    public static function get currentCursorYOffset():Number
    public function set currentCursorYOffset(value:Number):void
方法详细信息
getInstance()方法
public static function getInstance():ICursorManager

AIR 应用程序中的每个 mx.core.Window 实例都有自己的 CursorManager 实例。此方法将返回主 Window 实例的 CursorManager 实例。

返回
ICursorManager — AIR 应用程序中主 Window 实例的 CursorManager 实例。
hideCursor()方法 
public static function hideCursor():void

使光标不可见。无法对光标可见性进行引用计数。无论调用了多少次 showCursor() 方法，只要调用一次 hideCursor() 方法就会始终隐藏光标。

调用此方法不会影响系统光标。使用 Mouse.show() 和 Mouse.hide() 方法可直接控制系统光标。

removeAllCursors()方法 
public static function removeAllCursors():void

删除光标列表中的所有光标并存储系统光标。

removeBusyCursor()方法 
public static function removeBusyCursor():void

从光标列表中删除忙状态光标。如果光标列表中还有其它忙状态光标请求处于活动状态，也就是说您已多次调用 setBusyCursor() 方法，那么，只有从列表中删除了所有忙状态光标后，忙状态光标才会消失。

removeCursor()方法 
public static function removeCursor(cursorID:int):void

从光标列表中删除光标。如果要删除的光标是当前显示的光标，则 CursorManager 会显示列表中的下一个光标（如果存在）。如果列表已经为空，则 CursorManager 将显示默认的系统光标。

参数

cursorID:int — 要删除的光标的 ID。

setBusyCursor()方法 
public static function setBusyCursor():void

显示忙状态光标。忙状态光标的优先级是 CursorManagerPriority.LOW。因此，只要光标列表中包含具有更高优先级的光标，就不会显示忙状态光标，直到删除了更高优先级的光标。要创建一个具有较高优先级的忙状态光标，可使用 setCursor() 方法。

setCursor()方法 
public static function setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int

创建新光标并为此光标设置可选优先级。向光标列表添加新的光标。

参数

cursorClass:Class — 要显示的光标的类。
 
priority:int (default = 2) — 用于指定光标优先级的整数。可能的值为 CursorManagerPriority.HIGH、CursorManagerPriority.MEDIUM 和 CursorManagerPriority.LOW。
 
xOffset:Number (default = 0) — 用于指定光标随鼠标指针变化的 x 偏移（以像素为单位）的数字。
 
yOffset:Number (default = 0) — 用于指定光标随鼠标指针变化的 y 偏移（以像素为单位）的数字。

返回
int — 光标的 ID。

另请参见

mx.managers.CursorManagerPriority
showCursor()方法 
public static function showCursor():void

使光标可见。无法对光标可见性进行引用计数。无论调用了多少次 hideCursor() 方法，只要调用一次 showCursor() 方法就会始终显示光标。

调用此方法不会影响系统光标。使用 Mouse.show() 和 Mouse.hide() 方法可直接控制系统光标。

常量详细信息
NO_CURSOR常量
public static const NO_CURSOR:int = 0

一个常数，表示当由于 CursorManager 没有管理任何光标而显示系统光标时，currentCursorID 属性的值。




© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00