Вызывает модальное окно для выбора строки из дерева значений.
Синтаксис
ВыбратьСтроку(<Заголовок>, <НачальнаяСтрока>)Примеры платформы
ВыбСтрока = ДеревоЦелей.ВыбратьСтроку("Выберите значение");Полное описание, параметры и ограничения
ДеревоЗначений.ВыбратьСтроку (ValueTree.ChooseRow)
ДеревоЗначений (ValueTree)
ВыбратьСтроку (ChooseRow)
Доступен, начиная с версии 8.0.
Синтаксис:
ВыбратьСтроку(<Заголовок>, <НачальнаяСтрока>)
Параметры:
<Заголовок> (необязательный)
Тип: Строка.
Заголовок диалога выбора строки.
Если заголовок не указан, то будет использован стандартный заголовок "Выберите строку".
<НачальнаяСтрока> (необязательный)
Тип: СтрокаДереваЗначений.
Начальная строка дерева (будет выделенной при открытии диалога). Если не указана, то выделенной будет первая строка дерева.
Возвращаемое значение:
Тип: СтрокаДереваЗначений, Неопределено.
Если пользователь отказался от выбора, возвращает Неопределено.
Описание:
Вызывает модальное окно для выбора строки из дерева значений.
Доступность:
Толстый клиент.
Пример:
ВыбСтрока = ДеревоЦелей.ВыбратьСтроку("Выберите значение");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Выбрать собственную строку дерева значений
Диалог толстого клиента выбирает строку из созданного здесь дерева, а отмена обрабатывается отдельно.
Где и как запускать
Толстый клиент своей учебной базы; фрагмент вставляется в обработчик своей команды. Здесь 1С не запускалась.
Подготовка
Запустите свою учебную базу в толстом клиенте.
Код вставляется в обработчик собственной команды; тонкому клиенту этот метод недоступен.
Дерево = Новый ДеревоЗначений;
Дерево.Колонки.Добавить("Название");
Дерево.Строки.Добавить().Название = "Книга";
Дерево.Строки.Добавить().Название = "Тетрадь";
Выбранная = Дерево.ВыбратьСтроку("Выберите товар", Дерево.Строки[0]);
Если Выбранная = Неопределено Тогда
Сообщить("Выбор отменён");
Иначе
Сообщить(Выбранная.Название);
КонецЕсли;Разбор по шагам
Заполняем дерево двумя собственными строками.
Задаём заголовок и начальную строку диалога.
Выводим выбранное название либо сообщение отмены.
Как проверить результат
При выборе книги показано Книга.
При отмене не производится чтение свойств Неопределено.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
Выбранная строка принадлежит исходному дереву. Диалог не сортирует данные и не создаёт отдельную копию строки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.