| 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
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| 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):voidcurrentCursorXOffset | 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):voidcurrentCursorYOffset | 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):voidgetInstance | () | 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)CursorManagerPriority.HIGH, CursorManagerPriority.MEDIUM und CursorManagerPriority.LOW.
| |
xOffset:Number (default = 0) | |
yOffset:Number (default = 0) |
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