Пакет | mx.collections |
Интерфейс | public interface IViewCursor extends IEventDispatcher |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
createCursor()
ICollectionView), значение свойства current
должно быть первым элементом непустого представления.
Свойство | Определено | ||
---|---|---|---|
afterLast : Boolean [только для чтения]
Если курсор расположен после последнего элемента в представлении, это свойство равно true. | IViewCursor | ||
beforeFirst : Boolean [только для чтения]
Если курсор расположен перед первым элементом в представлении, это свойство равно true. | IViewCursor | ||
bookmark : CursorBookmark [только для чтения]
Предоставляет доступ к закладке, которая соответствует элементу, возвращаемому свойством current. | IViewCursor | ||
current : Object [только для чтения]
Предоставляет доступ к объекту в местоположении исходной коллекции, на которое ссылается данный курсор. | IViewCursor | ||
view : ICollectionView [только для чтения]
Ссылка на ICollectionView, с которым связан этот курсор. | IViewCursor |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | ||
Посылает событие в поток событий. | IEventDispatcher | ||
Находит в коллекции элемент с указанными свойствами и позиционирует курсор на этом элементе. | IViewCursor | ||
Находит в пределах коллекции первый элемент с указанными свойствами и позиционирует курсор на этом элементе. | IViewCursor | ||
Находит в коллекции последний элемент с указанными свойствами и позиционирует курсор на этом элементе. | IViewCursor | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | ||
Вставляет указанный элемент перед текущим расположением курсора. | IViewCursor | ||
Перемещает курсор на следующий элемент коллекции. | IViewCursor | ||
Перемещает курсор на предыдущий элемент коллекции. | IViewCursor | ||
Удаляет текущий элемент и возвращает его. | IViewCursor | ||
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | ||
Перемещает курсор в местоположение, определяемое смещением от указанной закладки. | IViewCursor | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
Передается при каждом обновлении позиции курсора. | IViewCursor |
afterLast | свойство |
afterLast:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если курсор расположен после последнего элемента в представлении, это свойство равно true
. Если ICollectionView пуст (длина == 0), данное свойство равно true
.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие cursorUpdate
.
Реализация
public function get afterLast():Boolean
beforeFirst | свойство |
beforeFirst:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если курсор расположен перед первым элементом в представлении, это свойство равно true
. Если ICollectionView пуст (длина == 0), данное свойство равно true
.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие cursorUpdate
.
Реализация
public function get beforeFirst():Boolean
bookmark | свойство |
bookmark:CursorBookmark
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к закладке, которая соответствует элементу, возвращаемому свойством current
. Закладку можно использовать для перемещения курсора на уже просмотренный элемент или на позицию, соответствующую данному элементу. (Для получения дополнительной информации см. описание метода seek()
)
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие cursorUpdate
.
Реализация
public function get bookmark():CursorBookmark
Связанные элементы API
current | свойство |
current:Object
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к объекту в местоположении исходной коллекции, на которое ссылается данный курсор. Если курсор находится за пределами коллекции (beforeFirst
, afterLast
), то возвращается значение null
.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие cursorUpdate
.
Реализация
public function get current():Object
Связанные элементы API
view | свойство |
view:ICollectionView
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Ссылка на ICollectionView, с которым связан этот курсор.
Реализация
public function get view():ICollectionView
findAny | () | метод |
public function findAny(values:Object):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Находит в коллекции элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, то местоположение курсора не изменяется.
Метод findAny()
может быть вызван только в представлениях с выполненной сортировкой; в противном случае возникает ошибка CursorError
.
Если связанная коллекция является удаленной и не все ее элементы кэшированы локально, этот метод начинает асинхронную выборку из удаленной коллекции. Если выборка уже обрабатывается, то этот метод ожидает завершения ее обработки перед созданием другого запроса на выборку.
Если критериям поиска может соответствовать несколько элементов, то найденный элемент является недетерминированным. Если важно найти первое или последнее вхождение элемента в неуникальный индекс, следует использовать метод findFirst()
или findLast()
.
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.
Параметры
values:Object — Критерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x , y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value} .
|
Boolean — Если все данные являются локальными, то этот метод возвращает true , если элемент можно найти, и false , если нет.
|
Связанные элементы API
findFirst | () | метод |
public function findFirst(values:Object):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Находит в пределах коллекции первый элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, то местоположение курсора не изменяется.
Метод findFirst()
можно вызвать только в представлениях с выполненной сортировкой, в противном случае инициируется ошибка CursorError
.
Если связанная коллекция является удаленной и не все ее элементы кэшированы локально, этот метод начинает асинхронную выборку из удаленной коллекции. Если выборка уже обрабатывается, то этот метод ожидает завершения ее обработки перед созданием другого запроса на выборку.
Если поиск первого вхождения элемента в групповой индекс не является обязательным, используйте findAny()
, который может оказаться немного более быстрым, чем метод findFirst()
.
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.
Параметры
values:Object — Критерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x , y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value} .
|
Boolean — Если все данные являются локальными, то этот метод возвращает true , если элемент можно найти, и false , если нет.
|
Связанные элементы API
findLast | () | метод |
public function findLast(values:Object):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Находит в коллекции последний элемент с указанными свойствами и позиционирует курсор на этом элементе. Если элемент не найден, местоположение курсора не изменяется.
Метод findLast()
может быть вызван только в представлениях с выполненной сортировкой; если сортировка в представлении не выполнена, инициируется ошибка CursorError
.
Если связанная коллекция является удаленной и не все ее элементы кэшированы локально, этот метод начинает асинхронную выборку из удаленной коллекции. Если выборка уже обрабатывается, то этот метод ожидает завершения ее обработки перед созданием другого запроса на выборку.
Если поиск последнего вхождения элемента в групповой индекс не является обязательным, используйте метод findAny()
, который может оказаться немного более быстрым.
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError.
Параметры
values:Object — Критерии поиска. Значения в объекте следует конфигурировать как пары «имя-значение», подобно ассоциативному массиву (или они будут фактическим объектом для поиска). Значения указанных имен должны соответствовать свойствам, указанным в сортировке. Например, если свойства x , y и z находятся в текущей сортировке, указанные значения должны быть равны (x: x-value, y: y-value, z: z-value} .
|
Boolean — Если все данные являются локальными, то этот метод возвращает true , если элемент можно найти, и false , если нет.
|
Связанные элементы API
insert | () | метод |
public function insert(item:Object):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вставляет указанный элемент перед текущим расположением курсора. Если курсор – afterLast
, вставка производится в конце представления. Если курсор – beforeFirst
в непустом представлении, инициируется ошибка.
Параметры
item:Object — Элемент, вставляемый перед текущей позицией курсора.
|
moveNext | () | метод |
public function moveNext():Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Перемещает курсор на следующий элемент коллекции. При удачном выполнении свойство current
обновляется для ссылки на объект в новом местоположении. Возвращает true
, если результирующее свойство current
является действительным, или false
, если это не так (значение свойства равно afterLast
).
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.
ВозвращаетBoolean — Значение равно true , если по-прежнему в списке; false , если изначально значение было равно current , либо в данный момент равно afterLast .
|
Связанные элементы API
Пример
Использование этого примера
var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]); var cursor:IViewCursor = myArrayCollection.createCursor(); while (!cursor.afterLast) { trace(cursor.current); cursor.moveNext(); }
movePrevious | () | метод |
public function movePrevious():Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Перемещает курсор на предыдущий элемент коллекции. При удачном выполнении свойство current
обновляется для ссылки на объект в новом местоположении. Возвращает значение true
, если результирующее свойство current
является действительным, или false
, если нет (значение свойства равно beforeFirst
).
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.
ВозвращаетBoolean — Значение равно 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(); } |
Связанные элементы API
remove | () | метод |
public function remove():Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет текущий элемент и возвращает его. Если местоположение курсора равно beforeFirst
или afterLast
, инициируется ошибка CursorError. При удалении любого элемента (кроме последнего) курсор перемещается на следующий элемент. При удалении последнего элемента курсор позиционируется на закладке AFTER_LAST.
Если элемент после удаленного элемента не является локальным и следует выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.
ВозвращаетObject — Удаленный элемент.
|
Связанные элементы API
seek | () | метод |
public function seek(bookmark:CursorBookmark, offset:int = 0, prefetch:int = 0):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Перемещает курсор в местоположение, определяемое смещением от указанной закладки. Если смещение является отрицательным числом, курсор позиционируется перед указанной закладкой на число элементов offset
.
Если связанная коллекция является удаленной и не все ее элементы кэшированы локально, этот метод начинает асинхронную выборку из удаленной коллекции.
Если данные не являются локальными и необходимо выполнить асинхронную операцию, инициируется ошибка ItemPendingError. Для получения дополнительной информации об использовании ItemPendingError см. документацию по ItemPendingError и документацию по коллекциям.
Параметры
bookmark:CursorBookmark — Ссылка CursorBookmark на информацию о маркере, которая позволяет повторно установить его в указанное местоположение. Можно настроить этот параметр на значение, возвращаемое из свойства bookmark , или на одно из следующих постоянных значений закладки:
| |
offset:int (default = 0 ) — Указывает глубину поиска от указанной закладки. Если указано отрицательное число, курсор перемещается от начала до указанной закладки. Если указано смещение за пределы коллекции, курсор позиционируется вне коллекции, в позиции beforeFirst или afterLast .
| |
prefetch:int (default = 0 ) — Используется для удаленных данных. Указывает намерение выполнить итерации в определенном направлении сразу после завершения операции поиска. Это уменьшает число необходимых сетевых обходов при поиске. Если направление итерации известно во время запроса, соответствующее количество данных может быть возвращено перед запросом для его итерации.
|
Связанные элементы API
cursorUpdate | Событие |
mx.events.FlexEvent
свойство FlexEvent.type =
mx.events.FlexEvent.CURSOR_UPDATE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Передается при каждом обновлении позиции курсора.
КонстантаFlexEvent.CURSOR_UPDATE
определяет значение свойства type
объекта события cursorUpdate
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Tue Jun 12 2018, 11:34 AM Z