Справочное руководство по TDMS 5.0 API
Move Method
Смотри также  Послать замечания
Object
Порядковый номер в коллекции, ссылка на объект, дескриптор, GUID или описание объекта, который надо переместить.
Position
Позиция (порядковый номер в коллекции), на которую надо переставить Object. Вместо номера можно задать системное имя, описание или ссылку на объект TDMSObject, на чью позицию будет переставлен Object. В этом случае объект, заданный аргументом Position, будет смещен на позицию вниз.
TDMSObjects Коллекция : Move Method

Glossary Item Box

Описание

Переставить объект в коллекции на заданную позицию.

Определение

Visual Basic
Public Sub Move( _
   ByVal Object As Variant, _
   ByVal Position As Variant _
)

Параметры

Object
Порядковый номер в коллекции, ссылка на объект, дескриптор, GUID или описание объекта, который надо переместить.
Position
Позиция (порядковый номер в коллекции), на которую надо переставить Object. Вместо номера можно задать системное имя, описание или ссылку на объект TDMSObject, на чью позицию будет переставлен Object. В этом случае объект, заданный аргументом Position, будет смещен на позицию вниз.

Заметки

1. Если коллекция не является составом объекта (TDMSObject.Content или TDMSObject.Objects), а создана виртуальной, действие метода имеет силу только на время выполнения скрипта.

2. Метод выполяет перемещение объекта в локальной копии коллекции, без обращения к базе данных. Для того, чтобы изменения были сохранены, необходимо вызвать метод TDMS~ TDMSObjects~Update (иначе редактирование будет потеряно).

' Правильно:
Set Coll = ThisObject.Content ' Запрошена локальная копия коллекции
Coll.Move obj1, 2 'Переставить объект
Coll.Update 'Обновить информацию в базе - изменения сохранены.

'Неправильно:
ThisObject.Content.Move obj1, 2 'При обращении ThisObject.Content запрашивается коллекция, в ней выполняется перестановка
ThisObject.Content.Update 'Теперь коллекция запрашивается снова и выполняется запрос на обновление
'Все изменения потеряны.

3. Нумерация элементов в коллекции начинается с 0. Для определения максимально допустимой позиции нужно использовать свойство Count.

4. Вызывать метод может только пользователь с правами на редактирование состава объекта-владельца коллекции (если есть).
Исключение: для скриптов при обращении через переменную ThisObject.

Смотри также

© 2016 CSoft Development. Все права защищены.