| 套件 | mx.managers |
| 類別 | public class CursorManager |
| 繼承 | CursorManager  Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
For example, if your application performs processing that requires the user to wait until the processing completes, you can change the cursor so that it reflects the waiting period. In this case, you can change the cursor to an hourglass or other image.
You also might want to change the cursor to provide feedback to the user to indicate the actions that the user can perform. For example, you can use one cursor image to indicate that user input is enabled, and another to indicate that input is disabled. You can use a JPEG, GIF, PNG, or SVG image, a Sprite object, or a SWF file as the cursor image.
All methods and properties of the CursorManager are static, so you do not need to create an instance of it.
In AIR, each mx.core.Window instance uses its own instance of the CursorManager class.
Instead of directly referencing the static methods and properties of the CursorManager class,
use the Window.cursorManager property to reference the CursorManager instance
for the Window instance.
更多範例
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentCursorID : int [靜態]
ID of the current custom cursor,
or NO_CURSOR if the system cursor is showing. | CursorManager | ||
| currentCursorXOffset : Number [靜態]
The x offset of the custom cursor, in pixels,
relative to the mouse pointer. | CursorManager | ||
| currentCursorYOffset : Number [靜態]
The y offset of the custom cursor, in pixels,
relative to the mouse pointer. | CursorManager | ||
| 方法 | 定義自 | ||
|---|---|---|---|
getInstance():ICursorManager [靜態]
Each mx.core.Window instance in an AIR application has its own CursorManager instance. | CursorManager | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
[靜態]
Makes the cursor invisible. | CursorManager | ||
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
[靜態]
Removes all of the cursors from the cursor list
and restores the system cursor. | CursorManager | ||
[靜態]
Removes the busy cursor from the cursor list. | CursorManager | ||
[靜態]
Removes a cursor from the cursor list. | CursorManager | ||
[靜態]
Displays the busy cursor. | CursorManager | ||
[靜態]
Creates a new cursor and sets an optional priority for the cursor. | CursorManager | ||
|
為迴圈作業設定動態屬性的可用性。 | Object | |
[靜態]
Makes the cursor visible. | CursorManager | ||
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式，可以與任何主題搭配使用。如果是與特定主題關聯的樣式，只有在您的應用程式使用特定主題時才能使用該樣式。
| 樣式 | 說明 | 定義自 | ||
|---|---|---|---|---|
busyCursor | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The skin for the busy cursor. 預設值為 mx.skins.halo.BusyCursor。 | CursorManager | ||
busyCursorBackground | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The class to use as the skin for the busy cursor background. The default value is the "cursorStretch" symbol from the Assets.swf file. | CursorManager | ||
| 常數 | 定義自 | ||
|---|---|---|---|
| NO_CURSOR : int = 0 [靜態]
Constant that is the value of currentCursorID property
when there is no cursor managed by the CursorManager and therefore
the system cursor is being displayed. | CursorManager | ||
currentCursorID | 屬性 |
currentCursorXOffset | 屬性 |
currentCursorXOffset:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The x offset of the custom cursor, in pixels, relative to the mouse pointer.
預設值為 0。
實作
public static function get currentCursorXOffset():Number public static function set currentCursorXOffset(value:Number):voidcurrentCursorYOffset | 屬性 |
currentCursorYOffset:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The y offset of the custom cursor, in pixels, relative to the mouse pointer.
預設值為 0。
實作
public static function get currentCursorYOffset():Number public static function set currentCursorYOffset(value:Number):voidgetInstance | () | 方法 |
public static function getInstance():ICursorManager| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Each mx.core.Window instance in an AIR application has its own CursorManager instance. This method returns the CursorManager instance for the main Window instance.
傳回值ICursorManager — The CursorManager instance for the main Window instance in an AIR application.
|
hideCursor | () | 方法 |
public static function hideCursor():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Makes the cursor invisible.
Cursor visibility is not reference-counted.
A single call to the hideCursor() method
always hides the cursor regardless of how many calls
to the showCursor() method were made.
Calling this method does not affect the system cursor.
Use the Mouse.show() and
Mouse.hide() methods to directly
control the system cursor.
removeAllCursors | () | 方法 |
public static function removeAllCursors():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Removes all of the cursors from the cursor list and restores the system cursor.
removeBusyCursor | () | 方法 |
public static function removeBusyCursor():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Removes the busy cursor from the cursor list.
If other busy cursor requests are still active in the cursor list,
which means you called the setBusyCursor() method more than once,
a busy cursor does not disappear until you remove
all busy cursors from the list.
removeCursor | () | 方法 |
public static function removeCursor(cursorID:int):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Removes a cursor from the cursor list. If the cursor being removed is the currently displayed cursor, the CursorManager displays the next cursor in the list, if one exists. If the list becomes empty, the CursorManager displays the default system cursor.
參數
cursorID:int — ID of cursor to remove.
|
setBusyCursor | () | 方法 |
public static function setBusyCursor():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Displays the busy cursor.
The busy cursor has a priority of CursorManagerPriority.LOW.
Therefore, if the cursor list contains a cursor
with a higher priority, the busy cursor is not displayed
until you remove the higher priority cursor.
To create a busy cursor at a higher priority level,
use the setCursor() method.
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 |
Creates a new cursor and sets an optional priority for the cursor. Adds the new cursor to the cursor list.
參數
cursorClass:Class — Class of the cursor to display.
| |
priority:int (default = 2)CursorManagerPriority.HIGH,
CursorManagerPriority.MEDIUM, and CursorManagerPriority.LOW.
| |
xOffset:Number (default = 0) | |
yOffset:Number (default = 0) |
int — The ID of the cursor.
|
相關 API 元素
showCursor | () | 方法 |
public static function showCursor():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Makes the cursor visible.
Cursor visibility is not reference-counted.
A single call to the showCursor() method
always shows the cursor regardless of how many calls
to the hideCursor() method were made.
Calling this method does not affect the system cursor.
Use the Mouse.show() and
Mouse.hide() methods to directly
control the system cursor.
NO_CURSOR | 常數 |
public static const NO_CURSOR:int = 0| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constant that is the value of currentCursorID property
when there is no cursor managed by the CursorManager and therefore
the system cursor is being displayed.
Tue Jun 12 2018, 03:47 PM Z