ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.managers 

CursorManager  - AS3 Flex
Paketmx.managers
Klassepublic class CursorManager
VererbungCursorManager Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die CursorManager-Klasse steuert eine priorisierte Cursorliste, in der jeweils der Cursor mit der höchsten Priorität sichtbar ist. Wenn die Cursorliste mehrere Cursor mit derselben Priorität enthält, zeigt der Cursor-Manager den zuletzt erstellten Cursor an.

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

mx.managers.CursorManagerPriority
mx.core.Window

Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert von
  
getInstance():ICursorManager
[statisch] Jede mx.core.Window-Instanz in einer AIR-Anwendung verfügt über eine eigene CursorManager-Instanz.
CursorManager
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
hideCursor():void
[statisch] Der Cursor wird unsichtbar.
CursorManager
 Inherited
isPrototypeOf(theClass:Object):Boolean
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
removeAllCursors():void
[statisch] Entfernt alle Cursor von der Cursorliste und stellt den Systemcursor wieder her.
CursorManager
  
removeBusyCursor():void
[statisch] Entfernt den Aktivitätencursor von der Cursorliste.
CursorManager
  
removeCursor(cursorID:int):void
[statisch] Entfernt einen Cursor von der Cursorliste.
CursorManager
  
setBusyCursor():void
[statisch] Zeigt den Aktivitätencursor an.
CursorManager
  
setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
[statisch] Erstellt einen neuen Cursor und legt eine optionale Prioritätsstufe für den Cursor fest.
CursorManager
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
showCursor():void
[statisch] Der Cursor wird sichtbar.
CursorManager
 Inherited
toLocaleString():String
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
toString():String
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Stile

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.

Allgemeine Stile
Klicken Sie, um weitere Informationen zu Stilen zu erhalten.
 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
Öffentliche Konstanten
 KonstanteDefiniert 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
Eigenschaftendetails

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
Methodendetails

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ückgabewerte
ICursorManager — 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.

Rückgabewerte
int — Die ID des Cursors.

Verwandte API-Elemente

mx.managers.CursorManagerPriority

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.

Konstantendetails

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.




© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.