Выполняет поиск среди иерархии подчиненных объектов по указанным параметрам.
Синтаксис
НайтиОбъекты(<Тип>, <ТекстЗаголовка>, <Имя>, <Таймаут>)Полное описание, параметры и ограничения
ТестируемоеПолеФормы.НайтиОбъекты (TestedFormField.FindObjects)
ТестируемоеПолеФормы (TestedFormField)
НайтиОбъекты (FindObjects)
Доступен, начиная с версии 8.3.1.
Синтаксис:
НайтиОбъекты(<Тип>, <ТекстЗаголовка>, <Имя>, <Таймаут>)
Параметры:
<Тип> (необязательный)
Тип: Тип.
Тип объекта, которое нужно найти.
Значение по умолчанию: Неопределено.
<ТекстЗаголовка> (необязательный)
Тип: Строка.
Заголовок объекта, если это применимо. Может содержать знаки подстановки "*" и "?".
<Имя> (необязательный)
Тип: Строка.
Имя объекта, если это применимо. Может содержать знаки подстановки "*" и "?".
<Таймаут> (необязательный)
Тип: Число.
Время в секундах, в течение которого выполняется поиск объекта. Если значение параметра не задано, время поиска не ограничено.
Значение по умолчанию: 0.
Возвращаемое значение:
Тип: ФиксированныйМассив.
Фиксированный массив найденных объектов.
Описание:
Выполняет поиск среди иерархии подчиненных объектов по указанным параметрам.
Доступность:
Тонкий клиент, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.1.
Методическая информация
Практические примеры
Исследовать фактические дочерние объекты своего поля
Поиск работает на полученном поле формы. Если это лист дерева, отсутствие детей является нормальным результатом.
Где и как запускать
Тонкий или толстый клиент в режиме менеджера тестирования, собственный тестируемый тонкий клиент.
Подготовка
Только свои учебные сеансы: вручную запустите тонкий клиент с /TESTCLIENT -TPort15419, другой клиент — с /TESTMANAGER. Соединение использует 127.0.0.1:15419. В тестируемом клиенте заранее откройте собственную управляемую форму с заголовком Учебный стенд. Код вставьте в клиентский модуль формы менеджера тестирования, первую процедуру вызовите своей кнопкой. Здесь сеансы не запускаются.
Подготовьте собственное поле текстового документа УчебныйТекст. Его реальная тестируемая иерархия зависит от вида поля; не добавляйте вымышленные дочерние реквизиты.
&НаКлиенте
Процедура ВыполнитьУчебныйТест()
Тест = Новый ТестируемоеПриложение("127.0.0.1", 15419);
Тест.УстановитьСоединение();
Форма = Тест.ПолучитьОбъект(Тип("ТестируемаяФорма"), "Учебный стенд", , 2);
Поле = Форма.ПолучитьОбъект(Тип("ТестируемоеПолеФормы"), , "УчебныйТекст", 2);
Все = Поле.НайтиОбъекты(, , , 1);
Один = Поле.НайтиОбъект(, , , 1);
Сообщить("Найдено объектов: " + Строка(Все.Количество()));
Если Один <> Неопределено Тогда
Вид = ТипЗнч(Один);
Строгий = Поле.ПолучитьОбъект(Вид, , , 1);
Сообщить("Тип подчиненного объекта: " + Строка(Вид));
Иначе
Сообщить("У поля нет найденного подчиненного объекта");
КонецЕсли;
Тест.РазорватьСоединение();
КонецПроцедурыРазбор по шагам
Получите свое поле.
Сравните единичный и множественный поиск.
Строгий поиск выполняйте только после фактического нахождения.
Как проверить результат
У каждого поиска конечный тайм-аут.
Неопределено не подменяется другим объектом.
Ожидаемый результат
Показан действительный результат поиска в собственной иерархии поля.
На что обратить внимание
Поиск внутри поля не равен поиску соседних полей всей формы. Для соседнего поля используйте Форма.ПолучитьОбъект.
Разрыв соединения показан только на нормальном пути, не как гарантированная аварийная очистка.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.