| Пакет | mx.collections |
| Класс | public class GroupingCollection |
| Наследование | GroupingCollection  HierarchicalData EventDispatcher Object |
| Реализует | IGroupingCollection |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Для заполнения элемента управления AdvancedDataGrid группированными данными следует создать экземпляр класса GroupingCollection из плоских данных и передать его поставщику данных элемента управления AdvancedDataGrid. Для указания полей группировки плоских данных следует передать экземпляр группировки в свойство GroupingCollection.grouping. Экземпляр группировки содержит экземпляры массива GroupingField, по одному для каждого поля группировки.
В следующем примере для определения полей группировки «Регион» и «Территория» используется класс GroupingCollection.
<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
Показать синтаксис MXML
Скрыть синтаксис MXML<mx.GroupingCollection> inherits all the tag attributes of its superclass,
and defines the following tag attributes:
<mx:GroupingCollection
Properties
grouping="No default"
source="No default"
summaries="No default"
/>
This Class has been deprecated and replaced by a new Class
GroupingCollection2 which provide faster,
improved performance and a new summary calculation mechanism.
Class SummaryField has also been deprecated and
replaced by a new Class SummaryField2.
Properties operation and summaryFunction are
not present in the Class SummaryField2.
A new property summaryOperation is introduced in
SummaryField2.
Свойство MXML по умолчаниюgrouping
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
 | childrenField : String
Указывает имя поля, используемое для обнаружения объектов нижестоящих элементов в элементе данных. | HierarchicalData | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| grouping : Grouping
Указывает экземпляр группировки, примененный к исходным данным. | GroupingCollection | ||
| source : Object [переопределить]
Исходная коллекция, содержащая группируемые плоские данные. | GroupingCollection | ||
| summaries : Array
Массив экземпляров SummaryRow, определяющих любые сводки данных корневого уровня. | GroupingCollection | ||
| Свойство | Определено | ||
|---|---|---|---|
| timer : flash.utils:Timer
Таймер, связанный с операцией асинхронного обновления. | GroupingCollection | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | GroupingCollection | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Обновление, выполняемое асинхронно, отменяет операцию обновления и останавливает формирование групп. | GroupingCollection | ||
|
Возвращает значение true, если узел может содержать нижестоящие элементы. | HierarchicalData | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает объект, представляющий нижестоящие элементы узла. | HierarchicalData | |
|
Возвращает данные из узла. | HierarchicalData | |
[переопределить]
Если установлено свойство grouping возвращается значение super.source, в противном случае – экземпляр ICollectionView, ссылающийся на super.source. | GroupingCollection | ||
|
Возвращает значение true, если узел имеет нижестоящие элементы. | HierarchicalData | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Применяет группировку к представлению. | GroupingCollection | ||
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Возвращает вышестоящий узел. | GroupingCollection | ||
grouping | свойство |
grouping:Grouping| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает экземпляр группировки, примененный к исходным данным. Настройка свойства grouping не приводит к автоматическому обновлению представления, поэтому после установки этого свойства следует вызвать метод refresh().
Реализация
public function get grouping():Grouping public function set grouping(value:Grouping):voidСвязанные элементы API
source | свойство |
source:Object[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Исходная коллекция, содержащая группируемые плоские данные. Источник, который не является коллекцией, автоматически преобразуется в коллекцию.
Реализация
override public function get source():Object override public function set source(value:Object):voidsummaries | свойство |
public var summaries:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Массив экземпляров SummaryRow, определяющих любые сводки данных корневого уровня. Следует указать один или несколько экземпляров SummaryRow для определения сводки данных, как это показано в следующем примере:
<mx:AdvancedDataGrid id="myADG"
width="100%" height="100%"
initialize="gc.refresh();">
<mx:dataProvider>
<mx:GroupingCollection id="gc" source="{dpFlat}">
<mx:summaries>
<mx:SummaryRow summaryPlacement="last">
<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:Grouping>
<mx:GroupingField name="Region"/>
<mx:GroupingField name="Territory"/>
</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
timer | свойство |
protected var timer:flash.utils:Timer| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Таймер, связанный с операцией асинхронного обновления. Можно использовать для изменения временного интервала, приостановки обновления или выполнения других действий. Значение по умолчанию для свойства delay экземпляра таймера равно 1, что соответствует 1 миллисекунде.
GroupingCollection | () | Конструктор |
public function GroupingCollection()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
cancelRefresh | () | метод |
public function cancelRefresh():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Обновление, выполняемое асинхронно, отменяет операцию обновления и останавливает формирование групп. Этот метод отменяет обновление, если оно инициируется только вызовом метода refresh() с аргументом true, соответствующим асинхронному обновлению.
getParent | () | метод |
protected function getParent(node:Object):*| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает вышестоящий узел. Вышестоящий элемент узла верхнего уровня содержит значение null.
Параметры
node:Object — Object, определяющий узел.
|
* — Вышестоящий узел, содержащий данный узел в качестве нижестоящего, для узла верхнего уровня используется значение null, и undefined, если вышестоящий элемент определить невозможно.
|
getRoot | () | метод |
override public function getRoot():Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если установлено свойство grouping возвращается значение super.source, в противном случае – экземпляр ICollectionView, ссылающийся на super.source.
Object — Возвращаемый объект.
|
refresh | () | метод |
public function refresh(async:Boolean = false):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Применяет группировку к представлению. IGroupingCollection не обнаруживает изменений группы автоматически, поэтому для обновления представления после установки свойства group следует вызвать метод refresh().
Метод refresh() можно применять асинхронно путем вызова refresh(true).
При синхронном вызове refresh() клиент должен ожидать события CollectionEvent со значением свойства kind, равным CollectionEventKind.REFRESH, для обеспечения завершения метода refresh().
Параметры
async:Boolean (default = false)true определяет асинхронное обновление. Значение по умолчанию равно false, обозначая синхронное обновление.
|
Boolean — Значение равно true при завершении метода refresh() и false, если обновление остается незавершенным, т. е. элементы по-прежнему могут находиться в состоянии ожидания.
|
Tue Jun 12 2018, 11:34 AM Z