Как в 1С получить индекс строки табличной части

При разработке на платформе 1С:Предприятие регулярно возникает задача определить позицию конкретной строки в табличной части документа или справочника. Индекс строки нужен для обращения к соседним строкам, сравнения позиций, построения навигации по коллекции и синхронизации данных между объектами.

Главное, что нужно понимать сразу: индекс и номер строки — это разные вещи. Индекс начинается с нуля, а номер строки, который видит пользователь в колонке «№», начинается с единицы. Путаница между этими значениями — самая частая причина ошибок «Индекс находится за границами массива».

Ниже разобраны основные способы получения индекса: через метод Индекс(), через поиск по значениям, через перебор коллекции, а также особенности работы с управляемыми формами и объектами типа «ДанныеФормыКоллекция».

Отличие индекса от номера строки

В табличной части каждая строка имеет два «адреса». Первый — номер строки, который платформа ведёт автоматически и показывает пользователю. Второй — индекс, то есть позицию строки в коллекции при программной работе.

Нумерация строк ведётся с единицы и при удалении строк может пересчитываться автоматически (в зависимости от настроек объекта). Индексация же всегда начинается с нуля и отражает физический порядок элементов в коллекции. Если строка первая по номеру, её индекс равен нулю.

Практическое следствие: если вы хотите получить «человеческий» номер по индексу, прибавляйте единицу. Если по номеру строки нужно обратиться к элементу коллекции через Получить() или квадратные скобки — вычитайте единицу.

Метод Индекс() — основной способ

Если у вас уже есть ссылка на строку табличной части (например, текущая строка в обработчике события), индекс получается одним вызовом метода Индекс() коллекции:

ТабЧасть = Объект.Товары;
ТекСтрока = ТабЧасть[0]; // первая строка
ИндексСтроки = ТабЧасть.Индекс(ТекСтрока); // вернёт 0

Метод принимает элемент коллекции и возвращает его позицию. Если переданная строка не принадлежит этой конкретной коллекции, метод вернёт -1 — это важно учитывать при проверках.

Типичный сценарий — обработчик события формы, где текущая строка известна, а нужно узнать её позицию для обращения к соседним строкам:

&НаКлиенте
Процедура ТоварыПриАктивизацииСтроки(Элемент)
ТекСтрока = Элементы.Товары.ТекущиеДанные;
Если ТекСтрока = Неопределено Тогда
Возврат;
КонецЕсли;
Индекс = Объект.Товары.Индекс(ТекСтрока);
// Теперь можно обратиться к следующей строке
Если Индекс + 1 < Объект.Товары.Количество() Тогда
СледСтрока = Объект.Товары[Индекс + 1];
КонецЕсли;
КонецПроцедуры

Поиск индекса по значениям полей

Часто строка заранее неизвестна, и её нужно сначала найти по значению реквизита — например, по номенклатуре. Здесь применяется связка методов Найти() или НайтиСтроки() с последующим вызовом Индекс().

НайденнаяСтрока = Объект.Товары.Найти(НоменклатураСсылка, "Номенклатура");
Если НайденнаяСтрока <> Неопределено Тогда
Индекс = Объект.Товары.Индекс(НайденнаяСтрока);
Иначе
// строки с такой номенклатурой нет
КонецЕсли;

Метод Найти() возвращает первую подходящую строку или Неопределено. Если подходящих строк может быть несколько, используйте НайтиСтроки() с структурой отбора — он вернёт массив строк, и для каждой можно получить индекс.

ПараметрыОтбора = Новый Структура("Номенклатура", НоменклатураСсылка);
НайденныеСтроки = Объект.Товары.НайтиСтроки(ПараметрыОтбора);
Для Каждого СтрокаТЧ Из НайденныеСтроки Цикл
    Индекс = Объект.Товары.Индекс(СтрокаТЧ);
КонецЦикла;

Получение индекса при переборе коллекции

Если вы обходите табличную часть в цикле, индекс можно получить напрямую, без метода Индекс() — это быстрее и нагляднее. Есть два подхода: цикл со счётчиком и цикл «Для Каждого» с отдельной переменной-счётчиком.

// Вариант 1: цикл по индексам
Для Инд = 0 По Объект.Товары.Количество() - 1 Цикл
СтрокаТЧ = Объект.Товары[Инд];
// Инд — это и есть индекс строки
КонецЦикла;

// Вариант 2: счётчик в цикле "Для Каждого"
Инд = 0;
Для Каждого СтрокаТЧ Из Объект.Товары Цикл
// Инд соответствует позиции СтрокаТЧ
Инд = Инд + 1;
КонецЦикла;

Первый вариант предпочтителен, когда внутри цикла нужен сам индекс или доступ к соседним строкам. Второй удобен, когда индекс нужен эпизодически. Помните: удалять строки внутри цикла «Для Каждого» нельзя — это приведёт к ошибке обхода коллекции.

Особенности управляемых форм

На управляемой форме табличная часть представлена объектом ДанныеФормыКоллекция. Метод Индекс() у неё есть и работает так же, но есть нюансы с получением текущей строки.

Свойство Элементы.Товары.ТекущаяСтрока возвращает не строку коллекции, а её идентификатор (число). Чтобы получить сами данные строки, используйте Объект.Товары.НайтиПоИдентификатору(ТекущаяСтрока) или свойство ТекущиеДанные элемента формы.

&НаКлиенте
Процедура ПоказатьИндекс(Команда)
ТекДанные = Элементы.Товары.ТекущиеДанные;
Если ТекДанные = Неопределено Тогда
Возврат;
КонецЕсли;
Индекс = Объект.Товары.Индекс(ТекДанные);
Сообщить("Индекс: " + Индекс + ", номер строки: " + ТекДанные.НомерСтроки);
КонецПроцедуры

Обратное преобразование тоже возможно: по идентификатору строки можно получить индекс через Объект.Товары.Индекс(Объект.Товары.НайтиПоИдентификатору(Ид)). Это нужно, когда строка выбрана интерактивно, а дальше требуется работа с позицией.

Проверка результата и граничные случаи

После получения индекса всегда проверяйте его корректность перед использованием. Валидный индекс находится в диапазоне от 0 до Количество() - 1. Значение -1 означает, что строка в коллекции не найдена.

Отдельные граничные случаи: пустая табличная часть (любой индекс невалиден), обращение к следующей строке для последней строки (индекс будет за границей), работа с отбором строк — индексы в отобранном подмножестве не совпадают с индексами исходной коллекции.

Типовой порядок действий

Соберём всё в единую последовательность для самой распространённой задачи — найти строку и получить её индекс с защитой от ошибок.

1. 1
   Убедитесь, что табличная часть не пуста: проверьте Количество()
2. 2
   Найдите строку методом Найти() или получите её из текущих данных формы
3. 3
   Проверьте, что строка не равна Неопределено
4. 4
   Получите индекс методом Индекс() коллекции
5. 5
   Проверьте, что индекс не равен -1, прежде чем использовать его для обращения по позиции
6. 6
   При обращении к соседним строкам дополнительно проверьте границы: Индекс+1 меньше Количества()

Такая последовательность исключает большинство ошибок времени выполнения и делает код устойчивым к изменениям данных пользователем.

Частые вопросы