Типичный пример использования командой формы текущей строки таблицы – это, например, когда из формы списка справочника вызывается команда, связанная с текущим элементом этого списка.
Предположим, нам нужно открыть список заказов, сделанных конкретным контрагентом. Для отображения списка контрагентов в форме списка справочника используется таблица Список, связанная с основным реквизитом Список (типа ДинамическийСписок), получающим данные из справочника Контрагенты.
Добавим команду Заказы и перетащим ее в командную панель формы. Установим свойство команды ИспользованиеТекущейСтроки в значение Использует, а в свойстве ИспользуемаяТаблица выберем таблицу Список (рис. 5.12).

Рис. 5.12. Форма списка справочника «Контрагенты» в конфигураторе
Таким образом мы задали, что команда Заказы будет использовать данные текущей строки таблицы Список. Создадим обработчик команды и заполним его следующим образом (листинг 5.1).
Листинг 5.1. Обработчик команды «Заказы»
&НаКлиенте
Процедура Заказы(Команда)
ПараметрыФормы = Новый Структура("Отбор", Новый Структура("Покупатель", Элементы.Список.ТекущаяСтрока));
ОткрытьФорму("Документ.Заказ.ФормаСписка", ПараметрыФормы);
КонецПроцедуры
В этом обработчике, используя свойство ТекущаяСтрока таблицы Список, мы получаем ссылку на текущий элемент списка контрагентов. И устанавливаем эту ссылку, как значение отбора по полю Покупатель, в структуре параметров формы. Затем открываем форму списка документа Заказ с отбором по данному контрагенту.
Обновим конфигурацию базы данных (F7) и опубликуем конфигурацию на веб-сервере. После этого запустим наше демонстрационное приложение на планшете и откроем форму списка контрагентов.
Стандартно у таблицы списка свойство ИспользованиеТекущейСтроки установлено в значение Авто, поэтому она работает в режиме выбора конкретного контрагента и показывает выделенную строку лишь кратковременно. Но поскольку команда Заказы использует текущую строку таблицы, то она будет доступна из контекстного меню, вызываемого жестом пролистывания с правой стороны экрана нужной строки списка контрагентов.
Вызовем контекстное меню у какого-либо контрагента. Поскольку меню большое, то, чтобы увидеть нашу команду, нажмем Еще и в появившемся списке команд выберем команду Заказы. В результате в новом окне планшета откроется список заказов, сделанных выбранным контрагентом (рис. 5.13).

Рис. 5.13. Список заказов контрагента