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