Paket | mx.managers |
Klasse | public class CursorManager |
Vererbung | CursorManager Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn die Anwendung beispielsweise eine Verarbeitung durchführt, auf deren Abschluss der Benutzer warten muss, können Sie einen speziellen Cursor während der Wartezeit (beispielsweise eine Sanduhr oder ein anderes Bild) anzeigen lassen.
Außerdem können Sie Benutzern durch einen geänderten Cursor mitteilen, welche Aktionen sie ausführen können. So lässt sich beispielsweise anhand unterschiedlicher Cursorbilder anzeigen, dass die Benutzereingabe aktiviert bzw. deaktiviert ist. Als Cursorbild können Sie ein JPEG-, GIF-, PNG- oder SVG-Bild, ein Sprite-Objekt oder eine SWF-Datei verwenden.
Alle Methoden und Eigenschaften des CursorManagers sind statisch, sodass Sie keine Instanz davon erstellen müssen.
In AIR verwendet jede mx.core.Window-Instanz eine eigene CursorManager-Klasse. Statt die statischen Methoden und Eigenschaften der CursorManager-Klasse direkt zu referenzieren, verwenden Sie die Window.cursorManager
-Eigenschaft zum Referenzieren der CursorManager-Instanz für die Window-Instanz.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentCursorID : int [statisch]
ID des aktuellen benutzerdefinierten Cursors oder NO_CURSOR, wenn der Systemcursor angezeigt wird. | CursorManager | ||
currentCursorXOffset : Number [statisch]
Der x-Offset des benutzerdefinierten Cursors in Pixeln relativ zum Mauszeiger. | CursorManager | ||
currentCursorYOffset : Number [statisch]
Der y-Offset des benutzerdefinierten Cursors in Pixeln relativ zum Mauszeiger. | CursorManager |
Methode | Definiert von | ||
---|---|---|---|
getInstance():ICursorManager [statisch]
Jede mx.core.Window-Instanz in einer AIR-Anwendung verfügt über eine eigene CursorManager-Instanz. | CursorManager | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
[statisch]
Der Cursor wird unsichtbar. | CursorManager | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
[statisch]
Entfernt alle Cursor von der Cursorliste und stellt den Systemcursor wieder her. | CursorManager | ||
[statisch]
Entfernt den Aktivitätencursor von der Cursorliste. | CursorManager | ||
[statisch]
Entfernt einen Cursor von der Cursorliste. | CursorManager | ||
[statisch]
Zeigt den Aktivitätencursor an. | CursorManager | ||
[statisch]
Erstellt einen neuen Cursor und legt eine optionale Prioritätsstufe für den Cursor fest. | CursorManager | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
[statisch]
Der Cursor wird sichtbar. | CursorManager | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.
Stil | Beschreibung | Definiert von | ||
---|---|---|---|---|
busyCursor | Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Die Skin für den Aktivitätencursor.. Der Standardwert ist mx.skins.halo.BusyCursor . | CursorManager | ||
busyCursorBackground | Typ: Class CSS-Vererbung: Nein Sprachversion: ActionScript 3.0 Produktversion: Flex 3 Laufzeitversionen: Flash9, AIR 1.1 Die als Skin für den Hintergrund des Aktivitätencursors verwendete Klasse. Der Standardwert ist das „cursorStretch“-Symbol aus der Datei „Assets.swf“. | CursorManager |
Konstante | Definiert von | ||
---|---|---|---|
NO_CURSOR : int = 0 [statisch]
Konstante, die dem Wert der Eigenschaft „currentCursorID“ angibt, wenn kein Cursor vom CursorManager verwaltet wird und daher der Systemcursor angezeigt wird. | CursorManager |
currentCursorID | Eigenschaft |
currentCursorID:int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
ID des aktuellen benutzerdefinierten Cursors oder NO_CURSOR, wenn der Systemcursor angezeigt wird.
Implementierung
public static function get currentCursorID():int
public static function set currentCursorID(value:int):void
currentCursorXOffset | Eigenschaft |
currentCursorXOffset:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der x-Offset des benutzerdefinierten Cursors in Pixeln relativ zum Mauszeiger.
Der Standardwert ist 0.
Implementierung
public static function get currentCursorXOffset():Number
public static function set currentCursorXOffset(value:Number):void
currentCursorYOffset | Eigenschaft |
currentCursorYOffset:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der y-Offset des benutzerdefinierten Cursors in Pixeln relativ zum Mauszeiger.
Der Standardwert ist 0.
Implementierung
public static function get currentCursorYOffset():Number
public static function set currentCursorYOffset(value:Number):void
getInstance | () | Methode |
public static function getInstance():ICursorManager
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Jede mx.core.Window-Instanz in einer AIR-Anwendung verfügt über eine eigene CursorManager-Instanz. Diese Methode gibt die CursorManager-Instanz für die Hauptfenster-Instanz zurück.
RückgabewerteICursorManager — Die CursorManager-Instanz für die Hauptfenster-Instanz in einer AIR-Anwendung.
|
hideCursor | () | Methode |
public static function hideCursor():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Cursor wird unsichtbar. Die Sichtbarkeit des Cursors wird nicht bei der Referenzzählung berücksichtigt. Durch einen einzigen Aufruf der hideCursor()
-Methode wird der Cursor ausgeblendet, unabhängig von der Anzahl der showCursor()
-Aufrufe.
Das Aufrufen dieser Methode wirkt sich nicht auf den Systemcursor aus. Mit der Mouse.show()
- und der Mouse.hide()
-Methode können Sie den Systemcursor direkt steuern.
removeAllCursors | () | Methode |
public static function removeAllCursors():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt alle Cursor von der Cursorliste und stellt den Systemcursor wieder her.
removeBusyCursor | () | Methode |
public static function removeBusyCursor():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt den Aktivitätencursor von der Cursorliste. Wenn andere Aktivitätencursor-Anforderungen in der Cursorliste noch aktiv sind, d. h. Sie haben die setBusyCursor()
-Methode mehrmals aufgerufen, wird der Aktivitätencursor solange angezeigt, bis Sie alle Aktivitätencursor von der Liste entfernt haben.
removeCursor | () | Methode |
public static function removeCursor(cursorID:int):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt einen Cursor von der Cursorliste. Ist der zu entfernende Cursor gerade aktiv, dann wird der CursorManager neben dem nächsten Cursor in der Liste, wenn vorhanden, angezeigt. Wenn die Liste leer ist, wird der CursorManager neben dem standardmäßigen Systemcursor angezeigt.
Parameter
cursorID:int — ID des zu entfernenden Cursors.
|
setBusyCursor | () | Methode |
public static function setBusyCursor():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Zeigt den Aktivitätencursor an. Die Priorität des Aktivitätencursor entspricht CursorManagerPriority.LOW. Wenn die Cursorliste einen Cursor mit einer höheren Priorität enthält, wird der Aktivitätencursor erst angezeigt, wenn Sie den Cursor mit höherer Priorität entfernen. Um einen Aktivitätencursor mit einer höheren Priorität zu erstellen, verwenden Sie die setCursor()
-Methode.
setCursor | () | Methode |
public static function setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt einen neuen Cursor und legt eine optionale Prioritätsstufe für den Cursor fest. Fügt der Cursorliste einen neuen Cursor hinzu.
Parameter
cursorClass:Class — Anzuzeigende Klasse des Cursors.
| |
priority:int (default = 2 ) — Ganzzahl, die die Prioritätsstufe des Cursors angibt. Gültige Werte sind CursorManagerPriority.HIGH , CursorManagerPriority.MEDIUM und CursorManagerPriority.LOW .
| |
xOffset:Number (default = 0 ) — Eine Zahl, die den x-Offset des Cursors relativ zum Mauszeiger in Pixeln angibt.
| |
yOffset:Number (default = 0 ) — Eine Zahl, die den y-Offset des Cursors relativ zum Mauszeiger in Pixeln angibt.
|
int — Die ID des Cursors.
|
Verwandte API-Elemente
showCursor | () | Methode |
public static function showCursor():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Cursor wird sichtbar. Die Sichtbarkeit des Cursors wird nicht bei der Referenzzählung berücksichtigt. Durch einen einzigen Aufruf der showCursor()
-Methode wird der Cursor eingeblendet, unabhängig von der Anzahl der hideCursor()
-Aufrufe.
Das Aufrufen dieser Methode wirkt sich nicht auf den Systemcursor aus. Mit der Mouse.show()
- und der Mouse.hide()
-Methode können Sie den Systemcursor direkt steuern.
NO_CURSOR | Konstante |
public static const NO_CURSOR:int = 0
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstante, die den Wert der Eigenschaft currentCursorID
angibt, wenn kein Cursor vom CursorManager verwaltet wird und daher der Systemcursor angezeigt wird.
Tue Jun 12 2018, 10:04 AM Z