Добавлено: 24 сен 2005, 10:46
Учитывая постоянный и неослабевающий интерес трудящихся к русскоязычному help, приведу частичный текст этого вопроса, без примеров, но с комментариями, пользуйтесь на здоровье...
Объект Collection
Объект Collection (семейство) представляет упорядоченной набор компонентов, на который можно ссылаться как на единое целое.
Дополнительные сведения
Объект Collection предоставляет возможность ссылок на группу родственных компонентов как на единый объект. Единственным условием связи различных компонентов является сам факт их включения в семейство. Компоненты семейства не обязаны иметь одинаковый тип данных.
Объект Collection создается аналогично любому другому объекту. Например:
После создания семейства его компоненты добавляются с помощью метода Add и удаляются с помощью метода Remove. Возвратить конкретные компоненты из семейства позволяет метод Item, а перебор всех элементов семейства осуществляется с помощью конструкции For Each...Next.
Свойство Count
Возвращает значение типа Long (длинное целое), содержащее число компонентов в семействе. Доступно только для чтения.
Метод Item
Возвращает конкретный компонент объекта Collection, определяемый по номеру или по ключу.
Синтаксис
объект.Item(индекс)
Синтаксис метода Item содержит следующий указатель объекта и аргумент:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
индекс - Обязательный. Выражение, определяющее положение компонента в семействе. Если этот аргумент задается с помощью числового выражения, то индекс должен иметь значение от 1 до значения свойства Count. Если этот аргумент задается с помощью строкового выражения, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство.
Дополнительные сведения
Если значение аргумента индекс не соответствует ни одному из существующих компонентов семейства, возникает ошибка.
Метод Item является методом семейства, который используется по умолчанию. Это означает, что следующие конструкции эквивалентны:
Print ИмяСемейства(1)
Print ИмяСемейства.Item(1)
Метод Add
Добавляет компонент в объект Collection.
Синтаксис
объект.Add item, key, before, after
Синтаксис метода Add содержит следующий указатель объекта и именованные аргументы:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
item - Обязательный. Выражение любого типа, определяющее компонент, добавляемый в семейство.
key - Необязательный. Уникальное строковое выражение, определяющее ключевую строку, которая может быть использована для доступа к компоненту семейства вместо порядкового номера.
before - Необязательный. Выражение, указывающее относительную позицию компонента в семействе. Компонент, добавляемый в семейство, размещается перед компонентом, указанным в аргументе before. Если этот аргумент задается с помощью числового выражения, то аргумент before должен иметь значение от 1 до значения свойства Count семейства. Если аргумент before определяется строковым выражением, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство. Допускается указание в инструкции одного из аргументов before или after, но не их обоих.
after - Необязательный. Выражение, указывающее относительную позицию компонента в семействе. Компонент, добавляемый в семейство, размещается после компонента, указанного в аргументе after. Если этот аргумент задается с помощью числового выражения, after определяется строковым выражением, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство. Допускается указание в инструкции одного из аргументов before или after, но не их обоих.
Дополнительные сведения
Другими словами, числовое или строковое значение аргумента before или after должно определять существующий компонент семейства. В противном случае возникает ошибка.
Ошибка возникает также, если указанное значение аргумента key совпадает со значением ключа существующего компонента
Метод Remove
Удаляет компонент из объекта Collection.
Синтаксис
объект.Remove индекс
Синтаксис метода Remove содержит следующий указатель объекта и аргумент:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
индекс - Обязательный. Выражение, определяющее положение компонента в семействе. Если этот аргумент задается с помощью числового выражения, то индекс должен иметь значение от 1 до значения свойства Count. Если этот аргумент задается с помощью строкового выражения, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство.
Дополнительные сведения
Если значение аргумента индекс не соответствует ни одному из существующих компонентов семейства, возникает ошибка.
Объект Collection
Объект Collection (семейство) представляет упорядоченной набор компонентов, на который можно ссылаться как на единое целое.
Дополнительные сведения
Объект Collection предоставляет возможность ссылок на группу родственных компонентов как на единый объект. Единственным условием связи различных компонентов является сам факт их включения в семейство. Компоненты семейства не обязаны иметь одинаковый тип данных.
Объект Collection создается аналогично любому другому объекту. Например:
Код: Выделить всё
Dim X As New CollectionСвойство Count
Возвращает значение типа Long (длинное целое), содержащее число компонентов в семействе. Доступно только для чтения.
Метод Item
Возвращает конкретный компонент объекта Collection, определяемый по номеру или по ключу.
Синтаксис
объект.Item(индекс)
Синтаксис метода Item содержит следующий указатель объекта и аргумент:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
индекс - Обязательный. Выражение, определяющее положение компонента в семействе. Если этот аргумент задается с помощью числового выражения, то индекс должен иметь значение от 1 до значения свойства Count. Если этот аргумент задается с помощью строкового выражения, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство.
Дополнительные сведения
Если значение аргумента индекс не соответствует ни одному из существующих компонентов семейства, возникает ошибка.
Метод Item является методом семейства, который используется по умолчанию. Это означает, что следующие конструкции эквивалентны:
Print ИмяСемейства(1)
Print ИмяСемейства.Item(1)
Метод Add
Добавляет компонент в объект Collection.
Синтаксис
объект.Add item, key, before, after
Синтаксис метода Add содержит следующий указатель объекта и именованные аргументы:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
item - Обязательный. Выражение любого типа, определяющее компонент, добавляемый в семейство.
key - Необязательный. Уникальное строковое выражение, определяющее ключевую строку, которая может быть использована для доступа к компоненту семейства вместо порядкового номера.
before - Необязательный. Выражение, указывающее относительную позицию компонента в семействе. Компонент, добавляемый в семейство, размещается перед компонентом, указанным в аргументе before. Если этот аргумент задается с помощью числового выражения, то аргумент before должен иметь значение от 1 до значения свойства Count семейства. Если аргумент before определяется строковым выражением, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство. Допускается указание в инструкции одного из аргументов before или after, но не их обоих.
after - Необязательный. Выражение, указывающее относительную позицию компонента в семействе. Компонент, добавляемый в семейство, размещается после компонента, указанного в аргументе after. Если этот аргумент задается с помощью числового выражения, after определяется строковым выражением, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство. Допускается указание в инструкции одного из аргументов before или after, но не их обоих.
Дополнительные сведения
Другими словами, числовое или строковое значение аргумента before или after должно определять существующий компонент семейства. В противном случае возникает ошибка.
Ошибка возникает также, если указанное значение аргумента key совпадает со значением ключа существующего компонента
Метод Remove
Удаляет компонент из объекта Collection.
Синтаксис
объект.Remove индекс
Синтаксис метода Remove содержит следующий указатель объекта и аргумент:
Элемент - Описание
объект - Обязательный. Объектное выражение, значением которого является один из объектов, перечисленных в списке "Применение".
индекс - Обязательный. Выражение, определяющее положение компонента в семействе. Если этот аргумент задается с помощью числового выражения, то индекс должен иметь значение от 1 до значения свойства Count. Если этот аргумент задается с помощью строкового выражения, то его значение должно совпадать со значением аргумента key, указанным для одного из компонентов семейства при его добавлении в семейство.
Дополнительные сведения
Если значение аргумента индекс не соответствует ни одному из существующих компонентов семейства, возникает ошибка.