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...
spark.events 

GridSortEvent  - AS3 Flex

Paketspark.events
Klassepublic class GridSortEvent
VererbungGridSortEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die GridSortEvent-Klasse stellt Ereignisse dar, die ausgelöst werden, wenn der Datenprovider eines Spark-DataGrid-Steuerelements sortiert wird, weil der Benutzer auf die Überschrift einer Spalte im DataGrid geklickt hat.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
  columnIndices : Vector.<int>
Vektor von Spaltenindexpositionen der sortierten Spalten.
GridSortEvent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  newSortFields : Array
Das Array von ISortFields für diese Sortierung.
GridSortEvent
  oldSortFields : Array
[schreibgeschützt] Das Array von ISortFields für die letzte Sortierung.
GridSortEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
GridSortEvent(type:String, bubbles:Boolean, cancelable:Boolean, columnIndices:Vector.<int>, oldSortFields:Array, newSortFields:Array)
Konstruktor.
GridSortEvent
 Inherited
Dupliziert eine Instanz einer Event-Unterklasse.
Event
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  SORT_CHANGE : String = "sortChange"
[statisch] Die GridSortEvent.SORT_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein sortChange-Ereignis, wobei angegeben wird, dass ein Sortierungsfilter auf die dataProvider-Sammlung des Rasters angewendet wurde.
GridSortEvent
  SORT_CHANGING : String = "sortChanging"
[statisch] Die GridSortEvent.SORT_CHANGING-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein sortChanging-Ereignis, wobei angegeben wird, dass ein Sortierungsfilter in Kürze auf die dataProvider-Sammlung des Rasters angewendet wird.
GridSortEvent
Eigenschaftendetails

columnIndices

Eigenschaft
public var columnIndices:Vector.<int>

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Vektor von Spaltenindexpositionen der sortierten Spalten. Wenn der Typ GridSelectionEvent.SORT_CHANGING ist, kann dieser Wert modifiziert werden und zur Aktualisierung der columnHeaderGroup visibleSortIndicatorIndices des Rasters verwendet werden.

Verwandte API-Elemente

newSortFields

Eigenschaft 
public var newSortFields:Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Das Array von ISortFields für diese Sortierung. Wenn der Typ GridSelectionEvent.SORT_CHANGING ist, kann dieser Wert modifiziert werden. Er wird dazu verwendet, den dataProvider des Rasters zu sortieren.

Verwandte API-Elemente

oldSortFields

Eigenschaft 
oldSortFields:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Das Array von ISortFields für die letzte Sortierung. Dies kann null sein. Die Elemente in diesem Array sollten nicht modifiziert werden.



Implementierung
    public function get oldSortFields():Array

Verwandte API-Elemente

Konstruktordetails

GridSortEvent

()Konstruktor
public function GridSortEvent(type:String, bubbles:Boolean, cancelable:Boolean, columnIndices:Vector.<int>, oldSortFields:Array, newSortFields:Array)

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Konstruktor.

Parameter
type:String — Der Ereignistyp, der die Aktion angibt, durch die das Ereignis ausgelöst wurde.
 
bubbles:Boolean — Gibt an, ob das Ereignis in der Anzeigelistenhierarchie propagiert werden kann.
 
cancelable:Boolean — Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
 
columnIndices:Vector.<int> — Vektor von Spaltenindexpositionen der sortierten Spalten.
 
oldSortFields:Array — Das Array von ISortFields für die letzte Sortierung.
 
newSortFields:Array — Das Array von ISortFields für diese Sortierung.
Konstantendetails

SORT_CHANGE

Konstante
public static const SORT_CHANGE:String = "sortChange"

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die GridSortEvent.SORT_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein sortChange-Ereignis. Dieses zeigt an, dass ein Sortierfilter auf die dataProvider-Sammlung des Rasters angewendet wurde.

Wenn eine Spaltenüberschrift durch einen Mausklick ausgelöst wird, ist die letzte Indexposition der columnIndices in der Regel die Indexposition der Spalte. Beachten Sie, dass interaktive Sortierungen nicht unbedingt von einem Mausklick ausgelöst werden.

Dieses Ereignis wird ausgelöst, wenn der Benutzer mit dem Steuerelement interagiert. Wenn Sie die Sammlung des Datenproviders programmgesteuert sortieren, löst die Komponente kein sortChange-Ereignis aus.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
columnIndicesVektor von Spaltenindexpositionen der sortierten Spalten.
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myDataGrid.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert myDataGrid auf.
newSortFieldsDas Array von ISortFields für diese Sortierung.
oldSortFieldsDas Array von ISortFields für die letzte Sortierung.
targetDas 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.
typeGridSelectionEvent.SORT_CHANGE

Verwandte API-Elemente

SORT_CHANGING

Konstante 
public static const SORT_CHANGING:String = "sortChanging"

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die GridSortEvent.SORT_CHANGING-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein sortChanging-Ereignis, wobei angegeben wird, dass ein Sortierungsfilter in Kürze auf die dataProvider-Sammlung des Rasters angewendet wird. Rufen Sie preventDefault() für dieses Ereignis auf, um die Sortierung zu verhindern, oder ändern Sie columnIndices und newSortFields, wenn Sie das Standardverhalten der Sortierung ändern wollen.

Wenn eine Spaltenüberschrift durch einen Mausklick ausgelöst wird, ist die letzte Indexposition der columnIndices in der Regel die Indexposition der Spalte. Beachten Sie, dass interaktive Sortierungen nicht unbedingt von einem Mausklick ausgelöst werden.

Dieses Ereignis wird ausgelöst, wenn der Benutzer mit dem Steuerelement interagiert. Wenn Sie die Sammlung des Datenproviders programmgesteuert sortieren, löst die Komponente kein sortChanging-Ereignis aus.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
columnIndicesVektor der Spaltenindexpositionen der sortierten Spalten.
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myDataGrid.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert myDataGrid auf.
newSortFieldsDas Array von ISortFields für diese Sortierung.
oldSortFieldsDas Array von ISortFields für die letzte Sortierung.
targetDas 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.
typeGridSelectionEvent.SORT_CHANGING

Verwandte API-Elemente





[ 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.