Paket | mx.collections |
Schnittstelle | public interface IViewCursor extends IEventDispatcher |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
createCursor()
-Methode von ICollectionView) sollte der Wert der current
-Eigenschaft das erste Element in der Ansicht sein, außer die Ansicht ist leer.
Eigenschaft | Definiert von | ||
---|---|---|---|
afterLast : Boolean [schreibgeschützt]
Wenn der Cursor sich hinter dem letzten Element in der Ansicht befindet, ist diese Eigenschaft „true“. | IViewCursor | ||
beforeFirst : Boolean [schreibgeschützt]
Wenn der Cursor sich vor dem ersten Element in der Ansicht befindet, ist diese Eigenschaft „true“. | IViewCursor | ||
bookmark : CursorBookmark [schreibgeschützt]
Bietet Zugriff auf ein Lesezeichen, das dem von der aktuellen Eigenschaft zurückgegebenen Element entspricht. | IViewCursor | ||
current : Object [schreibgeschützt]
Bietet Zugriff auf das Objekt an der Position in der Quellsammlung, die von diesem Cursor referenziert wird. | IViewCursor | ||
view : ICollectionView [schreibgeschützt]
Ein Verweis auf die ICollectionView, der dieser Cursor zugeordnet ist. | IViewCursor |
Methode | Definiert von | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | IEventDispatcher | ||
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | ||
Sucht in der Sammlung ein Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. | IViewCursor | ||
Sucht in der Sammlung das erste Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. | IViewCursor | ||
Sucht in der Sammlung das letzte Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. | IViewCursor | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | ||
Fügt das angegebene Element vor der aktuellen Cursor-Position ein. | IViewCursor | ||
Verschiebt den Cursor auf das nächste Element in der Sammlung. | IViewCursor | ||
Verschiebt den Cursor auf das vorherige Element in der Sammlung. | IViewCursor | ||
Entfernt das aktuelle Elemente und gibt es zurück. | IViewCursor | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | ||
Verschiebt den Cursor an eine Position an einem Offset vom angegebenen Lesezeichen. | IViewCursor | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
Wird ausgelöst, wenn die Cursorposition aktualisiert wird. | IViewCursor |
afterLast | Eigenschaft |
afterLast:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn der Cursor sich hinter dem letzten Element in der Ansicht befindet, ist diese Eigenschaft true
. Wenn die ICollectionView leer ist (length == 0), ist diese Eigenschaft true
.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das cursorUpdate
-Ereignis ausgelöst.
Implementierung
public function get afterLast():Boolean
beforeFirst | Eigenschaft |
beforeFirst:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn der Cursor sich vor dem ersten Element in der Ansicht befindet, ist diese Eigenschaft true
. Wenn die ICollectionView leer ist (length == 0), ist diese Eigenschaft true
.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das cursorUpdate
-Ereignis ausgelöst.
Implementierung
public function get beforeFirst():Boolean
bookmark | Eigenschaft |
bookmark:CursorBookmark
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bietet Zugriff auf ein Lesezeichen, das dem von der current
-Eigenschaft zurückgegebenen Element entspricht. Das Lesezeichen kann verwendet werden, um den Cursor an ein zuvor besuchtes Element oder eine Position relativ zu diesem Element zu verschieben. (Weitere Informationen finden Sie unter der seek()
-Methode.)
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das cursorUpdate
-Ereignis ausgelöst.
Implementierung
public function get bookmark():CursorBookmark
Verwandte API-Elemente
current | Eigenschaft |
current:Object
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bietet Zugriff auf das Objekt an der Position in der Quellsammlung, die von diesem Cursor referenziert wird. Wenn der Cursor sich hinter dem Ende der Sammlung befindet (beforeFirst
, afterLast
) wird null
zurückgegeben.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das cursorUpdate
-Ereignis ausgelöst.
Implementierung
public function get current():Object
Verwandte API-Elemente
view | Eigenschaft |
view:ICollectionView
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein Verweis auf die ICollectionView, der dieser Cursor zugeordnet ist.
Implementierung
public function get view():ICollectionView
findAny | () | Methode |
public function findAny(values:Object):Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sucht in der Sammlung ein Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.
Die findAny()
-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError
ausgegeben.
Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.
Wenn mehrere Elemente die Suchkriterien erfüllen, ist das gefundene Elemente nicht-deterministisch. Wenn es wichtig ist, das erste oder letzte Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findFirst()
- oder findLast()
-Methode.
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.
Parameter
values:Object — Die Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x , y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein.
|
Boolean — Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false .
|
Verwandte API-Elemente
findFirst | () | Methode |
public function findFirst(values:Object):Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sucht in der Sammlung das erste Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.
Die findFirst()
-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError
ausgegeben.
Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.
Wenn es nicht wichtig ist, das erste Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findAny()
-Methode, die möglicherweise ein wenig schneller ist als die findFirst()
-Methode.
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.
Parameter
values:Object — Die Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x , y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein.
|
Boolean — Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false .
|
Verwandte API-Elemente
findLast | () | Methode |
public function findLast(values:Object):Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Sucht in der Sammlung das letzte Element mit den angegebenen Eigenschaften und platziert den Cursor auf diesem Element. Wenn das Element nicht gefunden wird, ändert sich die Cursorposition nicht.
Die findLast()
-Methode kann nur für sortierte Ansichten aufgerufen werden. Wenn die Ansicht nicht sortiert ist, wird ein CursorError
ausgegeben.
Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung. Wenn bereits ein Abruf ausgeführt wird, wartet diese Methode, bis der Abruf beendet wurde, bevor eine weitere Abrufanforderung gestellt wird.
Wenn es nicht wichtig ist, das letzte Vorkommen eines Elements in einem nicht eindeutigen Index zu finden, verwenden Sie die findAny()
-Methode, die möglicherweise ein wenig schneller ist.
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben.
Parameter
values:Object — Die Suchkriterien. Die Werte im Objekt müssen als Name/Wert-Paare konfiguriert sein, wie in einem assoziativen Array (oder sie sind das zu suchende Objekt selbst). Die Werte der angegebenen Namen müssen Eigenschaften entsprechen, die für die Sortierung angegeben wurden. Beispiel: Wenn die Eigenschaften x , y und z in der aktuellen Sortierung enthalten sind, sollten die angegebenen Werte {x: x-value, y: y-value, z: z-value} sein.
|
Boolean — Wenn alle Daten lokal sind, gibt diese Methode true zurück, falls das Element gefunden werden kann, andernfalls false .
|
Verwandte API-Elemente
insert | () | Methode |
public function insert(item:Object):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fügt das angegebene Element vor der aktuellen Cursor-Position ein. Wenn der Cursor afterLast
ist, erfolgt die Einfügung am Ende der Ansicht. Wenn der Cursor bei einer nicht leeren Ansicht beforeFirst
ist, wird ein Fehler ausgegeben.
Parameter
item:Object — Das Element, das vor der aktuellen Cursor-Position eingefügt werden soll.
|
moveNext | () | Methode |
public function moveNext():Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Verschiebt den Cursor auf das nächste Element in der Sammlung. Bei Erfolg wird die Eigenschaft current
aktualisiert, um das Objekt an dieser neuen Position zu referenzieren. Gibt true
zurück, wenn die resultierende Eigenschaft current
gültig ist, andernfalls false
(der Eigenschaftswert ist afterLast
).
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben. Weitere Informationen zur Verwendung von ItemPendingError finden Sie in der ItemPendingError-Dokumentation und der Dokumentation zu den Sammlungen.
RückgabewerteBoolean — true , wenn noch in der Liste, false , wenn current ursprünglich den Wert afterLast hatte oder diesen Wert aktuell hat.
|
Verwandte API-Elemente
Beispiel
Verwendung dieses Beispiels
var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]); var cursor:IViewCursor = myArrayCollection.createCursor(); while (!cursor.afterLast) { trace(cursor.current); cursor.moveNext(); }
movePrevious | () | Methode |
public function movePrevious():Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Verschiebt den Cursor auf das vorherige Element in der Sammlung. Bei Erfolg wird die Eigenschaft current
aktualisiert, um das Objekt an dieser neuen Position zu referenzieren. Gibt true
zurück, wenn die resultierende Eigenschaft current
gültig ist, andernfalls false
(der Eigenschaftswert ist beforeFirst
).
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben. Weitere Informationen zur Verwendung von ItemPendingError finden Sie in der ItemPendingError-Dokumentation und der Dokumentation zu den Sammlungen.
RückgabewerteBoolean — true , wenn noch in der Liste, false , wenn current ursprünglich den Wert beforeFirst hatte oder diesen Wert aktuell hat. Beispiel:
var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]); var cursor:IViewCursor = myArrayCollection.createCursor(); cursor.seek(CursorBookmark.last); while (!cursor.beforeFirst) { trace(current); cursor.movePrevious(); } |
Verwandte API-Elemente
remove | () | Methode |
public function remove():Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt das aktuelle Elemente und gibt es zurück. Wenn die Cursorposition beforeFirst
oder afterLast
ist, gibt die Methode einen CursorError aus. Wenn Sie ein anderes Element als das letzte Element entfernen, wird der Cursor zum nächsten Element verschoben. Wenn Sie das letzte Element entfernen, befindet sich der Cursor beim AFTER_LAST-Lesezeichen.
Wenn die Daten nach dem entfernten Element nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben. Weitere Informationen zur Verwendung von ItemPendingError finden Sie in der ItemPendingError-Dokumentation und der Dokumentation zu den Sammlungen.
RückgabewerteObject — Das entfernte Element.
|
Verwandte API-Elemente
seek | () | Methode |
public function seek(bookmark:CursorBookmark, offset:int = 0, prefetch:int = 0):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Verschiebt den Cursor an eine Position an einem Offset vom angegebenen Lesezeichen. Der Offset kann negativ sein. In diesem Fall wird der Cursor um die in offset
angegebene Anzahl von Elementen vor dem angegebenen Lesezeichen platziert.
Wenn die zugehörige Sammlung remote ist und nicht alle Elemente lokal zwischengespeichert wurden, beginnt diese Methode einen asynchronen Abruf aus der Remote-Sammlung.
Wenn die Daten nicht lokal sind und ein asynchroner Vorgang ausgeführt werden muss, wird ein ItemPendingError ausgegeben. Weitere Informationen zur Verwendung von ItemPendingError finden Sie in der ItemPendingError-Dokumentation und der Dokumentation zu den Sammlungen.
Parameter
bookmark:CursorBookmark — CursorBookmark -Verweis auf Markeninformationen, die eine Neuplatzierung an einer bestimmten Position ermöglichen. Sie können diesen Parameter auf den Wert setzen, der von der bookmark -Eigenschaft zurückgegeben wurde, oder auf einen der folgenden konstanten Lesezeichenwerte:
| |
offset:int (default = 0 ) — Gibt an, wie weit vom angegebenen Lesezeichen gesucht werden soll. Wenn die angegebene Zahl negativ ist, versucht der Cursor, sich vor dem angegebene Lesezeichen zu platzieren. Wenn der angegebene Offset sich nach dem Ende der Sammlung befindet, wird der Cursor hinter das Ende platziert, an die Position beforeFirst oder afterLast .
| |
prefetch:int (default = 0 ) — Wird für Remote-Daten verwendet. Gibt eine Priorität an, die Sammlung in einer angegebene Richtung zu durchlaufen, wenn der Suchvorgang abgeschlossen wurde. Dies verringert die Anzahl der erforderlichen Netzwerk-Roundtrips bei einer Suche. Wenn die Durchlaufrichtung zum Zeitpunkt der Anforderung bekannt ist, kann die geeignete Datenmenge zurückgegeben werden, bevor die Anforderung die Daten durchläuft.
|
Verwandte API-Elemente
cursorUpdate | Ereignis |
mx.events.FlexEvent
Eigenschaft FlexEvent.type =
mx.events.FlexEvent.CURSOR_UPDATE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn die Cursorposition aktualisiert wird.
DieFlexEvent.CURSOR_UPDATE
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein cursorUpdate
-Ereignis.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget -Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
Tue Jun 12 2018, 10:04 AM Z