GroupingField  - AS3 Flex

Следует установить значение равным true, если сортировка для этого поля не должна зависеть от регистра.

Значением по умолчанию является false.

Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. Если указать свойство compareFunction в объекте группировки, то в компоненте Flex игнорируются любые свойства compareFunction объектов GroupingField.

Функция сравнения должна иметь следующую подпись:

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

Эта функция должна возвращать следующие значения:

• -1, если a должно появиться перед b в сортированной последовательности;
• 0, если a равно b;
• 1, если a должно появиться после b в сортированной последовательности.

Значение по умолчанию представляет собой внутреннюю функцию сравнения, которая может выполнять сравнение строк, чисел или дат в восходящем или нисходящем порядке, с учетом или без учета регистра. Указывать собственную функцию следует только в том случае, если необходим пользовательский алгоритм сравнения. Обычно он применяется только в том только случае, если в отображении используется вычисленное поле.

Следует установить значение равным true, если сортировка для этого поля должна происходить в порядке убывания.

Значением по умолчанию является false.

Функция, определяющая метку для этой группы. По умолчанию группа отображает текст для поля в данных, которые соответствуют полю, указанному свойством name. Однако иногда требуется группировать элементы на основании нескольких полей данных или критерия, не являющегося простым поле строки. В таком случае, определение функции обратного вызова осуществляется с помощью свойства groupingFunction.

Функция обратного вызова может преобразовать номер месяца в строку месяца или сгруппировать несколько элементов в отдельную группу на основании критериев, отличающихся от фактического значения поля.

Для GroupField подпись метода имеет следующую форму:

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

Где item содержит объект элемента данных, а field – объект GroupField.

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

Функция обратного вызова для запуска в каждом узле группы при определении объекта группировки. По умолчанию для узлов группы создается новый объект.

Можно ввести функцию groupingObjectFunction, предоставляющую соответствующий объект для узлов группы.

Подпись метода:

      myGroupObjectFunction(label:String):Object

где в label содержится значение, которое будет показано для данного узла группы. Функция возвращает объект, который будет использоваться для узлов группы.

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

Имя поля для сортировки.

Значением по умолчанию является null.

Указывает, что если сортируемое поле содержит числовые значения (Number/int/uint) или строковые представления числовых значений, то устройство сравнения использует числовые сравнение. Если это свойство равно false, то поля со строковыми представлениями чисел сортируются с использованием сравнения строк, таким образом, 100 предшествует 99, поскольку 1 – более низкое строковое значение чем 9.

Значением по умолчанию является false.

Массив экземпляров SummaryRow, определяющих сводки уровня группы. Следует указать один или несколько экземпляров SummaryRow для определения сводки данных, как это показано в следующем примере:

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

Связанные элементы API

Конструктор.