Возвращает определенный объект - член в коллекции, по его численной позиции или по строке ключа.

Объект-член коллекции может иметь любой действительный тип, который может быть присвоен переменной памяти. Это включает в себя простые типы данных, такие, как строки, числа, даты, логические и более сложные типы, такие, как объекты Visual FoxPro и Component Object Model (COM). Метод Item для объектов коллекции обычно используется с перечислениями  FOR EACH...ENDFOR для ссылки на членов коллекции.

Collection.Item( eIndex )

Параметры

eIndex

Определяет требуемое выражение, которое представляет позиицию члена в коллекции. Это выражение может быть одним из двух типов:
  • Челочисленное. Выражение eIndex должно иметь значение в диапазоне от 1 до значения свойства коллекции Count.

  • Строковое. Выражение eIndex должно соответствовать ключу cKey, который был указан при добавлении члена в коллекцию.

Если eIndex не соответствует существующему члену коллекции, то генерируется ошибка.

Возвращаемое значение

Возвращает определенный элемент.

Примечания

Если в качестве параметра передан некорректный тип, то происходит ошибка.

Метод Item для коллекции объектов возвращает значение, которое представляет собой сам элемент коллекции. Поэтому вам необходимо добавить команду RETURN в конце исходного кода метода Item для любого субкласса, который вы модифицируете:

  Скопировать код
RETURN DODEFAULT(eIndex)

Если же вы не желаете возвращать объект, используйте команду RETURN без дополнения  функцией DODEFAULT().

Метод Item для коллекции объектов является методом по умолчанию для коллекции. Например, предположим, что у вас есть код приведенный ниже:

  Скопировать код
Public MyCollection AS Collection
MyCollection = CREATEOBJECT("Collection")
MyCollection.Add(CREATEOBJECT("Form"),"myKey")

Приведенные ниже строки кода эквиваленты друг другу:

  Скопировать код
? MyCollection(1)
? MyCollection.Item(1)
? MyCollection("myKey")

Пример

Приведенный ниже пример иллюстрирует эти задачи в run time:

  • Создает формы и коллекцию.

  • Добавляет формы в коллекцию.

  • Отображает имя каждой формы в коллекции.

  • Отображает число форм в коллекции.

  • Отображает имя первого члена в коллекции.

  • Отображает имя первого члена в коллекции, получаемого с помощью метода Item коллекции.

  Скопировать код
loForm1 = CREATEOBJECT("myForm1")
loForm2 = CREATEOBJECT("myForm2")
loCol = CREATEOBJECT("myCollection")
loCol.Add(loForm1)
loCol.Add(loForm2)
? loCol(1).Name
? loCol.Item(1).Name

Смотри также