CursorManager - Adobe ActionScript® 3 (AS3 Flex) API 参考

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

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

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

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentCursorID : int [静态] 当前自定义光标的 ID；如果显示的是系统光标，则为 NO_CURSOR。	CursorManager
		currentCursorXOffset : Number [静态] 自定义光标随鼠标指针变化的 x 偏移（以像素为单位）。	CursorManager
		currentCursorYOffset : Number [静态] 自定义光标随鼠标指针变化的 y 偏移（以像素为单位）。	CursorManager

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		getInstance():ICursorManager [静态] AIR 应用程序中的每个 mx.core.Window 实例都有自己的 CursorManager 实例。	CursorManager
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hideCursor():void [静态] 使光标不可见。	CursorManager
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		showCursor():void [静态] 使光标可见。	CursorManager
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

样式

样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。

常见样式

单击此处了解有关样式的更多信息

	样式		说明	由以下参数定义
		busyCursor	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 忙状态光标的外观。默认值为 `mx.skins.halo.BusyCursor`。	CursorManager
		busyCursorBackground	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用作忙状态光标背景外观的类。默认值为 Assets.swf 文件中的“cursorStretch”元件。	CursorManager

公共常量

	常量		由以下参数定义
		NO_CURSOR : int = 0 [静态] 一个常量，表示当由于 CursorManager 没有管理任何光标而显示系统光标时，currentCursorID 属性的值。	CursorManager

属性详细信息

currentCursorID

属性

currentCursorID:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public static function get currentCursorID():int
public static function set currentCursorID(value:int):void

currentCursorXOffset

属性

currentCursorXOffset:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 0。

实现
public static function get currentCursorXOffset():Number
public static function set currentCursorXOffset(value:Number):void

currentCursorYOffset

属性

currentCursorYOffset:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 0。

实现
public static function get currentCursorYOffset():Number
public static function set currentCursorYOffset(value:Number):void

方法详细信息

getInstance

()

方法

public static function getInstance():ICursorManager

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

ICursorManager — AIR 应用程序中主 Window 实例的 CursorManager 实例。

hideCursor

()

方法

public static function hideCursor():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

removeAllCursors

()

方法

public static function removeAllCursors():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

removeBusyCursor

()

方法

public static function removeBusyCursor():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

removeCursor

()

方法

public static function removeCursor(cursorID:int):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

setBusyCursor

()

方法

public static function setBusyCursor():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

setCursor

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

	`cursorClass:Class` — 要显示的光标的类。

	`priority:int` (default = `2`) — 用于指定光标优先级的整数。可能的值为 `CursorManagerPriority.HIGH`、`CursorManagerPriority.MEDIUM` 和 `CursorManagerPriority.LOW`。

	`xOffset:Number` (default = `0`) — 用于指定光标随鼠标指针变化的 x 偏移（以像素为单位）的数字。

	`yOffset:Number` (default = `0`) — 用于指定光标随鼠标指针变化的 y 偏移（以像素为单位）的数字。

int — 光标的 ID。

showCursor

()

方法

public static function showCursor():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

常量详细信息

NO_CURSOR

常量

public static const NO_CURSOR:int = 0

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

法律声明 | 在线隐私策略

CursorManager - AS3 Flex

包x

语言元素

附录

包 mx.managers

currentCursorID

currentCursorXOffset

currentCursorYOffset

getInstance

hideCursor

removeAllCursors

removeBusyCursor

removeCursor

setBusyCursor

setCursor

showCursor

NO_CURSOR