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

Glossary Item Box

Описание

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

Опеделение

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

Параметры

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

Заметки

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

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

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

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

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

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

Смотри также

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