Получает индекс элемента коллекции.
Синтаксис
Индекс(<Элемент>)Полное описание, параметры и ограничения
ДанныеФормыКоллекция.Индекс (FormDataCollection.IndexOf)
ДанныеФормыКоллекция (FormDataCollection)
Индекс (IndexOf)
Доступен, начиная с версии 8.2.
Синтаксис:
Индекс(<Элемент>)
Параметры:
<Элемент> (необязательный)
Тип: ДанныеФормыЭлементКоллекции.
Элемент коллекции, индекс которого требуется получить.
Возвращаемое значение:
Тип: Число.
Описание:
Получает индекс элемента коллекции.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Вставить, добавить и переставить строки только своей формы
Создаём Книга/Ручка, временно добавляем Карандаш/Вода и убираем их из памяти. Для Сдвинуть передаём индекс, для Удалить показываем два разных допустимых аргумента.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Каждая команда сначала сбрасывает ТОЛЬКО собственный реквизит Товары к двум учебным строкам. Ручные изменения этой учебной таблицы при запуске задачи будут потеряны; рабочие формы не используйте.
ДанныеФормыКоллекция не создаётся через Новый. Она возникает у реквизита формы, описанного как ТаблицаЗначений. Выгрузить/Загрузить выполняются только на сервере.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Переставить собственные строки";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
СброситьТолькоУчебныеТовары();
Карандаш = Товары.Вставить(1);
Карандаш.Код = "C-03";
Карандаш.Наименование = "Карандаш";
Карандаш.Количество = 2;
Вода = Товары.Добавить();
Вода.Код = "D-04";
Вода.Наименование = "Вода";
Вода.Количество = 5;
Сообщить(Товары.Количество() = 4);
Сообщить(Товары.Получить(1).Код = "C-03");
Ручка = Товары.Получить(2);
Товары.Сдвинуть(Товары.Индекс(Ручка), -2);
Сообщить(Товары.Получить(0).Код = "B-02");
Товары.Удалить(Карандаш);
Товары.Удалить(Товары.Индекс(Вода));
Сообщить(Товары.Количество() = 2);
Сообщить(Товары.Получить(0).Код = "B-02");
Сообщить(Товары.Получить(1).Код = "A-01");
Сообщить(Товары.Получить(0).Количество = 1);
Сообщить(Товары.Получить(1).Количество = 3);
КонецПроцедуры
&НаСервереБезКонтекста
Функция СоздатьДваУчебныхТовара()
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
Книга = Данные.Добавить();
Книга.Код = "A-01";
Книга.Наименование = "Книга";
Книга.Количество = 3;
Ручка = Данные.Добавить();
Ручка.Код = "B-02";
Ручка.Наименование = "Ручка";
Ручка.Количество = 1;
Возврат Данные;
КонецФункции
&НаСервере
Процедура СброситьТолькоУчебныеТовары()
Товары.Загрузить(СоздатьДваУчебныхТовара());
КонецПроцедуры
Разбор по шагам
Серверный сброс возвращает исходные Книга/3 и Ручка/1. Индексация начинается с 0.
Вставить(1) ставит карандаш между ними; Добавить помещает воду в конец.
Получить возвращает строку данных формы. Позиция ручки после вставки уже 2, не исходная 1.
Сдвинуть принимает ЧИСЛОВОЙ индекс и смещение. Отрицательное -2 переносит ручку в начало.
Удаляем карандаш по элементу, воду по актуальному индексу. После сдвига нельзя использовать старую позицию воды.
Удаление из данных своей формы не вызывает Удалить у объекта базы и не записывает документ.
Как проверить результат
Восемь логических сообщений дают Истина.
В конце таблица показывает Ручка/1, Книга/3; Карандаш/Вода отсутствуют. Повторный запуск даёт тот же результат благодаря собственному сбросу.
Ожидаемый результат
Разобраны вставка, добавление, доступ по индексу, сдвиг и два способа удаления на конкретных строках.
На что обратить внимание
Данные формы и ТаблицаФормы — разные объекты. Методы строк вызываются у Товары, не у Элементы.ТаблицаТоваров.
Сдвинуть у этого типа принимает индекс, не объект строки.
В реальной форме документа изменение табличной части может затем быть записано. Здесь нет команды записи и нет объекта рабочего документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сохранить выбранный товар при сортировке таблицы формы
Идентификатор строки не равен её индексу. Запоминаем идентификатор Книги, сортируем строки и находим тот же товар.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Найти Книгу после сортировки";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Элементы.ТаблицаТоваров.ЗакончитьРедактированиеСтроки(Ложь);
Найденные = Товары.НайтиСтроки(Новый Структура("Код", "A-01"));
Если Найденные.Количество() <> 1 Тогда
ВызватьИсключение "Для проверки нужна ровно одна учебная Книга с кодом A-01";
КонецЕсли;
СтрокаКниги = Найденные[0];
Идентификатор = СтрокаКниги.ПолучитьИдентификатор();
ИндексДо = Товары.Индекс(СтрокаКниги);
Товары.Сортировать("Наименование Убыв");
После = Товары.НайтиПоИдентификатору(Идентификатор);
Если После = Неопределено Тогда
ВызватьИсключение "Учебная строка не найдена после сортировки";
КонецЕсли;
Элементы.ТаблицаТоваров.ТекущаяСтрока = Идентификатор;
ЭтаФорма.ТекущийЭлемент = Элементы.ТаблицаТоваров;
ДанныеСтроки = Элементы.ТаблицаТоваров.ДанныеСтроки(Идентификатор);
Если ДанныеСтроки <> Неопределено Тогда
Сообщить(СтрШаблон("%1; индекс до %2, после %3; тот же код %4",
ДанныеСтроки.Наименование, ИндексДо, Товары.Индекс(После), ДанныеСтроки.Код = "A-01"));
КонецЕсли;
Текущие = Элементы.ТаблицаТоваров.ТекущиеДанные;
Если Текущие <> Неопределено Тогда
Сообщить("Текущая строка: " + Текущие.Код);
КонецЕсли;
КонецПроцедуры
Разбор по шагам
Находим Книгу по фиксированному учебному коду и получаем её идентификатор через данные формы.
Сортировка по наименованию по убыванию меняет позицию строк, но поиск после неё выполняем по сохранённому идентификатору.
ТекущаяСтрока таблицы ожидает идентификатор, а не индекс массива. ТекущийЭлемент формы задаёт фокус.
ДанныеСтроки и ТекущиеДанные могут вернуть Неопределено, поэтому перед чтением колонок проверяем результат.
Как проверить результат
При неизменённых учебных данных индекс Книги до первого запуска равен 0, после — 1; сравнение кода даёт Истина.
Повторный запуск может показать индекс до 1 и после 1, но выбранный код остаётся A-01.
Измените код Книги вручную: вместо выбора случайной строки получите понятное исключение.
Ожидаемый результат
Выбор восстановлен по идентичности строки, а не по позиции, которая меняется при сортировке.
На что обратить внимание
Идентификатор данных формы не является ссылкой на объект базы и не предназначен для долгосрочного хранения вне жизни этих данных.
Для динамического списка ключи строк имеют другую природу. Не переносите ожидание числового индекса в другие таблицы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.