Описание
Определение
| Visual Basic |
|---|
Public Function LocateInTree( _ ByVal pObject As TDMSObject, _ Optional ByVal Primary As Variant _ ) As Boolean |
Параметры
- pObject
- Ссылка на объект, который должен быть показан в Дереве.
- Primary
TRUE - искать только по главным связям (в этом случае альтернативные пути отсутствуют). FALSE - искать по любым связям.
Заметки
API-аналог команды "Найти в дереве", доступной в контекстном меню объектов на Панели состава.
Передавая ссылку на объект данному методу, необходимо предварительно убедиться в ее валидности. В случае, если ссылка имеет фактическое значение Nothing (например, получена методом ThisApplication.GetObjectByGUID(id) при недействительном значении идентификатора id), генерируется ошибка времени выполнения и скрипт останавливает работу. В другом случае, если передается ссылка на несуществующий объект (например, который был удален во время выполнения скрипта другим пользователем или ранее в этом же скрипте), будет выдана ошибка "Объект не найден", выполнение текущего кода при этом не останавливается.
