Открывает интерактивный диалог выбора строки из таблицы значений
Синтаксис
Метод ВыбратьСтроку()
имеет следующий синтаксис:
СтрокаТаблицыЗначений ВыбратьСтроку([Заголовок=""], [НачальнаяСтрока=])
А также альтернативный англоязычный синтаксис:
ValueTableString ChooseRow([Title=""], [CurrentString=])
Параметры
Описание параметров метода ВыбратьСтроку()
:
Имя параметра* | Тип | Описание |
---|---|---|
Заголовок | Строка | Заголовок диалогового окна выбора строки (обычно используется для подсказки пользователю) |
НачальнаяСтрока | СтрокаТаблицыЗначений | Указывает строку таблицы значений, на которой будет установлен курсор при открытии окна выбора. |
*Жирным шрифтом выделены обязательные параметры |
Возвращаемое значение
СтрокаТаблицыЗначений | — пользователь выбрал определенную строку из таблицы |
Неопределено |
— пользователь отказался от выбора (закрыл форму выбора) |
Описание
Метод ВыбратьСтроку()
открывает интерактивный диалог выбора строки из таблицы значений. Пользователь может выбрать только одну строку. Если пользователь отказался от выбора, метод возвращает значение Неопределено
.
Доступность
Версия | Поддержка |
---|---|
8.1 | Клиент |
8.2 | Толстый клиент |
8.3 | Толстый клиент |
Пример использования
Пример кода с использованием метода ВыбратьСтроку()
:
//создаем таблицу значений тз = Новый ТаблицаЗначений; тз.Колонки.Добавить("Код"); тз.Колонки.Добавить("Наименование"); тз.Колонки.Добавить("Количество"); //заполняем таблицу значений НоваяСтрока = тз.Добавить(); НоваяСтрока.Код = "001"; НоваяСтрока.Наименование = "Стул деревянный"; НоваяСтрока.Количество = 1; НоваяСтрока = тз.Добавить(); НоваяСтрока.Код = "002"; НоваяСтрока.Наименование = "Стол деревянный"; НоваяСтрока.Количество = 2; //предоставляем пользователю выбор ВыбСтрока = тз.ВыбратьСтроку("Выберите строку..."); Если НЕ ВыбСтрока = Неопределено Тогда Сообщить("Вы выбрали " + ВыбСтрока.Наименование); КонецЕсли;