Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: Sunucudan Veri Alınıyor...
Sunucudan Veri Alınıyor...
mx.collections 

Grouping  - AS3 Flex

Paketmx.collections
Sınıfpublic class Grouping
Miras AlmaGrouping Inheritance Object

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

The Grouping class defines the fields in the data provider of the AdvancedDataGrid control used to group data. You use this class to create groups when the input data to the AdvancedDataGrid control has a flat structure.

To populate the AdvancedDataGrid control with grouped data, you create an instance of the GroupingCollection class from your flat data, and then pass that GroupingCollection instance to the data provider of the AdvancedDataGrid control. To specify the grouping fields of your flat data, you pass a Grouping instance to the GroupingCollection.grouping property. The Grouping instance contains an Array of GroupingField instances, one per grouping field.

The following example uses the Grouping class to define two grouping fields: Region and Territory.

  <mx:AdvancedDataGrid id="myADG"    
    <mx:dataProvider> 
      <mx:GroupingCollection id="gc" source="{dpFlat}"> 
        <mx:grouping> 
          <mx:Grouping> 
            <mx:GroupingField name="Region"/> 
            <mx:GroupingField name="Territory"/> 
          </mx:Grouping> 
        </mx:grouping> 
      </mx:GroupingCollection> 
    </mx:dataProvider>  
     
    <mx:columns> 
      <mx:AdvancedDataGridColumn dataField="Region"/> 
      <mx:AdvancedDataGridColumn dataField="Territory"/> 
      <mx:AdvancedDataGridColumn dataField="Territory_Rep"/> 
      <mx:AdvancedDataGridColumn dataField="Actual"/> 
      <mx:AdvancedDataGridColumn dataField="Estimate"/> 
    </mx:columns> 
  </mx:AdvancedDataGrid>
  

MXML SözdizimiexpandedMXML Sözdizimini Gizle
The <mx.Grouping> tag defines the following tag attributes:

  <mx:Grouping
  Properties 
    compareFunction="No default"
    fields="null"
    groupingObjectFunction="No default"
    label="GroupLabel"
  />
  

Varsayılan MXML Özelliğifields

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
  compareFunction : Function
The method used to compare items when sorting.
Grouping
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  fields : Array
An Array of GroupingField objects that specifies the fields used to group the data.
Grouping
  groupingObjectFunction : Function
A callback function to run on each group node to determine the grouping object.
Grouping
  label : String = "GroupLabel"
The name of the field added to the flat data to create the hierarchy.
Grouping
Genel Yöntemler
 YöntemTanımlayan:
  
Constructor.
Grouping
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
Özellik Ayrıntısı

compareFunction

özellik
compareFunction:Function

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

The method used to compare items when sorting. If you specify this property, Flex ignores any compareFunction properties that you specify in the SortField objects that you use in this class.

The compare function must have the following signature:

         function [name](a:Object, b:Object, fields:Array=null):int

This function must return the following:

  • -1, if a should appear before b in the sorted sequence.
  • 0, if a equals b.
  • 1, if a should appear after b in the sorted sequence.

To return to the internal comparison function, set this value to null.

The fields Array specifies the object fields to compare. Typically, the algorithm will compare properties until the field list is exhausted or a non-zero value can be returned. For example:

        function myCompare(a:Object, b:Object, fields:Array=null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }

The default value is an internal compare function that can perform a string, numeric, or date comparison in ascending or descending order, with case-sensitive or case-insensitive string comparisons. Specify your own function only if you need a custom comparison algorithm. This is normally only the case if a calculated field is used in a display.

Alternatively, you can specify separate compare functions for each sort field by using the SortField class compare property. This way you can use the default comparison for some fields and a custom comparison for others.



Uygulama
    public function get compareFunction():Function
    public function set compareFunction(value:Function):void

fields

özellik 
fields:Array

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

An Array of GroupingField objects that specifies the fields used to group the data. The order of the GroupingField objects in the Array determines field priority order when sorting.

Varsayılan değer şudur null.



Uygulama
    public function get fields():Array
    public function set fields(value:Array):void

İlgili API Öğeleri

groupingObjectFunction

özellik 
public var groupingObjectFunction:Function

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

A callback function to run on each group node to determine the grouping object. By default, a new Object will be created for group nodes.

You can supply a groupingObjectFunction that provides the appropriate Object for group nodes.

The method signature is:

      myGroupObjectFunction(label:String):Object

Where label contains the value that will be shown for that group node. The function returns an Object which will be used for group nodes.

For example, a groupingObjectFunction which returns an Object containing a "name" property with value as "Bob" can be written as -
      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

label

özellik 
public var label:String = "GroupLabel"

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

The name of the field added to the flat data to create the hierarchy. The value of the top nodes (nodes representing the group fields) in every group will be represented by this property. Use this property to specify a different name.

Varsayılan değer şudur GroupLabel.

Yapıcı Ayrıntı

Grouping

()Yapıcı
public function Grouping()

Dil Sürümü: ActionScript 3.0
Ürün Sürümü: Flex 3
Çalışma Zamanı Sürümleri: Flash Player 9, AIR 1.1

Constructor.





[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.