GroupingField  - AS3 Flex

Hat den Wert true, wenn die Sortierung für dieses Feld nicht zwischen Groß- und Kleinschreibung unterscheidet.

Der Standardwert ist false.

Die Funktion, die zwei Elemente bei der Sortierung von Elementen für die zugehörige Sammlung vergleicht. Wenn Sie die compareFunction-Eigenschaft in einem Grouping-Objekt angeben, ignoriert Flex alle compareFunction-Eigenschaften der GroupingField-Objekte.

Die Vergleichsfunktion muss folgende Signatur haben:

function myCompare(a:Object, b:Object):int

Diese Funktion muss folgende Werte zurückgeben:

• -1, wenn a in der sortierten Sequenz vor b erscheinen soll.
• 0, wenn a gleich b ist.
• -1, wenn a in der sortierten Sequenz nach b erscheinen soll.

Der Standardwert ist eine interne Vergleichsfunktion, die einen Vergleich von Strings, numerischen Werten oder Datumsangaben in aufsteigender oder absteigender Reihenfolge durchführen kann, wobei die Stringvergleiche zwischen Groß- und Kleinschreibung unterscheiden können. Geben Sie Ihre eigene Funktion nur an, wenn ein benutzerdefinierter Vergleichsalgorithmus erforderlich ist. Dies ist normalerweise nur der Fall, wenn ein berechnetes Feld in einer Anzeige verwendet wird.

Hat den Wert true, wenn die Sortierung für dieses Feld in absteigender Reihenfolge erfolgen soll.

Der Standardwert ist false.

Eine Funktion, die die Beschriftung für diese Gruppe bestimmt. Standardmäßig zeigt die Gruppe den Text für das Feld in den Daten, die zu dem Feld passen, das von der name-Eigenschaft angegeben wurde. Möglicherweise sollen jedoch die Elemente basierend auf mehreren Datenfeldern oder auf anderen Feldern, bei denen es sich nicht um einfache Stringfelder handelt, gruppiert werden. In diesem Fall legen Sie mit der groupingFunction-Eigenschaft eine Rückruffunktion fest.

Eine Rückruffunktion kann z. B. eine Zahl für den Monat in den String für den Monat konvertieren oder mehrere Elemente anhand von anderen Kriterien, als dem tatsächlichen Wert des Felds, in einer Gruppe zusammenfassen.

Für das GroupField-Steuerelement hat die Methodensignatur folgende Form:

groupingFunction(item:Object, field:GroupField):String

Dabei gilt: item enthält das Datenelementobjekt und field enthält das GroupField-Objekt.

      private function groupFunc(item:Object, field:GroupingField):String
      {
          return item[field.name].toString().substr(0, 1);
      }
      

Eine Callback-Funktion, die für jeden Gruppenknoten zum Bestimmen des Gruppierungsobjekts ausgeführt werden soll. Standardmäßig wird für Gruppenknoten ein neues Objekt erstellt.

Sie können eine groupingObjectFunction angeben, die das geeignete Objekt für Gruppenknoten bereitstellt.

Die Methodensignatur lautet wie folgt:

      myGroupObjectFunction(label:String):Object

Dabei enthält label den Wert, der für diesen Gruppenknoten angezeigt wird. Standardmäßig gibt die Funktion ein Objekt zurück, das für Gruppenknoten verwendet wird.

      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

Der Name des zu sortierenden Felds.

Der Standardwert ist null.

Gibt an, dass der Komparator einen numerischen Vergleich verwendet, wenn das sortierte Feld numerische Werte (number/int/uint) oder Stringdarstellungen numerischer Werte enthält. Wenn diese Eigenschaft false ist, werden Felder mit Stringdarstellungen von Zahlen mithilfe eines Stringvergleichs sortiert, sodass 100 vor 99 kommt, da „1“ ein kleinerer Stringwert als „9“ ist.

Der Standardwert ist false.

Array von SummaryRow-Instanzen, das die Übersichten auf Gruppenebene definiert. Gibt einen oder mehrere SummaryRow-Instanzen an, um die Datenübersichten zu definieren, wie im folgenden Beispiel:

      <mx:AdvancedDataGrid id="myADG" 
         width="100%" height="100%" 
         initialize="gc.refresh();">        
         <mx:dataProvider>
             <mx:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:Grouping>
                     <mx:GroupingField name="Region">
                       <mx:summaries>
                           <mx:SummaryRow summaryPlacement="group">
                             <mx:fields>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Min Actual" operation="MIN"/>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Max Actual" operation="MAX"/>
                             </mx:fields>
                           </mx:SummaryRow>
                         </mx:summaries>
                     </mx:GroupingField>
                 </mx:Grouping>
             </mx:GroupingCollection>
         </mx:dataProvider>        
         
         <mx:columns>
             <mx:AdvancedDataGridColumn dataField="Region"/>
             <mx:AdvancedDataGridColumn dataField="Territory_Rep"
                 headerText="Territory Rep"/>
             <mx:AdvancedDataGridColumn dataField="Actual"/>
             <mx:AdvancedDataGridColumn dataField="Estimate"/>
             <mx:AdvancedDataGridColumn dataField="Min Actual"/>
             <mx:AdvancedDataGridColumn dataField="Max Actual"/>
         </mx:columns>
      </mx:AdvancedDataGrid>  
      

Verwandte API-Elemente

Konstruktor.