Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
mx.managers 

CursorManager  - AS3 Flex

Pacchettomx.managers
Classepublic class CursorManager
EreditarietàCursorManager Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

The CursorManager class controls a prioritized list of cursors, where the cursor with the highest priority is currently visible. If the cursor list contains more than one cursor with the same priority, the Cursor Manager displays the most recently created cursor.

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.

Altri esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  currentCursorID : int
[statico] ID of the current custom cursor, or NO_CURSOR if the system cursor is showing.
CursorManager
  currentCursorXOffset : Number
[statico] The x offset of the custom cursor, in pixels, relative to the mouse pointer.
CursorManager
  currentCursorYOffset : Number
[statico] The y offset of the custom cursor, in pixels, relative to the mouse pointer.
CursorManager
Metodi pubblici
 MetodoDefinito da
  
getInstance():ICursorManager
[statico] Each mx.core.Window instance in an AIR application has its own CursorManager instance.
CursorManager
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
[statico] Makes the cursor invisible.
CursorManager
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
[statico] Removes all of the cursors from the cursor list and restores the system cursor.
CursorManager
  
[statico] Removes the busy cursor from the cursor list.
CursorManager
  
[statico] Removes a cursor from the cursor list.
CursorManager
  
[statico] Displays the busy cursor.
CursorManager
  
setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
[statico] Creates a new cursor and sets an optional priority for the cursor.
CursorManager
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
[statico] Makes the cursor visible.
CursorManager
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Stili

Gli stili sono di tipo comune oppure associati a un tema specifico. Se lo stile è comune, può essere utilizzato con qualunque tema. Se è associato a un tema specifico, può essere utilizzato solo se la vostra applicazione ne fa uso.

Stili comuni
 Stile Descrizione Definito da
  
busyCursor
Tipo: Class Ereditarietà CSS: No
Versione linguaggio: ActionScript 3.0  Versione prodotto: Flex 3  Versioni runtime: Flash9, AIR 1.1

The skin for the busy cursor. Il valore predefinito è mx.skins.halo.BusyCursor.
CursorManager
  
busyCursorBackground
Tipo: Class Ereditarietà CSS: No
Versione linguaggio: ActionScript 3.0  Versione prodotto: Flex 3  Versioni runtime: 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
Costanti pubbliche
 CostanteDefinito da
  NO_CURSOR : int = 0
[statico] 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
Descrizione delle proprietà

currentCursorID

proprietà
currentCursorID:int

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

ID of the current custom cursor, or NO_CURSOR if the system cursor is showing.



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

currentCursorXOffset

proprietà 
currentCursorXOffset:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

The x offset of the custom cursor, in pixels, relative to the mouse pointer.

Il valore predefinito è 0.



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

currentCursorYOffset

proprietà 
currentCursorYOffset:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

The y offset of the custom cursor, in pixels, relative to the mouse pointer.

Il valore predefinito è 0.



Implementazione
    public static function get currentCursorYOffset():Number
    public static function set currentCursorYOffset(value:Number):void
Descrizione dei metodi

getInstance

()metodo
public static function getInstance():ICursorManager

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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.

Restituisce
ICursorManager — The CursorManager instance for the main Window instance in an AIR application.

hideCursor

()metodo 
public static function hideCursor():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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

()metodo 
public static function removeAllCursors():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Removes all of the cursors from the cursor list and restores the system cursor.

removeBusyCursor

()metodo 
public static function removeBusyCursor():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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

()metodo 
public static function removeCursor(cursorID:int):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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.

Parametri

cursorID:int — ID of cursor to remove.

setBusyCursor

()metodo 
public static function setBusyCursor():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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.

Parametri

cursorClass:Class — Class of the cursor to display.
 
priority:int (default = 2) — Integer that specifies the priority level of the cursor. Possible values are CursorManagerPriority.HIGH, CursorManagerPriority.MEDIUM, and CursorManagerPriority.LOW.
 
xOffset:Number (default = 0) — Number that specifies the x offset of the cursor, in pixels, relative to the mouse pointer.
 
yOffset:Number (default = 0) — Number that specifies the y offset of the cursor, in pixels, relative to the mouse pointer.

Restituisce
int — The ID of the cursor.

Elementi API correlati

showCursor

()metodo 
public static function showCursor():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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.

Descrizione delle costanti

NO_CURSOR

Costante
public static const NO_CURSOR:int = 0

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: 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.





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.