| Package | mx.managers |
| Classe | public class CursorManager |
| Héritage | CursorManager  Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Par exemple, si votre application effectue un traitement qui implique que l’utilisateur doit attendre jusqu’à la fin du traitement, vous pouvez modifier le curseur pour qu’il reflète la période d’attente. Dans ce cas, vous pouvez utiliser un sablier ou une autre image pour le curseur.
Vous pouvez également changer le curseur pour indiquer à l’utilisateur les actions qu’il peut effectuer. Par exemple, vous pouvez utiliser une image de curseur pour indiquer à l’utilisateur que la saisie est activée et un autre pour lui indiquer que la saisie est désactivée. Vous pouvez utiliser une image JPEG, GIF, PNG ou SVG, un objet Sprite ou un fichier SWF comme image de curseur.
Toutes les méthodes et propriétés de la classe CursorManager sont statiques. Vous n’avez donc pas besoin de leur créer une instance.
Dans AIR, chaque instance mx.core.Window utilise sa propre instance de la classe CursorManager. Au lieu de référencer directement les méthodes et propriétés statiques de la classe CursorManager, utilisez la propriété Window.cursorManager pour référencer l’instance CursorManager de l’instance Window.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currentCursorID : int [statique]
ID du curseur personnalisé actuel, ou NO_CURSOR si le curseur système est affiché. | CursorManager | ||
| currentCursorXOffset : Number [statique]
Décalage x du curseur personnalisé, en pixels, par rapport au pointeur de la souris. | CursorManager | ||
| currentCursorYOffset : Number [statique]
Décalage y du curseur personnalisé, en pixels, par rapport au pointeur de la souris. | CursorManager | ||
| Méthode | Défini par | ||
|---|---|---|---|
getInstance():ICursorManager [statique]
Chaque instance mx.core.Window dans une application AIR possède sa propre instance CursorManager. | CursorManager | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
[statique]
Rend le curseur invisible. | CursorManager | ||
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
[statique]
Supprime tous les curseurs de la liste des curseurs et rétablit le curseur système. | CursorManager | ||
[statique]
Supprime le curseur occupé de la liste des curseurs. | CursorManager | ||
[statique]
Supprime un curseur de la liste des curseurs. | CursorManager | ||
[statique]
Affiche le curseur occupé. | CursorManager | ||
[statique]
Crée un curseur et lui attribue une priorité facultative. | CursorManager | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
[statique]
Rend le curseur visible. | CursorManager | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
| Style | Description | Défini par | ||
|---|---|---|---|---|
busyCursor | Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Habillage du curseur occupé. La valeur par défaut est mx.skins.halo.BusyCursor. | CursorManager | ||
busyCursorBackground | Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 La classe à utiliser comme enveloppe du curseur d’arrière-plan occupé. La valeur par défaut est le symbole « cursorStretch » dans le fichier Assets.swf. | CursorManager | ||
| Constante | Défini par | ||
|---|---|---|---|
| NO_CURSOR : int = 0 [statique]
Constante correspondant à la valeur de la propriété currentCursorID lorsqu’aucun curseur n’est géré par l’objet CursorManager et que par conséquent le curseur système est affiché. | CursorManager | ||
currentCursorID | propriété |
currentCursorID:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
ID du curseur personnalisé actuel, ou NO_CURSOR si le curseur système est affiché.
Implémentation
public static function get currentCursorID():int public static function set currentCursorID(value:int):voidcurrentCursorXOffset | propriété |
currentCursorXOffset:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Décalage x du curseur personnalisé, en pixels, par rapport au pointeur de la souris.
La valeur par défaut est 0.
Implémentation
public static function get currentCursorXOffset():Number public static function set currentCursorXOffset(value:Number):voidcurrentCursorYOffset | propriété |
currentCursorYOffset:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Décalage y du curseur personnalisé, en pixels, par rapport au pointeur de la souris.
La valeur par défaut est 0.
Implémentation
public static function get currentCursorYOffset():Number public static function set currentCursorYOffset(value:Number):voidgetInstance | () | méthode |
public static function getInstance():ICursorManager| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaque instance mx.core.Window dans une application AIR possède sa propre instance CursorManager. Cette méthode renvoie l’instance CursorManager de l’instance Window principale.
Valeur renvoyéeICursorManager — Instance CursorManager de l’instance Window principale dans une application AIR.
|
hideCursor | () | méthode |
public static function hideCursor():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Rend le curseur invisible. La visibilité du curseur n’est pas fonction du nombre de références. Un seul appel de la méthode hideCursor() masque toujours le curseur, quel que soit le nombre d’appels de la méthode showCursor() effectués.
L’appel de cette méthode n’affecte pas le curseur système. Utilisez les méthodes Mouse.show() et Mouse.hide() pour contrôler directement le curseur système.
removeAllCursors | () | méthode |
public static function removeAllCursors():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime tous les curseurs de la liste des curseurs et rétablit le curseur système.
removeBusyCursor | () | méthode |
public static function removeBusyCursor():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime le curseur occupé de la liste des curseurs. Si d’autres demandes de curseur occupé sont toujours actives dans la liste des curseurs, ce qui signifie que vous avez appelé la méthode setBusyCursor() plusieurs fois, un curseur occupé ne peut pas disparaître tant que vous n’avez pas supprimé tous les curseurs occupés de la liste.
removeCursor | () | méthode |
public static function removeCursor(cursorID:int):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime un curseur de la liste des curseurs. Si le curseur en cours de suppression est le curseur actuellement affiché, l’objet CursorManager affiche le curseur suivant dans la liste, s’il en existe un. Si la liste est vide, l’objet CursorManager affiche le curseur système par défaut.
Paramètres
cursorID:int — ID du curseur à supprimer.
|
setBusyCursor | () | méthode |
public static function setBusyCursor():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Affiche le curseur occupé. Le curseur occupé a une priorité de CursorManagerPriority.LOW. Par conséquent, si la liste des curseurs contient un curseur doté d’une priorité supérieure, le curseur occupé n’est pas affiché tant que vous n’avez pas supprimé le curseur avec la priorité supérieure. Pour créer un curseur occupé à un niveau de priorité supérieure, utilisez la méthode setCursor().
setCursor | () | méthode |
public static function setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée un curseur et lui attribue une priorité facultative. Ajoute le nouveau curseur à la liste des curseurs.
Paramètres
cursorClass:Class — Classe du curseur à afficher.
| |
priority:int (default = 2)CursorManagerPriority.HIGH, CursorManagerPriority.MEDIUM et CursorManagerPriority.LOW.
| |
xOffset:Number (default = 0) | |
yOffset:Number (default = 0) |
int — ID du curseur.
|
Eléments de l’API associés
showCursor | () | méthode |
public static function showCursor():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Rend le curseur visible. La visibilité du curseur n’est pas fonction du nombre de références. Un seul appel de la méthode showCursor() affiche toujours le curseur, quel que soit le nombre d’appels de la méthode hideCursor() effectués.
L’appel de cette méthode n’affecte pas le curseur système. Utilisez les méthodes Mouse.show() et Mouse.hide() pour contrôler directement le curseur système.
NO_CURSOR | Constante |
public static const NO_CURSOR:int = 0| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constante correspondant à la valeur de la propriété currentCursorID lorsque aucun curseur n’est géré par l’objet CursorManager et que par conséquent le curseur système est affiché.
Tue Jun 12 2018, 09:30 AM Z