mx.collectionsItemResponder Класс ItemResponder обеспечивает реализацию по умолчанию интерфейса mx.rpc.IResponder.mx.rpc:IResponderObject Класс ItemResponder обеспечивает реализацию по умолчанию интерфейса mx.rpc.IResponder. Он представляет собой ответчик, позволяющий указывать методы, вызываемые при завершении запроса, вне зависимости от его успешности. Объект класса также позволяет предоставлять данные (маркер), используемые методами ответчика.

При использовании объекта ItemResponder в операторе catch блока try можно получить удаленные данные, как это показано в следующем коде:


     import mx.collections.ItemResponder;
     //...
 
     try
     {
        //...
        cursor.moveNext();
     }
    catch(e:ItemPendingError)
     {
        e.addResponder(new ItemResponder(myResultFunction, myFaultFunction, {info:"..."}));
     }

Указанный метод результата должен иметь следующую подпись:

     public function myResultFunction(result:Object, token:Object = null):void;

Указанный метод ошибки должен иметь следующую подпись:

     public function myFaultFunction(error:Object, token:Object = null):void;

Использование любой другой подписи приведет к ошибке во время выполнения.

mx.collections.errors.ItemPendingErrorItemResponder Создает экземпляр ответчика с указанными данными и обработчиками.resultФункция, которую требуется вызывать при успешном выполнении запроса. При этом требуется следующая подпись: 
	     		    public function (result:Object, token:Object = null):void;
faultФункция, которую требуется вызывать при выполнении запроса с ошибками. При этом требуется следующая подпись: 
	     		    public function (error:ErrorMessage, token:Object = null):void;
tokennullДополнительная информация [не обязательно] об объекте для связи с этим запросом. Этот объект передается в функции результата и ошибки в качестве второго параметра. Создает экземпляр ответчика с указанными данными и обработчиками. fault Этот метод вызывается службой при получении ошибки.infoОбъект, содержащий информацию об ошибке. Этот метод вызывается службой при получении ошибки. result Этот метод вызывается службой при получении возвращаемого значения.dataОбъект, содержащий информацию, возвращенную из запроса. Этот метод вызывается службой при получении возвращаемого значения. Sort Предоставляет информацию о сортировке, необходимую для сортировки в существующем представлении (интерфейс ICollectionView или класс, реализующий интерфейс). The <mx:Sort> tag has the following attributes:

  <mx:Sort
  Properties
  compareFunction="Internal compare function"
  fields="null"
  unique="false | true"
  />

In case items have inconsistent data types or items have complex data types, the use of the default built-in compare functions is not recommended. Inconsistent sorting results may occur in such cases. To avoid such problem, provide a custom compare function and/or make the item types consistent.

Just like any other AdvancedStyleClient-based classes, the Sort and SortField classes do not have a parent-child relationship in terms of event handling. Locale changes in a Sort instance are not dispatched to its SortField instances automatically. The only exceptional case is the internal default SortField instance used when no explicit fields are provided. In this case, the internal default SortField instance follows the locale style that the owner Sort instance has.

]]>mx.collections:ISortflash.events:EventDispatcher Предоставляет информацию о сортировке, необходимую для сортировки в существующем представлении (интерфейс ICollectionView или класс, реализующий интерфейс). После назначения экземпляра сортировки свойству представления sort следует вызвать метод представления refresh() для применения критериев сортировки. Обычно сортировка определяется для коллекций составных элементов, т.е. для коллекций, в которых сортировка выполняется для одного или более свойств объектов коллекции. В следующем примере показано использование этого свойства: 

     var col:ICollectionView = new ArrayCollection();
     // In the real world, the collection would have more than one item.
     col.addItem({first:"Anders", last:"Dickerson"});
     // Create the Sort instance.
     var sort:Sort = new Sort();
     // Set the sort field; sort on the last name first, first name second.
     // Both fields are case-insensitive.
     sort.fields = [new SortField("last",true), new SortField("first",true)];
       // Assign the Sort object to the view.
     col.sort = sort;
     // Apply the sort to the collection.
     col.refresh();

Возможны ситуации, в которых коллекция содержит простые элементы, подобные String, Date, Boolean и т. д. В этом случае следует применять сортировку непосредственно к простому типу. При создании сортировки для простых элементов следует использовать отдельное поле сортировки и указать (первый) параметр name как null в конструкторе объектов SortField. Например: 


     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     // There is only one sort field, so use a null 
     // first parameter.
     sort.fields = [new SortField(null, true)];
     col.sort = sort;
     col.refresh();

В реализациях Flex интерфейса ICollectionView все элементы извлекаются из удаленного местоположения перед выполнением сортировки. При использовании подкачки страниц с сортированным списком к удаленной коллекции перед извлечением данных следует применить сортировку.

По умолчанию этот класс Sort не обеспечивает правильную языковую сортировку для строк. Для получения информации об этом типе сортировки см. описание классов spark.collections.Sort и spark.collections.SortField.

mx.collections.ICollectionViewISortFieldspark.collections.Sortspark.collections.SortFieldSort Конструктор. Конструктор.

Создает новую сортировку без установленных полей и пользовательского устройства сравнения.

findItem Поиск указанного объекта в пределах указанного массива (или места вставки при запросе); при обнаружении возвращается индекс, в противном случае – -1.int Индекс в массиве найденного элемента. Если параметр returnInsertionIndex равен false и элемент не найден, возвращает -1. Если параметр returnInsertionIndex равен true и элемент не найден, возвращает индекс точки в сортированном массиве, где следует вставить значения. itemsМассив, в пределах которого выполняется поиск. valuesОбъект, содержащий свойства для поиска (или сам объект для поиска). Объект должен состоять из пар «имя/значение поля», в которых имена полей определяются свойством fields в порядке их использования в этом свойстве. Необязательно перечислять все поля свойства fields, однако поле не может быть пропущено в последовательности. Поэтому если в свойстве fields перечисляются три поля, то можно указать только первое и второе поля, но нельзя указать первое и третье, пропустив второе. modeСтрока, содержащая тип нахождения для выполнения. Допустимые значения: ANY_INDEX_MODEВозвращает любую позицию, которая является допустимой для этих значений. FIRST_INDEX_MODE Возвращает позицию, где найдено первое вхождение значений. LAST_INDEX_MODE Возвращает позицию, где произошло последнее вхождение указанных значений. returnInsertionIndexfalseЕсли метод не находит элемент, идентифицируемый параметром values, и этот параметр равен true, метод findItem() возвращает место вставки для значений, которое в сортированной последовательности является точкой вставки элемента. compareFunctionnullфункция устройства сравнения для использования при нахождении элемента. Если этот параметр не определен или указано значение null, функция findItem() использует функцию compare, определенную ISort в свойстве compareFunction экземпляра, с передачей данных в массив полей, которые определены объектом значений и текущим SortFields. Если указано ненулевое значение, функция findItem() использует его как функцию compare. Для функции, передаваемой как compareFunction, необходимо указать следующую подпись: function myCompareFunction(a:Object, b:Object):int. Обратите внимание, что в отличие от функции compare для свойства ISort.compareFunction() отсутствует третий аргумент. Поиск указанного объекта в пределах определенного массива (или места вставки при запросе); при обнаружении возвращается индекс, в противном случае – -1. Используемые в классе ListCollectionView методы findxxx() применяют этот способ для определения запрашиваемого элемента. Как правило, проще использовать эти функции вместо findItem() для поиска данных в объектах на основе ListCollectionView. Метод findItem() можно вызвать непосредственно при создании класса, например новой реализации ICollectionView, который поддерживает сортировку. Перед вызовом этой функции необходимо выполнить сортировку входного массива элементов. В противном случае эта функция не сможет правильно определить указанное значение. propertyAffectsSort Возвращает значение, показывающее используется ли указанное свойство для управления сортировкой.Может ли значение свойства влиять на результат сортировки. Если при сортировке используется функция compareFunction, установленная по умолчанию, метод возвращает значение true, если параметр property определяет поле сортировки. Если сортировка или любой ISortField использует неизвестное пользовательское устройство сравнения, возвращается значение true. propertyИмя тестируемого поля. Возвращает значение, показывающее используется ли указанное свойство для управления сортировкой. Если сортировка использует пользовательское средство сравнения, то функция не может определить окончательный ответ и всегда возвращает значение true. reverse Проходит через массив fields и вызывает reverse() для каждого объекта ISortField в массиве. Проходит через массив fields и вызывает reverse() для каждого объекта ISortField в массиве. Поле по нисходящей теперь становится полем по восходящей и наоборот.

Примечание. ICollectionView не обновляется автоматически при изменении объектов в массиве fields; для обновления представления следует вызвать метод refresh().

sort Применяет текущую сортировку к указанному массиву (не копии).itemsМассив сортируемых элементов. Применяет текущую сортировку к указанному массиву (не копии). Для предотвращения изменения массива следует создать копию в параметре items.

Реализации ICollectionView в Flex автоматически вызывают метод sort и обеспечивают выполнение сортировки в копии основных данных.

ANY_INDEX_MODE При нахождении возвращает индекс любого соответствующего элемента.any При нахождении возвращает индекс любого соответствующего элемента. FIRST_INDEX_MODE При выполнении поиска возвращает индекс первого совпадающего элемента.first При выполнении поиска возвращает индекс первого совпадающего элемента. LAST_INDEX_MODE При выполнении поиска возвращает индекс последнего совпадающего элемента.last При выполнении поиска возвращает индекс последнего совпадающего элемента. compareFunction Метод, используемый для сравнения элементов при сортировке. Метод, используемый для сравнения элементов при сортировке. При указании этого свойства Flex игнорирует любые свойства compareFunction, которые указаны в объектах ISortField, используемых в этом классе.

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


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

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

  • -1, если в отсортированной последовательности объект А должен предшествовать объекту B.
  • 0, если объект А совпадает с объектом B.
  • 1, если в отсортированной последовательности объект А должен следовать за объектом B.

Для возврата к внутренней функции сравнения установите значение null.

Массив fields указывает поля объекта для сравнения. Как правило, алгоритм сравнивает свойства до тех пор, пока не будет исчерпан список полей или не будет возвращено ненулевое значение. Например:


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

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

Также для каждого поля сортировки можно указать отдельную функцию сравнения с помощью используемого в классе ISortField свойства compareFunction. При этом для одних полей используется сравнение по умолчанию, а для других - пользовательское сравнение.

fields Массив объектов ISortField, указывающий поля для сравнения.null Массив объектов ISortField, указывающих поля для сравнения. Порядок объектов ISortField в массиве определяет приоритетный порядок полей при сортировке. Устройство сравнения сортировки по умолчанию проверяет поля сортировки в порядке массива, пока не определит порядок сортировки для двух сравниваемых полей. SortFieldunique Указывает, должна ли сортировка быть уникальной.false Указывает, должна ли сортировка быть уникальной. Уникальная сортировка завершается ошибкой, если какое-либо значение или объединенное значение, указанные в полях, перечисленных в свойствах полей, приводят к неопределенной или неуникальной последовательности сортировки, т. е. если два и более элемента имеют идентичные значения полей сортировки. Если сортировка не является уникальной, вызывается ошибка. Логика сортировки использует значение свойства unique только в случае, когда поля сортировки указаны явным образом. Если ни одно из полей сортировки не указано явным образом, ошибка не выводится даже при наличии элементов с идентичными значениями. ISortField Интерфейс ISortField определяет интерфейс для классов, которые используются с классами ISort и предоставляет информацию, необходимую для сортировки определенных полей или свойств в представлении коллекции. Интерфейс ISortField определяет интерфейс для классов, которые используются с классами ISort и предоставляет информацию, необходимую для сортировки определенных полей или свойств в представлении коллекции. initializeDefaultCompareFunction Вспомогательная функция, которую вызывает класс Sort, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства.objОбъект , содержащий данные. Если для указания имени поля использовалось свойство Name, то это имя будет использоваться для доступа к значению данных из этого объекта. В противном случае в качестве значения данных будет использован непосредственный объект. Вспомогательная функция, которую вызывает класс Sort, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства. Если свойство numeric имеет значение true, то при сортировке будет выполняться числовое сравнение. reverse Задает обратный порядок критериев для данного поля сортировки. Задает обратный порядок критериев для данного поля сортировки. Например, если поле сортировалось в порядке убывания, оно будет отсортировано в порядке возрастания.

ПРИМЕЧАНИЕ. ICollectionView не обновляется автоматически при изменении ISortFields; для обновления представления следует вызвать метод refresh().

arraySortOnOptions Другое использование этого свойства не поддерживается. Возвращает -1, если ISortField не может использоваться в классе Sort для сортировки поля (отсутствует compareFunction или имя). В противном случае возвращает битовую маску параметров сортировки. compareFunction Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. При указании свойства compareFunction для объекта ISort Flex игнорирует любые свойства compareFunction объектов ISortField в ISort.

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

функция myCompare(a:Object, b:Object):int

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

  • -1, если a должно появиться до b в сортированной последовательности;
  • 0, если a равно b;
  • 1, если a должно появиться после b в сортированной последовательности.
descending Указывает, следует ли сортировать данное поле в порядке убывания. Указывает, следует ли сортировать данное поле в порядке убывания.

Значение по умолчанию равно false (в порядке возрастания).

name Имя поля для сортировки. Имя поля для сортировки. numeric Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.null Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.

Это свойство используется в классе SortField, если не указана пользовательская функция сравнения.

Если для этого свойства установлено значение true, то используется встроенная функция числового сравнения. Перед сравнением каждому элементу данных присваивается функция Number().

Если для этого свойства установлено значение false, то используется встроенная функция сравнения строк. Перед сравнением каждому элементу данных присваивается функция String().

Если это свойство равно null, то анализируется первый элемент данных для определения, является он числом или строкой, после чего сортировка продолжается на основании этого анализа.

usingCustomCompareFunction True, если для ISortField указана пользовательская функция средства сравнения. True, если ISortField использует пользовательскую функцию средства сравнения. ArrayList Класс ArrayList представляет собой простую реализацию IList, которая использует вспомогательный массив в качестве источника данных.mx.collections:IListflash.utils:IExternalizablemx.core:IPropertyChangeNotifierflash.events:EventDispatcher Класс ArrayList представляет собой простую реализацию IList, которая использует вспомогательный массив в качестве источника данных. Использование и обработка элементов вспомогательного массива осуществляется посредством методов и свойств интерфейса IList. Операции с экземпляром ArrayList изменяют источник данных; например, при использовании метода removeItemAt() в ArrayList элемент удаляется из основного массива. Этот базовый класс не генерирует ItemPendingErrors, однако такие ошибки могут генерироваться подклассом. 
  <mx:ArrayList
  Properties
  source="null"
  />
collectionChange Передается при некоторых обновлениях IList.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Передается при некоторых обновлениях IList. ArrayList Создание нового ArrayList с помощью указанного массива в качестве источника.sourcenullМассив, используемый в качестве источника для ArrayList. Создание нового ArrayList с помощью указанного массива в качестве источника. Если источник не указан, используется пустой массив. addAllAt addListmx.collections:IListСписок элементов, добавляемых к текущему списку indexМестоположение текущего списка для размещения новых элементов. addAll addListmx.collections:IListСписок элементов, добавляемых к текущему списку addItemAt Добавление элемента в заданную позицию индекса.если индекс меньше 0 или больше длины RangeErrorRangeErroritemЭлемент, помещаемый в позицию индекса indexПозиция индекса, в которую помещается элемент Добавление элемента в заданную позицию индекса. Любой элемент, прежде находившийся после данного индекса, перемещается на одну позицию. addItem Добавление указанного элемента в конец списка.itemДобавляемый элемент Добавление указанного элемента в конец списка. Эквивалентен addItemAt(item, length); getItemAt Получение элемента, расположенного в заданной позиции индекса.если данные для этого индекса следует загрузить из удаленного местоположения ItemPendingErrorItemPendingErrorесли index < 0 или index > = length RangeErrorRangeErrorЭлемент в этой позиции индекса или значение null, если элемент отсутствует indexИндекс в списке, из которого извлекается элемент prefetch0Значение int, указывающее как направление, так и число элементов, получаемых во время запроса, если элемент не является локальным. Получение элемента, расположенного в заданной позиции индекса. getItemIndex Возвращает индекс элемента, если он находится в списке, например getItemAt(index) == элемент.Индекс элемента или -1, если элемент отсутствует в списке. itemИскомый элемент Возвращает индекс элемента, если он находится в списке, например getItemAt(index) == элемент. Следует отметить, что в этой реализации поиск линеен, и поэтому – O(n). itemUpdateHandler Вызывается при каждой отправке события ObjectChange любым из элементов в списке.eventmx.events:PropertyChangeEventОбъект для события ObjectChange. Вызывается при каждой отправке события ObjectChange любым из элементов в списке. Заключает его в объект CollectionEventKind.UPDATE. itemUpdated Уведомить представление об обновлении элемента.itemЭлемент представления, который был обновлен. propertynullЗначения String, QName или int, определяющие обновленное свойство. oldValuenullСтарое значение данного свойства. (Если свойство имело значение null, это могло быть старое значение элемента.) newValuenullНовое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.) Уведомить представление об обновлении элемента. Это особенно важно, если содержимое представления не реализует IEventDispatcher. Если свойство указано, представление может оптимизировать свой механизм уведомления. В противном случае оно может выполнить простое обновление всего представления. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventremoveAll Удаляет все элементы из списка. Удаляет все элементы из списка. removeItemAt Удаление элемента в указанной позиции индекса и его возврат.если index < 0 или index > = length. RangeErrorRangeErrorУдаленный элемент. indexИндекс, из которого необходимо удалить элемент. Удаление элемента в указанной позиции индекса и его возврат. Любые элементы, прежде находившиеся после данного индекса, теперь соответствуют предыдущему индексу. removeItem Удаляет указанный элемент из этого списка (при его наличии).Логическое значение, указывающее на удаление элемента. itemСсылка на объект для элемента, подлежащего удалению. Удаляет указанный элемент из этого списка (при его наличии). setItemAt Помещает элемент в заданную позицию индекса.если индекс меньше 0 либо больше или равен длине RangeErrorRangeErrorЗамененный элемент или null при отсутствии элемента itemНовое значение индекса indexПозиция индекса, в которую помещается элемент Помещает элемент в заданную позицию индекса. Если элемент уже занимает данную позицию индекса, новый элемент заменит его и будет возвращен. startTrackUpdates Если элемент - IEventDispatcher, следите за его обновлениями.itemЭлемент, переданный в метод addItemAt(). Если элемент - IEventDispatcher, следите за его обновлениями. Этот метод вызывается методом addItemAt() и при первоначальном назначении источника. stopTrackUpdates Если элемент – IEventDispatcher, следить за его обновлением не требуется.itemЭлемент, переданный в метод removeItemAt(). Если элемент – IEventDispatcher, следить за его обновлением не требуется. Этот метод вызывается removeItemAt() и removeAll() и перед назначением нового источника. toArray Возвращает массив, заполняемый в порядке, аналогичном реализации IList.Если данные еще не загружены полностью из удаленного местоположения ItemPendingErrorItemPendingErrorМассив, заполняемый в порядке, аналогичном реализации IList. Возвращает массив, заполняемый в порядке, аналогичном реализации IList. toString Pretty вводит содержимое этого ArrayList в строку и возвращает ее.Строка с содержимым ArrayList. Pretty вводит содержимое этого ArrayList в строку и возвращает ее. length Возвращает количество элементов в списке. Возвращает количество элементов в списке. ArrayList должен содержать информацию о его длине, таким образом, не должно возвращаться значение -1, однако такое поведение может быть переопределено подклассом. source Исходный массив для этого ArrayList. Исходный массив для этого ArrayList. Любые изменения, внесенные посредством интерфейса IList, будут отражены в исходном массиве. Если исходный массив не предоставлен, ArrayList создает этот массив на внутреннем уровне. Изменения, внесенные непосредственно в основной массив (например, вызов метода theList.source.pop()), не повлекут за собой диспетчеризацию CollectionEvents. uid Предоставляет доступ к уникальному идентификатору для этого списка. Предоставляет доступ к уникальному идентификатору для этого списка. SortField Обеспечивает информацию о сортировке, необходимую для выполнения сортировки по полю или свойству в представлении коллекции. The <mx:SortField> tag has the following attributes:

  <mx:SortField
  Properties
  caseInsensitive="false"
  compareFunction="Internal compare function"
  descending="false"
  name="null"
  numeric="null"
  />
]]>mx.collections:ISortFieldflash.events:EventDispatcher Обеспечивает информацию о сортировке, необходимую для выполнения сортировки по полю или свойству в представлении коллекции. Класс SortField предназначен для использования с классом Sort. Обычно сортировка определяется для коллекций сложных элементов, т. е. для элементов, в которых она выполняется по свойствам этих объектов. Например: 

     var col:ICollectionView = new ArrayCollection();
     col.addItem({first:"Anders", last:"Dickerson"});
     var sort:Sort = new Sort();
     sort.fields = [new SortField("first", true)];
     col.sort = sort;
Возможны ситуации, в которых коллекция содержит простые элементы, подобные String, Date, Boolean и т. д. В этом случае сортировка должна применяться непосредственно к простому типу. При построении сортировки в этой ситуации необходимо наличие отдельного поля сортировки, не имеющего указанного name. Например: 

     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     sort.fields = [new SortField(null, true)];
     col.sort = sort;

По умолчанию сравнение, выполняемое с помощью класса SortField, не обеспечивает правильную языковую сортировку для строк. Для получения информации об этом типе сортировки см. описание классов spark.collections.Sort и spark.collections.SortField.

mx.collections.ICollectionViewmx.collections.Sortspark.collections.Sortspark.collections.SortFieldSortField Конструктор.namenullИмя свойства, используемое этим полем для сравнения. Если объект относится к простому типу, следует передать null. caseInsensitivefalseПри сортировке строк сообщает средству сравнения, следует ли игнорировать регистр значений. descendingfalseСообщает устройству сравнения, следует ли разместить элементы в порядке убывания. numericnullСообщает средству сравнения, следует ли сравнивать элементы сортировки как числовом порядке вместо алфавитного порядка. Конструктор. initializeDefaultCompareFunction Вспомогательная функция, которую вызывает класс Sort, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства.objОбъект , содержащий данные. Если для указания имени поля использовалось свойство Name, то это имя будет использоваться для доступа к значению данных из этого объекта. В противном случае в качестве значения данных будет использован непосредственный объект. Вспомогательная функция, которую вызывает класс Sort, чтобы установить функцию сравнения по умолчанию для сравнений на основе одного из трех условий, определяющих была ли установлена пользовательская функция, тип данных для определенного поля или значение числового свойства. Если свойство numeric имеет значение true, то при сортировке будет выполняться числовое сравнение. reverse Задает обратный порядок критериев для данного поля сортировки. Задает обратный порядок критериев для данного поля сортировки. Например, если поле сортировалось в порядке убывания, оно будет отсортировано в порядке возрастания.

ПРИМЕЧАНИЕ. ICollectionView не обновляется автоматически при изменении ISortFields; для обновления представления следует вызвать метод refresh().

arraySortOnOptions Другое использование этого свойства не поддерживается. Возвращает -1, если ISortField не может использоваться в классе Sort для сортировки поля (отсутствует compareFunction или имя). В противном случае возвращает битовую маску параметров сортировки. caseInsensitive Указывает, должна ли сортировка для данного поля зависеть от регистра.false Указывает, должна ли сортировка для данного поля зависеть от регистра. compareFunction Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. Функция, сравнивающая два элемента при сортировке элементов для связанной коллекции. При указании свойства compareFunction для объекта ISort Flex игнорирует любые свойства compareFunction объектов SortField в ISort.

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

функция myCompare(a:Object, b:Object):int

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

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

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

Если требуется выполнить языковую сортировку, используйте класс spark.collections.SortField. spark.collections.SortFielddescending Указывает, следует ли сортировать данное поле в порядке убывания. Указывает, следует ли сортировать данное поле в порядке убывания.

Значение по умолчанию равно false (в порядке возрастания).

name Имя поля для сортировки.null Имя поля для сортировки. numeric Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.null Указывает, что если сортируемое поле содержит числовые значения (number/int/uint) или строковые представления числовых значений, то средство сравнения использует числовое сравнение.

Это свойство используется в классе SortField, если не указана пользовательская функция сравнения.

Если для этого свойства установлено значение true, то используется встроенная функция числового сравнения. Перед сравнением каждому элементу данных присваивается функция Number().

Если для этого свойства установлено значение false, то используется встроенная функция сравнения строк. Перед сравнением каждому элементу данных присваивается функция String().

Если это свойство равно null, то анализируется первый элемент данных для определения, является он числом или строкой, после чего сортировка продолжается на основании этого анализа.

usingCustomCompareFunction True, если для ISortField указана пользовательская функция средства сравнения. True, если ISortField использует пользовательскую функцию средства сравнения. AsyncListView Класс AsyncListView является реализацией интерфейса IList, который обрабатывает ошибки ItemPendingErrors, выведенные методами getItemAt(), removeItemAt() и toArray().The <mx:AsyncListView> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:AsyncListView
  Properties
    createFailedItemFunction="null"
    createPendingItemFunction="null"
    list="null"
  />
]]>mx.collections:IListmx.utils:OnDemandEventDispatcher Класс AsyncListView является реализацией интерфейса IList, который обрабатывает ошибки ItemPendingErrors, выведенные методами getItemAt(), removeItemAt() и toArray().

Метод getItemAt() обрабатывает ItemPendingErrors при возврате временного ожидающего выполнения элемента до успешного или неудачного выполнения основного запроса. Временный элемент создается путем вызова функции, указанной свойством createPendingItemFunction. Если запрос успешно выполнен, то фактический элемент заменяет временный. При неудачном выполнении временный элемент заменяется элементом, возвращенным при вызове функции, указанной свойством createFailedItemFunction.

Этот класс делегирует методы и свойства IList для list. Если список не указан, методы, видоизменяющие коллекцию, являются пустыми командами, а методы, запрашивающие коллекцию, возвращают пустое значение, например null или нуль соответственно.

Этот класс предназначен для использования с компонентами Spark, основанными на DataGroup, например List и ComboBox Классы Spark не предоставляют встроенную поддержку для обработки ItemPendingError.

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

collectionChange Отправляется при изменении длины списка или замене элемента списка.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Отправляется при изменении длины списка или замене элемента списка. AsyncListView Конструктор.listmx.collections:IListnullНачальное значение свойства списка, делегирование IList. Конструктор. addItemAt Добавляет элемент в заданный индекс.itemЭлемент, помещаемый в индекс. indexИндекс, в который помещается элемент. Добавляет элемент в заданный индекс. Индекс любого элемента больше индекса добавляемого элемента, увеличенного на единицу. Если указанный индекс меньше нуля или больше длины списка, инициируется ошибка RangeError. addItem Добавляет указанный элемент в конец списка.itemДобавляемый элемент. Добавляет указанный элемент в конец списка. Эквивалентен addItemAt(item, length). getItemAt Возвращает значение list.getItemAt(index).если index < 0 или index > = length. RangeErrorRangeErrorЭлемент списка с заданным индексом. indexИндекс списка, из которого необходимо извлечь элемент. prefetch0Значение int, указывает как направление, так и число элементов, получаемых во время запроса, если элемент не является локальным. Возвращает значение list.getItemAt(index).

Этот метод перехватывает ItemPendingErrors (IPE), созданные в результате вызова getItemAt(). Если IPE создается, IResponder добавляется к IPE, и возвращается временный элемент очереди, созданный функций createPendingItemFunction. Если основной запрос успешно выполнен, элемент очереди заменяется фактическим элементом. Если запрос не удалось выполнить, элемент очереди заменяется значением, созданным при вызове createFailedItemFunction.

createPendingItemFunctioncreateFailedItemFunctionmx.collections.errors.ItemPendingErrormx.rpc.IRespondergetItemIndex Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.Индекс элемента или -1, если элемент отсутствует в списке. itemИскомый элемент. Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.

Примечание. В отличие от методов IViewCursor.findxxx() метод getItemIndex() не может содержать параметр, состоящий исключительно из подмножества полей искомого элемента. Данный метод всегда выполняет поиск элемента, точно соответствующего входным параметрам.

itemUpdated Уведомляет представление об обновлении элемента.itemЭлемент представления, который был обновлен. propertynullИмя обновленного свойства. oldValuenullСтарое значение данного свойства. (Если свойство имело значение null, это могло быть старое значение элемента.) newValuenullНовое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.) Уведомляет представление об обновлении элемента. Рекомендуется использовать, если содержимое представления не реализует IEventDispatcher и передает PropertyChangeEvent. Если свойство указано, представление может оптимизировать свой механизм уведомления. В противном случае оно может выполнить простое обновление всего представления. removeAll Удаляет все элементы из списка. Удаляет все элементы из списка.

Если какой-нибудь элемент не является локальным и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.

Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError, а также документацию по коллекциям.

removeItemAt Удаляет действительный или ожидающий обработки элемент в указанном индексе и возвращает его.если index < 0 или index > = length. RangeErrorRangeErrorЭлемент, который был удален или имеет значение null. indexИндекс списка, из которого необходимо извлечь элемент. Удаляет действительный или ожидаемый элемент в указанном индексе и возвращает его. Индекс всех элементов с индексом, превышающим указанный индекс, уменьшается на 1.

Если в указанном индексе отсутствует фактический или ожидающий обработки элемент, например по причине того, что вызов getItemAt(index) не привел к разбивке данных на страницы, то базовый list может создать ItemPendingError. Данная реализация игнорирует ItemPendingError и возвращает null.

setItemAt Помещает элемент в заданную позицию индекса.Замененный элемент или null в случае отсутствия элемента. itemНовый элемент, для размещения в указанной позиции индекса. indexИндекс, в который помещается элемент. Помещает элемент в заданную позицию индекса. Если элемент уже занимает данную позицию индекса, новый элемент заменит его и будет возвращен. toArray Возвращает массив с теми же элементами, что и в этом AsyncListView.массив с теми же элементами, что и в этом AsyncListView. Возвращает массив с теми же элементами, что и в этом AsyncListView. Инициализация массива выполняется путем восстановления каждого элемента с getItemAt(), поэтому ожидающие обработки элементы заменяются в тех случаях, когда фактические значения еще не доступны. Массив не будет обновляться, когда AsyncListView заменяет ожидающие обработки элементы фактическими (или неудачно выполненными) значениями. toString Возвращает строку, которая содержит длину списка и количество ожидающих запросов элемента.Краткое описание списка. Возвращает строку, которая содержит длину списка и количество ожидающих запросов элемента. Запросы, ожидающие обработки, не инициируются. createFailedItemFunction Функция обратного вызова, используемая для создания элемента замены, если запрос, вызвавший ошибку ItemPendingError, впоследствии неудачно выполнен.A function that unconditionally returns null. Функция обратного вызова, используемая для создания элемента замены, если запрос, вызвавший ошибку ItemPendingError, впоследствии неудачно выполнен. Существующий элемент, обычно являющийся ожидающим обработки элементом, созданным функцией обратного вызова, указанной свойством createPendingItemFunction(), замещается неудачно выполненным элементом.

Значением этого свойства должна быть функция с двумя параметрами: индексом запрошенного элемента и информационным объектом сбоя, который передан из метода IResponder fault(). В большинстве случаев второй параметр может быть проигнорирован. Ниже приведен пример реализации функции обратного вызова:

     function createFailedItem(index:int, info:Object):Object
     {
         return "[" + index + "request failed]";        
     }

Установка этого свойства не влияет на неудавшиеся элементы, которые уже были созданы. Установка этого свойства на значение null препятствует созданию неудавшихся элементов.

getItemAt()createPendingItemFunctionmx.rpc.IResponder.faultcreatePendingItemFunction Функция обратного вызова, используемая для создания временного элемента, когда начальный запрос вызывает ошибку ItemPendingError.A function that unconditionally returns null. Функция обратного вызова, используемая для создания временного элемента, когда начальный запрос вызывает ошибку ItemPendingError. Если запрос успешно выполнен, временный элемент автоматически заменяется фактическим элементом. При неудачном выполнении запроса этот элемент заменяется элементом, созданным с помощью функции обратного вызова, указанной свойством createFailedItemFunction.

Значением этого свойства должна быть функция с двумя параметрами: индексом запрошенного элемента поставщика данных и ItemPendingError. В большинстве случаев второй параметр можно проигнорировать. Ниже приведен пример реализации функции обратного вызова: 

     function createPendingItem(index:int, ipe:ItemPendingError):Object
     {
         return "[" + index + "request is pending...]";        
     }

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

getItemAt()createFailedItemFunctionmx.collections.errors.ItemPendingErrorlength Число элементов в данной коллекции. Число элементов в данной коллекции. 0 означает отсутствие элементов, а -1 – неизвестную длину. list Объект IList, вставляющий строки в данную коллекцию.mx.collections:IListnull Объект IList, вставляющий строки в данную коллекцию. Это означает объект, которому передаются все методы IList.

Если это свойство имеет значение null, методы видоизменения IList, например setItemAt(), являются пустыми командами. Методы запроса IList, например getItemAt(), возвращают null или нуль (-1 для getItemIndex()) соответственно.

ArrayCollection Класс ArrayCollection является классом-оболочкой, представляющим массив как коллекцию, которую можно использовать и которой можно управлять с помощью методов и свойств интерфейсов ICollectionView или IList.The <mx:ArrayCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:ArrayCollection
  Properties
  source="null"
  />
]]>flash.utils:IExternalizablemx.collections:ListCollectionView Класс ArrayCollection является классом-оболочкой, представляющим массив как коллекцию, которую можно использовать и которой можно управлять с помощью методов и свойств интерфейсов ICollectionView или IList. Операции с экземпляром ArrayCollection изменяют источник данных; например, при использовании метода removeItemAt() в ArrayCollection элемент удаляется из основного массива. Следующий код создает простой объект ArrayCollection для доступа к массиву и его обработки с отдельным элементом объекта. Он извлекает элемент (посредством метода getItemAt интерфейса IList) и объект IViewCursor (полученный с помощью метода createCursor ICollectionView). 
  var myCollection:ArrayCollection = new ArrayCollection([ { first: 'Matt', last: 'Matthews' } ]);
  var myCursor:IViewCursor = myCollection.createCursor();
  var firstItem:Object = myCollection.getItemAt(0);
  var firstItemFromCursor:Object = myCursor.current;
  if (firstItem == firstItemFromCursor)
        doCelebration();
ArrayCollection Конструктор.sourcenullИсходный массив. Конструктор.

Создает новый ArrayCollection с помощью указанного исходного массива. Если массив не указан, то используется пустой массив.

source Источник данных в ArrayCollection. Источник данных в ArrayCollection. Объект ArrayCollection не представляет изменений, выполненных непосредственно в исходном массиве. Для изменения коллекции всегда следует использовать методы ICollectionView или IList. ISort Интерфейс ISort определяет интерфейс для классов, которые предоставляют информацию сортировки, необходимую для сортировки данных представления коллекции. Интерфейс ISort определяет интерфейс для классов, которые предоставляют информацию сортировки, необходимую для сортировки данных представления коллекции. mx.collections.ICollectionViewmx.collections.ISortFieldfindItem Поиск указанного объекта в пределах указанного массива (или места вставки при запросе); при обнаружении возвращается индекс, в противном случае – -1.Если в параметрах возникают ошибки, критерии поиска несовместимы с указанной сортировкой или невозможно определить функцию средства сравнения. SortErrorSortErrorint Индекс в массиве найденного элемента. Если параметр returnInsertionIndex равен false и элемент не найден, возвращает -1. Если параметр returnInsertionIndex равен true и элемент не найден, возвращает индекс точки в сортированном массиве, где следует вставить значения. itemsМассив, в пределах которого выполняется поиск. valuesОбъект, содержащий свойства для поиска (или сам объект для поиска). Объект должен состоять из пар «имя/значение поля», в которых имена полей определяются свойством fields в порядке их использования в этом свойстве. Необязательно перечислять все поля свойства fields, однако поле не может быть пропущено в последовательности. Поэтому если в свойстве fields перечисляются три поля, то можно указать только первое и второе поля, но нельзя указать первое и третье, пропустив второе. modeСтрока, содержащая тип нахождения для выполнения. Допустимые значения: ANY_INDEX_MODEВозвращает любую позицию, которая является допустимой для этих значений. FIRST_INDEX_MODE Возвращает позицию, где найдено первое вхождение значений. LAST_INDEX_MODE Возвращает позицию, где произошло последнее вхождение указанных значений. returnInsertionIndexfalseЕсли метод не находит элемент, идентифицируемый параметром values, и этот параметр равен true, метод findItem() возвращает место вставки для значений, которое в сортированной последовательности является точкой вставки элемента. compareFunctionnullфункция устройства сравнения для использования при нахождении элемента. Если этот параметр не определен или указано значение null, функция findItem() использует функцию compare, определенную ISort в свойстве compareFunction экземпляра, с передачей данных в массив полей, которые определены объектом значений и текущим SortFields. Если указано ненулевое значение, функция findItem() использует его как функцию compare. Для функции, передаваемой как compareFunction, необходимо указать следующую подпись: function myCompareFunction(a:Object, b:Object):int. Обратите внимание, что в отличие от функции compare для свойства ISort.compareFunction() отсутствует третий аргумент. Поиск указанного объекта в пределах определенного массива (или места вставки при запросе); при обнаружении возвращается индекс, в противном случае – -1. Используемые в классе ListCollectionView методы findxxx() применяют этот способ для определения запрашиваемого элемента. Как правило, проще использовать эти функции вместо findItem() для поиска данных в объектах на основе ListCollectionView. Метод findItem() можно вызвать непосредственно при создании класса, например новой реализации ICollectionView, который поддерживает сортировку. Перед вызовом этой функции необходимо выполнить сортировку входного массива элементов. В противном случае эта функция не сможет правильно определить указанное значение. propertyAffectsSort Возвращает значение, показывающее используется ли указанное свойство для управления сортировкой.Может ли значение свойства влиять на результат сортировки. Если при сортировке используется функция compareFunction, установленная по умолчанию, метод возвращает значение true, если параметр property определяет поле сортировки. Если сортировка или любой ISortField использует неизвестное пользовательское устройство сравнения, возвращается значение true. propertyИмя тестируемого поля. Возвращает значение, показывающее используется ли указанное свойство для управления сортировкой. Если сортировка использует пользовательское средство сравнения, то функция не может определить окончательный ответ и всегда возвращает значение true. reverse Проходит через массив fields и вызывает reverse() для каждого объекта ISortField в массиве. Проходит через массив fields и вызывает reverse() для каждого объекта ISortField в массиве. Поле по нисходящей теперь становится полем по восходящей и наоборот.

Примечание. ICollectionView не обновляется автоматически при изменении объектов в массиве fields; для обновления представления следует вызвать метод refresh().

sort Применяет текущую сортировку к указанному массиву (не копии).itemsМассив сортируемых элементов. Применяет текущую сортировку к указанному массиву (не копии). Для предотвращения изменения массива следует создать копию в параметре items.

Реализации ICollectionView в Flex автоматически вызывают метод sort и обеспечивают выполнение сортировки в копии основных данных.

compareFunction Метод, используемый для сравнения элементов при сортировке. Метод, используемый для сравнения элементов при сортировке. При указании этого свойства Flex игнорирует любые свойства compareFunction, которые указаны в объектах ISortField, используемых в этом классе.

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


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

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

  • -1, если в отсортированной последовательности объект А должен предшествовать объекту B.
  • 0, если объект А совпадает с объектом B.
  • 1, если в отсортированной последовательности объект А должен следовать за объектом B.

Для возврата к внутренней функции сравнения установите значение null.

Массив fields указывает поля объекта для сравнения. Как правило, алгоритм сравнивает свойства до тех пор, пока не будет исчерпан список полей или не будет возвращено ненулевое значение. Например:


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

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

Также для каждого поля сортировки можно указать отдельную функцию сравнения с помощью используемого в классе ISortField свойства compareFunction. При этом для одних полей используется сравнение по умолчанию, а для других - пользовательское сравнение.

fields Массив объектов ISortField, указывающий поля для сравнения.null Массив объектов ISortField, указывающих поля для сравнения. Порядок объектов ISortField в массиве определяет приоритетный порядок полей при сортировке. Устройство сравнения сортировки по умолчанию проверяет поля сортировки в порядке массива, пока не определит порядок сортировки для двух сравниваемых полей. ISortFieldunique Указывает, должна ли сортировка быть уникальной.false Указывает, должна ли сортировка быть уникальной. Уникальная сортировка завершается ошибкой, если какое-либо значение или объединенное значение, указанные в полях, перечисленных в свойствах полей, приводят к неопределенной или неуникальной последовательности сортировки, т. е. если два и более элемента имеют идентичные значения полей сортировки. Если сортировка не является уникальной, вызывается ошибка. Логика сортировки использует значение свойства unique только в случае, когда поля сортировки указаны явным образом. Если ни одно из полей сортировки не указано явным образом, ошибка не выводится даже при наличии элементов с идентичными значениями. XMLListCollection Класс XMLListCollection обеспечивает применение функциональных возможностей коллекции к объекту XMLList и делает доступными некоторые методы класса XMLList.The <mx:XMLListCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:XMLListCollection
  Properties
  source="null"
  />
]]>mx.collections:ListCollectionView Класс XMLListCollection обеспечивает применение функциональных возможностей коллекции к объекту XMLList и делает доступными некоторые методы класса XMLList. XMLListXMLXMLListCollection Конструктор.sourcenullОбъект XMLList, содержащий данные, представленные объектом XMLListCollection. Конструктор.

Создает новый объект XMLListCollection с помощью указанного объекта XMLList.

attribute Вызывает метод attribute() каждого XML-объекта в XMLList и возвращает XMLList результатов, которые соответствуют данному attributeName.XMLList соответствия XML-объектам. attributeNameАтрибут соответствия XML-объектов из XMLList. Вызывает метод attribute() каждого XML-объекта в XMLList и возвращает XMLList результатов, которые соответствуют данному attributeName. XML.attribute()attributes Вызывает метод attributes() каждого XML-объекта в объекте XMLList и возвращает XMList атрибутов для каждого XML-объекта.XMLList, содержащий результирующие XML-объекты, которые перечисляют атрибуты. Вызывает метод attributes() каждого XML-объекта в объекте XMLList и возвращает XMList атрибутов для каждого XML-объекта. XML.attributes()child Вызывает метод child() каждого XML-объекта в XMLList и возвращает XMLList, содержащий нижестоящие записи с указанным именем свойства в порядке появления.XMLList соответствующих нижестоящих элементов XML-объектов в исходном XMLList. propertyNameИскомое свойство. Вызывает метод child() каждого XML-объекта в XMLList и возвращает XMLList, содержащий нижестоящие записи с указанным именем свойства в порядке появления. XML.child()children Вызывает метод children() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты.XMLList нижестоящих элементов XML-объектов в исходном XMLList. Вызывает метод children() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты. XML.children()copy Возвращает полную копию объекта XMLList.Копия объекта XMLList. Возвращает полную копию объекта XMLList. descendants Вызывает метод descendants() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты.XMLList соответствующих нижестоящих элементов (нижестоящие записи первого уровня, второго уровня и т. д.) XML-объектов в исходном XMLList. name*Имена искомых элементов. Вызывает метод descendants() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты. Параметр name передается в метод descendants() XML-объекта. Если этот параметр не указан, в метод descendants() передается строка «~~». XML.descendants()elements Вызывает метод elements() каждого XML-объекта в XMLList.XMLList соответствующих нижестоящих элементов XML-объектов в исходном XMLList. name*Имена искомых элементов. Вызывает метод elements() каждого XML-объекта в XMLList. Параметр name передается в метод elements() XML-объекта. Если этот параметр не указан, в метод elements() передается строка «~~». XML.elements()text Вызывает метод text() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты.XMLList, содержащий результат. Вызывает метод text() каждого XML-объекта в XMLList и возвращает XMLList, содержащий результаты. XML.text()toString Возвращает строковое представление XMLList, вызывая метод toString() для каждого XML-объекта в XMLList.Строковое представление объекта XMLList. Возвращает строковое представление XMLList, вызывая метод toString() для каждого XML-объекта в XMLList. Если свойство prettyPrinting класса XML установлено равным true, то результаты для каждого XML-объекта разделяются в XMLList символами возврата каретки. В противном случае, если значение prettyPrinting равно false, то результаты соединяются без вставки символов возврата каретки.

Метод toString() помещает в возвращаемую строку для XML-объекта с простым содержимым следующую информацию: открывающий тег, атрибуты, объявления пространства имен и закрывающий тег. Можно использовать метод toXMLString(), если необходимо сохранить данную информацию в возвращаемой строке для XML-объектов с простым содержимым.

XML.prettyPrintingtoXMLString Возвращает строковое представление XMLList, вызывая метод toXMLString() для каждого XML-объекта в XMLList.Строковое представление XMLList. Возвращает строковое представление XMLList, вызывая метод toXMLString() для каждого XML-объекта в XMLList. Если свойство prettyPrinting класса XML установлено равным true, то результаты для каждого XML-объекта разделяются в XMLList символами возврата каретки. Если значение prettyPrinting равно false, то результаты соединяются без символов возврата каретки.

Метод toXMLString() содержит в возвращаемой строке для объекта XML с простым содержимым следующую информацию: открывающий тег, атрибуты, объявления пространства имен и закрывающий тег. Метод toString() следует использовать при необходимости определения данной информации из возвращаемой строки для XML-объектов с простым содержимым.

XML.prettyPrintingsource Основной XMLList для данной коллекции. Основной XMLList для данной коллекции. Объект XMLListCollection не отображает изменений, выполненных непосредственно с исходным объектом XMLList. Для изменения коллекции следует всегда использовать методы XMLListCollection. IList Коллекция элементов, организованных по порядку.flash.events:IEventDispatcher Коллекция элементов, организованных по порядку. Предоставляет методы получения и обработки, основанные на индексе.

IList может быть представлением данных, которые были извлечены из удаленного местоположения. При записи в коллекцию, которая может быть удаленной, важно предусмотреть возможность недоступности данных, в результате чего инициируется ошибка ItemPendingError.

ICollectionView является альтернативой IList.

mx.collections.errors.ItemPendingErrormx.collections.ICollectionViewmx.collections.ListCollectionViewcollectionChange Передается при некоторых обновлениях IList.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Передается при некоторых обновлениях IList. addItemAt Добавляет элемент в заданный индекс.если индекс меньше 0 или больше длины списка. RangeErrorRangeErroritemЭлемент, помещаемый в индекс. indexИндекс, в который помещается элемент. Добавляет элемент в заданный индекс. Индекс любого элемента больше индекса добавляемого элемента, увеличенного на единицу. Если указанный индекс меньше нуля или больше длины списка, инициируется ошибка RangeError. addItem Добавляет указанный элемент в конец списка.itemДобавляемый элемент. Добавляет указанный элемент в конец списка. Эквивалентен addItemAt(item, length). getItemAt Получает элемент, расположенный по заданному индексу.если данные для этого индекса следует загрузить из удаленного местоположения. ItemPendingErrormx.collections.errors:ItemPendingErrorесли index < 0 или index > = length. RangeErrorRangeErrorЭлемент в этой позиции индекса или значение null, если элемент отсутствует. indexИндекс в списке для извлечения элемента. prefetch0Значение int, указывает как направление, так и число элементов, получаемых во время запроса, если элемент не является локальным. Получает элемент, расположенный по заданному индексу. getItemIndex Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.Индекс элемента или -1, если элемент отсутствует в списке. itemИскомый элемент. Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.

Примечание. В отличие от методов IViewCursor.findxxx() метод getItemIndex() не может содержать параметр, состоящий исключительно из подмножества полей искомого элемента. Данный метод всегда выполняет поиск элемента, точно соответствующего входным параметрам.

itemUpdated Уведомляет представление об обновлении элемента.itemЭлемент представления, который был обновлен. propertynullИмя обновленного свойства. oldValuenullСтарое значение данного свойства. (Если свойство имело значение null, это могло быть старое значение элемента.) newValuenullНовое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.) Уведомляет представление об обновлении элемента. Рекомендуется использовать, если содержимое представления не реализует IEventDispatcher и передает PropertyChangeEvent. Если свойство указано, представление может оптимизировать свой механизм уведомления. В противном случае оно может выполнить простое обновление всего представления. mx.events.CollectionEventmx.events.PropertyChangeEventremoveAll Удаляет все элементы из списка. Удаляет все элементы из списка.

Если какой-нибудь элемент не является локальным и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.

Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError, а также документацию по коллекциям.

removeItemAt Удаляет элемент в указанной позиции индекса и возвращает его.индекс меньше 0 или больше длины. RangeErrorRangeErrorУдаленный элемент. indexИндекс, из которого необходимо удалить элемент. Удаляет элемент в указанной позиции индекса и возвращает его. Любые элементы, прежде находившиеся после данного индекса, теперь соответствуют предыдущему индексу. setItemAt Помещает элемент в заданную позицию индекса.если индекс меньше 0 или больше длины. RangeErrorRangeErrorЗамененный элемент или null в случае отсутствия элемента. itemНовый элемент, для размещения в указанной позиции индекса. indexИндекс, в который помещается элемент. Помещает элемент в заданную позицию индекса. Если элемент уже занимает данную позицию индекса, новый элемент заменит его и будет возвращен. toArray Возвращает массив, заполняемый в порядке, аналогичном реализации IList.Если данные не загружены полностью из удаленного местоположения. ItemPendingErrormx.collections.errors:ItemPendingErrorМассив. Возвращает массив, заполняемый в порядке, аналогичном реализации IList. Этот метод может инициировать ошибку ItemPendingError. length Число элементов в данной коллекции. Число элементов в данной коллекции. 0 означает отсутствие элементов, а -1 – неизвестную длину. ListCollectionView Класс ListCollectionView добавляет свойства и методы интерфейса ICollectionView к объекту, который соответствует интерфейсу IList.The <mx:ListCollectionView> has the following attributes, which all of its subclasses inherit:

  <mx:ListCollectionView
  Properties
  filterFunction="null"
  list="null"
  sort="null"
  Events
  collectionChange="No default"
  />
]]>mx.collections:ICollectionViewmx.collections:IListmx.core:IMXMLObjectflash.utils:Proxy Класс ListCollectionView добавляет свойства и методы интерфейса ICollectionView к объекту, который соответствует интерфейсу IList. В итоге можно использовать объект этого класса в ситуациях, предусматривающих IList или ICollectionView.

Этот класс также позволяет использовать нотацию массива [] для доступа к методам getItemAt() и setItemAt(). При использовании кода, например myListCollectionView[index], Flex вызывает метод getItemAt() или setItemAt() объекта myListCollectionView.

collectionChange Передается при обновлении ICollectionView.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Передается при обновлении ICollectionView. ListCollectionView Конструктор ListCollectionView.listmx.collections:IListnullIList этого ListCollectionView предназначен для переноса. Конструктор ListCollectionView. addAllAt Добавляет список элементов к текущему списку, помещая их в позиции индекса, передаваемого в функцию.если индекс меньше 0 или больше длины списка. RangeErrorRangeErroraddListmx.collections:IListСписок элементов, добавляемых к текущему списку indexМестоположение текущего списка для размещения новых элементов. Добавляет список элементов к текущему списку, помещая их в позиции индекса, передаваемого в функцию. Элементы помещаются в позиции индекса в порядке их получения. addAll Добавляет список элементов к текущему списку, помещая их в конце списка в порядке передачи.addListmx.collections:IListСписок элементов, добавляемых к текущему списку Добавляет список элементов к текущему списку, помещая их в конце списка в порядке передачи. addEventListener typelisteneruseCapturefalsepriority0useWeakReferencefalse addItemAt Добавляет элемент в заданный индекс.itemЭлемент, помещаемый в индекс. indexИндекс, в который помещается элемент. Добавляет элемент в заданный индекс. Индекс любого элемента больше индекса добавляемого элемента, увеличенного на единицу. Если указанный индекс меньше нуля или больше длины списка, инициируется ошибка RangeError. addItem Добавляет указанный элемент в конец списка.itemДобавляемый элемент. Добавляет указанный элемент в конец списка. Эквивалентен addItemAt(item, length). contains Возвращает значение, определяющее, содержит ли данное представление указанный объект.Значение равно true, если ICollectionView содержит элемент после применения любого фильтра; в противном случае значение равно false. itemИскомый объект. Возвращает значение, определяющее, содержит ли данное представление указанный объект. В отличие от методов IViewCursor.findxxx, этот поиск будет успешным только при нахождении элемента, точно соответствующего данному параметру. При наличии фильтра, применяемого к представлению, данный метод может вернуть false даже в случае, если элемент действительно содержится в основной коллекции. enableAutoUpdate()mx.events.CollectionEventcreateCursor Создает новый IViewCursor, работающий с данным представлением.Новая реализация IViewCursor. mx.collections:IViewCursor Создает новый IViewCursor, работающий с данным представлением. disableAutoUpdate Предотвращает передачу представлением информации об изменениях коллекции и ее элементов. Предотвращает передачу представлением информации об изменениях коллекции и ее элементов. Также предотвращает обновление позиций элементов в представлении при изменении позиций в коллекции. Эти изменения устанавливаются в очередь и передаются после вызова enableAutoUpdate. Если для отдельного элемента происходит больше событий, чем обновлений, представление может завершиться сбросом. Метод disableAutoUpdate действует кумулятивно; для передачи и обновления событий в представлении требуется одинаковое число вызовов enableAutoUpdate. Учтите, что disableAutoUpdate влияет только на отдельные представления; редактирование может быть обнаружено другими представлениями на базе отдельного представления. mx.collections.ICollectionView.enableAutoUpdate()mx.events.CollectionEventdispatchEvent event enableAutoUpdate Активирует автоматическое обновление. Активирует автоматическое обновление. Для получения дополнительной информации см. disableAutoUpdate. mx.collections.ICollectionView.disableAutoUpdate()getItemAt Получает элемент, расположенный по заданному индексу.Элемент в этой позиции индекса или значение null, если элемент отсутствует. indexИндекс в списке для извлечения элемента. prefetch0Значение int, указывает как направление, так и число элементов, получаемых во время запроса, если элемент не является локальным. Получает элемент, расположенный по заданному индексу. getItemIndex Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.Индекс элемента или -1, если элемент отсутствует в списке. itemИскомый элемент. Возвращает индекс элемента, если он находится в списке, где, например getItemAt(индекс) == элемент.

Примечание. В отличие от методов IViewCursor.findxxx() метод getItemIndex() не может содержать параметр, состоящий исключительно из подмножества полей искомого элемента. Данный метод всегда выполняет поиск элемента, точно соответствующего входным параметрам.

hasEventListener type initialized Автоматически вызывается компилятором MXML при создании ListCollectionView с помощью тега MXML.documentMXML-документ, содержащий данный ListCollectionView. idИгнорируется. Автоматически вызывается компилятором MXML при создании ListCollectionView с помощью тега MXML. При создании ListCollectionView посредством ActionScript требуется вызвать этот метод, протекающий в документе MXML и null для id. itemUpdated Уведомляет представление об обновлении элемента.itemЭлемент представления, который был обновлен. propertynullИмя обновленного свойства. oldValuenullСтарое значение данного свойства. (Если свойство равно null, это может быть старым значением элемента.) newValuenullНовое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.) Уведомляет представление об обновлении элемента. Этот метод рекомендуется использовать, если содержимое представления не реализует IPropertyChangeNotifier. Если вызов этого метода включает параметр property, представление может оптимизировать его механизм уведомления. В противном случае оно может выполнить простое обновление всего представления. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Применяет сортировку и фильтр к представлению.Значение равно true, если refresh() был завершен; в противном случае значение равно false. Применяет сортировку и фильтр к представлению. ICollectionView не обнаруживает автоматически изменения сортировки или фильтра, поэтому для обновления представления после установки свойства sort или filterFunction следует вызвать метод refresh(). Если в реализации ICollectionView также используется интерфейс IMXMLObject, следует вызвать метод refresh() из метода initialized().

Возвращает true, если обновление было успешным, и false, если сортировка еще не закончена (например, элементы еще находятся в состоянии ожидания). Клиент представления должен ожидать события CollectionEvent со значением свойства CollectionEventKind.REFRESH, равным kind для обеспечения завершения операции refresh().

removeAll Удаляет все элементы из списка. Удаляет все элементы из списка. removeEventListener typelisteneruseCapturefalse removeItemAt Удаляет элемент в указанной позиции индекса и возвращает его.Удаленный элемент. indexИндекс, из которого необходимо удалить элемент. Удаляет элемент в указанной позиции индекса и возвращает его. Любые элементы, прежде находившиеся после данного индекса, теперь соответствуют предыдущему индексу. setItemAt Помещает элемент в заданную позицию индекса.Замененный элемент или null в случае отсутствия элемента. itemНовый элемент, для размещения в указанной позиции индекса. indexИндекс, в который помещается элемент. Помещает элемент в заданную позицию индекса. Если элемент уже занимает данную позицию индекса, новый элемент заменит его и будет возвращен. toArray Возвращает массив, заполняемый в порядке, аналогичном реализации IList.Массив. Возвращает массив, заполняемый в порядке, аналогичном реализации IList. Этот метод может инициировать ошибку ItemPendingError. toString Вводит содержимое данного представления в строку и возвращает ее.Содержимое данного представления в виде строки. Вводит содержимое данного представления в строку и возвращает ее. willTrigger type localIndex Если представление является отсортированным или отфильтрованным, свойство localIndex содержит массив элементов в отсортированном или отфильтрованном (упорядоченном, уменьшенном) представлении в порядке сортировки. Если представление является отсортированным или отфильтрованным, свойство localIndex содержит массив элементов в отсортированном или отфильтрованном (упорядоченном, уменьшенном) представлении в порядке сортировки. Класс ListCollectionView использует данное свойство для доступа к элементам в представлении. Свойство localIndex никогда не содержит данных, отсутствующих в источнике, но может не включать все данные источника. Это свойство содержит значение null при отсутствии сортировки. filterFunction Функция, которую представление использует для устранения элементов, несоответствующих критериям функции. Функция, которую представление использует для устранения элементов, несоответствующих критериям функции. Ожидается следующая подпись filterFunction: 
f(item:Object):Boolean
где возвращаемым значением является true, если указанный элемент следует оставить в представлении.

Если фильтр не поддерживается, в Flex инициируется ошибка при доступе к данному свойству. Для обновления представления следует вызвать refresh() после установки свойства filterFunction.

Примечание. Реализации ICollectionView в Flex извлекают все элементы из удаленного местоположения перед выполнением функции фильтрации. При использовании подкачки страниц следует применить фильтр к удаленной коллекции перед извлечением данных.

refresh()length Число элементов в данном представлении. Число элементов в данном представлении. Значение 0 означает отсутствие элементов, -1 – неизвестную длину. list IList, вставляющий строки в данное представление коллекции.mx.collections:IList IList, вставляющий строки в данное представление коллекции. sort ISort, применяемый к ICollectionView.mx.collections:ISort ISort, применяемый к ICollectionView. Установка сортировки не обновляет представление автоматически, поэтому после установки данного свойства следует вызвать метод refresh(). Если сортировка не поддерживается, то при доступе к этому свойству инициируется ошибка.

Примечание. Реализации ICollectionView в Flex извлекают все элементы из удаленного местоположения перед выполнением сортировки. При использовании подкачки страниц с сортированным списком к удаленной коллекции перед извлечением данных следует применить сортировку.

refresh()ICollectionView ICollectionView является представлением коллекции данных.flash.events:IEventDispatcher ICollectionView является представлением коллекции данных. Представление может изменяться для отображения данных, отсортированных в соответствии с различными критериями или уменьшенных фильтрами без изменения основных данных. IViewCursor обеспечивает доступ к элементам в пределах коллекции. Можно изменить коллекцию с помощью методов insert() и remove() интерфейса IViewCursor.

ICollectionView может представлять данные, извлеченные из удаленного местоположения. При реализации этого интерфейса для данных, которые могут быть удаленными, важно предусмотреть случай, когда данные недоступны, в результате чего инициируется ошибка ItemPendingError.

Интерфейс IList является альтернативой интерфейсу ICollectionView.

mx.collections.IViewCursormx.collections.errors.ItemPendingErrormx.collections.IListcollectionChange Передается при обновлении ICollectionView.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Передается при обновлении ICollectionView. contains Возвращает значение, определяющее, содержит ли данное представление указанный объект.Значение равно true, если ICollectionView содержит элемент после применения любого фильтра; в противном случае значение равно false. itemИскомый объект. Возвращает значение, определяющее, содержит ли данное представление указанный объект. В отличие от методов IViewCursor.findxxx, этот поиск будет успешным только при нахождении элемента, точно соответствующего данному параметру. При наличии фильтра, применяемого к представлению, данный метод может вернуть false даже в случае, если элемент действительно содержится в основной коллекции. createCursor Создает новый IViewCursor, работающий с данным представлением.Новая реализация IViewCursor. mx.collections:IViewCursor Создает новый IViewCursor, работающий с данным представлением. disableAutoUpdate Предотвращает передачу представлением информации об изменениях коллекции и ее элементов. Предотвращает передачу представлением информации об изменениях коллекции и ее элементов. Также предотвращает обновление позиций элементов в представлении при изменении позиций в коллекции. Эти изменения устанавливаются в очередь и передаются после вызова enableAutoUpdate. Если для отдельного элемента происходит больше событий, чем обновлений, представление может завершиться сбросом. Метод disableAutoUpdate действует кумулятивно; для передачи и обновления событий в представлении требуется одинаковое число вызовов enableAutoUpdate. Учтите, что disableAutoUpdate влияет только на отдельные представления; редактирование может быть обнаружено другими представлениями на базе отдельного представления. enableAutoUpdate Активирует автоматическое обновление. Активирует автоматическое обновление. Для получения дополнительной информации см. disableAutoUpdate. disableAutoUpdate()itemUpdated Уведомляет представление об обновлении элемента.itemЭлемент представления, который был обновлен. propertynullИмя обновленного свойства. oldValuenullСтарое значение данного свойства. (Если свойство равно null, это может быть старым значением элемента.) newValuenullНовое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.) Уведомляет представление об обновлении элемента. Этот метод рекомендуется использовать, если содержимое представления не реализует IPropertyChangeNotifier. Если вызов этого метода включает параметр property, представление может оптимизировать его механизм уведомления. В противном случае оно может выполнить простое обновление всего представления. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Применяет сортировку и фильтр к представлению.Значение равно true, если refresh() был завершен; в противном случае значение равно false. Применяет сортировку и фильтр к представлению. ICollectionView не обнаруживает автоматически изменения сортировки или фильтра, поэтому для обновления представления после установки свойства sort или filterFunction следует вызвать метод refresh(). Если в реализации ICollectionView также используется интерфейс IMXMLObject, следует вызвать метод refresh() из метода initialized().

Возвращает true, если обновление было успешным, и false, если сортировка еще не закончена (например, элементы еще находятся в состоянии ожидания). Клиент представления должен ожидать события CollectionEvent со значением свойства CollectionEventKind.REFRESH, равным kind для обеспечения завершения операции refresh().

filterFunction Функция, которую представление использует для устранения элементов, несоответствующих критериям функции. Функция, которую представление использует для устранения элементов, несоответствующих критериям функции. Ожидается следующая подпись filterFunction: 
f(item:Object):Boolean
где возвращаемым значением является true, если указанный элемент следует оставить в представлении.

Если фильтр не поддерживается, в Flex инициируется ошибка при доступе к данному свойству. Для обновления представления следует вызвать refresh() после установки свойства filterFunction.

Примечание. Реализации ICollectionView в Flex извлекают все элементы из удаленного местоположения перед выполнением функции фильтрации. При использовании подкачки страниц следует применить фильтр к удаленной коллекции перед извлечением данных.

refresh()length Число элементов в данном представлении. Число элементов в данном представлении. Значение 0 означает отсутствие элементов, -1 – неизвестную длину. sort ISort, применяемый к ICollectionView.mx.collections:ISort ISort, применяемый к ICollectionView. Установка сортировки не обновляет представление автоматически, поэтому после установки данного свойства следует вызвать метод refresh(). Если сортировка не поддерживается, то при доступе к этому свойству инициируется ошибка.

Примечание. Реализации ICollectionView в Flex извлекают все элементы из удаленного местоположения перед выполнением сортировки. При использовании подкачки страниц с сортированным списком к удаленной коллекции перед извлечением данных следует применить сортировку.

refresh()CursorBookmark Формирует параметры позиции курсора в ICollectionView.Object Формирует параметры позиции курсора в ICollectionView. Закладки используются для возврата курсора к абсолютной позиции в пределах ICollectionView. mx.collections.IViewCursor.bookmarkmx.collections.IViewCursor.seek()CursorBookmark Создает новый экземпляр закладки с указанным значением.valueЗначение данной закладки. Создает новый экземпляр закладки с указанным значением. getViewIndex Получает приблизительный индекс элемента, представленный этой закладкой в ее представлении.Индекс элемента. Если элемент не найден в текущем представлении, данный метод возвращает -1. Данный метод также возвращает -1, если местоположение на основе индекса невозможно. Получает приблизительный индекс элемента, представленный этой закладкой в ее представлении. Если элемент разбит на страницы, метод инициирует ошибку ItemPendingError. CURRENT Закладка, представляющая текущий элемент для IViewCursor в ICollectionView.mx.collections:CursorBookmark Закладка, представляющая текущий элемент для IViewCursor в ICollectionView. FIRST Закладка для первого элемента в ICollectionView.mx.collections:CursorBookmark Закладка для первого элемента в ICollectionView. LAST Закладка для последнего элемента в ICollectionView.mx.collections:CursorBookmark Закладка для последнего элемента в ICollectionView. Если представление не имеет элементов, курсор находится на данной закладке. value Представление основного маркера закладки. Представление основного маркера закладки. Это значение обычно распознается только реализацией IViewCursor или ICollectionView. IViewCursor Определяет интерфейс для перечисления двунаправленных представлений коллекции.flash.events:IEventDispatcher Определяет интерфейс для перечисления двунаправленных представлений коллекции. Этот курсор обеспечивает возможности поиска, перехода и установки закладки наряду с методами изменения вставки и удаления. Если курсор сначала извлекается из представления (обычно методом createCursor() ICollectionView), значение свойства current должно быть первым элементом непустого представления. cursorUpdate Передается при каждом обновлении позиции курсора.mx.events.FlexEvent.CURSOR_UPDATEmx.events.FlexEvent Передается при каждом обновлении позиции курсора. findAny Находит в коллекции элемент с указанными свойствами и позиционирует курсор на этом элементе.Если все данные являются локальными, то этот метод возвращает true, если элемент можно найти, и false, если нет. valuesКритерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x, y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value}. Находит в коллекции элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, то местоположение курсора не изменяется.

Метод findAny() может быть вызван только в представлениях с выполненной сортировкой; в противном случае возникает ошибка CursorError.

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

Если критериям поиска может соответствовать несколько элементов, то найденный элемент является недетерминированным. Если важно найти первое или последнее вхождение элемента в неуникальный индекс, следует использовать метод findFirst() или findLast().

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.

findFirst()findLast()mx.collections.errors.ItemPendingErrorfindFirst Находит в пределах коллекции первый элемент с указанными свойствами и позиционирует курсор на этом элементе.Если все данные являются локальными, то этот метод возвращает true, если элемент можно найти, и false, если нет. valuesКритерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x, y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value}. Находит в пределах коллекции первый элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, то местоположение курсора не изменяется.

Метод findFirst() можно вызвать только в представлениях с выполненной сортировкой, в противном случае инициируется ошибка CursorError.

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

Если поиск первого вхождения элемента в групповой индекс не является обязательным, используйте findAny(), который может оказаться немного более быстрым, чем метод findFirst().

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.

findAny()findLast()mx.collections.errors.ItemPendingErrorfindLast Находит в коллекции последний элемент с указанными свойствами и позиционирует курсор на этом элементе.Если все данные являются локальными, то этот метод возвращает true, если элемент можно найти, и false, если нет. valuesКритерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x, y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value}. Находит в коллекции последний элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, местоположение курсора не изменяется.

Метод findLast() может быть вызван только в представлениях с выполненной сортировкой; если сортировка в представлении не выполнена, инициируется ошибка CursorError.

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

Если поиск последнего вхождения элемента в групповой индекс не является обязательным, используйте метод findAny(), который может оказаться немного более быстрым.

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.

findAny()findFirst()mx.collections.errors.ItemPendingErrorinsert Вставляет указанный элемент перед текущим расположением курсора.itemЭлемент, вставляемый перед текущей позицией курсора. Вставляет указанный элемент перед текущим расположением курсора. Если курсор – afterLast, вставка производится в конце представления. Если курсор – beforeFirst в непустом представлении, инициируется ошибка. moveNext Перемещает курсор на следующий элемент коллекции.Значение равно true, если по-прежнему в списке; false, если изначально значение было равно current, либо в данный момент равно afterLast. Перемещает курсор на следующий элемент коллекции. При удачном выполнении свойство current обновляется для ссылки на объект в новом местоположении. Возвращает true, если результирующее свойство current является действительным, или false, если это не так (значение свойства равно afterLast).

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.

 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      while (!cursor.afterLast)
      {
          trace(cursor.current);
          cursor.moveNext();
      }
currentmovePrevious()mx.collections.errors.ItemPendingErrormovePrevious Перемещает курсор на предыдущий элемент коллекции.Значение равно true, если по-прежнему в списке; false, если начальное или текущее значение current равно beforeFirst. Например: 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      cursor.seek(CursorBookmark.last);
      while (!cursor.beforeFirst)
      {
          trace(current);
          cursor.movePrevious();
      }
Перемещает курсор на предыдущий элемент коллекции. При удачном выполнении свойство current обновляется для ссылки на объект в новом местоположении. Возвращает значение true, если результирующее свойство current является действительным, или false, если нет (значение свойства равно beforeFirst).

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.

currentmoveNext()mx.collections.errors.ItemPendingErrorremove Удаляет текущий элемент и возвращает его.Удаленный элемент. Удаляет текущий элемент и возвращает его. Если местоположение курсора равно beforeFirst или afterLast, инициируется ошибка CursorError. При удалении любого элемента (кроме последнего) курсор перемещается на следующий элемент. При удалении последнего элемента курсор позиционируется на закладке AFTER_LAST.

Если элемент после удаленного элемента не является локальным и следует выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.

mx.collections.errors.ItemPendingErrorseek Перемещает курсор в местоположение, определяемое смещением от указанной закладки.bookmarkmx.collections:CursorBookmarkСсылка CursorBookmark на информацию о маркере, которая позволяет повторно установить его в указанное местоположение. Можно настроить этот параметр на значение, возвращаемое из свойства bookmark, или на одно из следующих постоянных значений закладки:
  • CursorBookmark.FIRST – поиск начинается с начала (первого элемента) коллекции;
  • CursorBookmark.CURRENT – поиск начинается из текущего расположения в коллекции;
  • CursorBookmark.LAST – поиск начинается с конца (последнего элемента) коллекции.
offset0Указывает глубину поиска от указанной закладки. Если указано отрицательное число, курсор перемещается от начала до указанной закладки. Если указано смещение за пределы коллекции, курсор позиционируется вне коллекции, в позиции beforeFirst или afterLast. prefetch0Используется для удаленных данных. Указывает намерение выполнить итерации в определенном направлении сразу после завершения операции поиска. Это уменьшает число необходимых сетевых обходов при поиске. Если направление итерации известно во время запроса, соответствующее количество данных может быть возвращено перед запросом для его итерации. Перемещает курсор в местоположение, определяемое смещением от указанной закладки. Если смещение является отрицательным числом, курсор позиционируется перед указанной закладкой на число элементов offset.

Если связанная коллекция является удаленной и не все ее элементы кэшированы локально, этот метод начинает асинхронную выборку из удаленной коллекции.

Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.

mx.collections.errors.ItemPendingErrorafterLast Если курсор расположен после последнего элемента в представлении, это свойство равно true. Если курсор расположен после последнего элемента в представлении, это свойство равно true. Если ICollectionView пуст (длина == 0), данное свойство равно true. beforeFirst Если курсор расположен перед первым элементом в представлении, это свойство равно true. Если курсор расположен перед первым элементом в представлении, это свойство равно true. Если ICollectionView пуст (длина == 0), данное свойство равно true. bookmark Предоставляет доступ к закладке, которая соответствует элементу, возвращаемому свойством current.mx.collections:CursorBookmark Предоставляет доступ к закладке, которая соответствует элементу, возвращаемому свойством current. Закладку можно использовать для перемещения курсора на уже просмотренный элемент или на позицию, соответствующую данному элементу. (Для получения дополнительной информации см. описание метода seek()) currentseek()current Предоставляет доступ к объекту в местоположении исходной коллекции, на которое ссылается данный курсор. Предоставляет доступ к объекту в местоположении исходной коллекции, на которое ссылается данный курсор. Если курсор находится за пределами коллекции (beforeFirst, afterLast), то возвращается значение null. moveNext()movePrevious()seek()beforeFirstafterLastview Ссылка на ICollectionView, с которым связан этот курсор.mx.collections:ICollectionView Ссылка на ICollectionView, с которым связан этот курсор.