Начинает автоматическую группировку строк. При автоматической группировке учитываются значения уровней, заданные при выводе строк методом Вывести.
Синтаксис
НачатьАвтогруппировкуСтрок()Полное описание, параметры и ограничения
ТабличныйДокумент.НачатьАвтогруппировкуСтрок (SpreadsheetDocument.StartRowAutoGrouping)
ТабличныйДокумент (SpreadsheetDocument)
НачатьАвтогруппировкуСтрок (StartRowAutoGrouping)
Доступен, начиная с версии 8.0.
Синтаксис:
НачатьАвтогруппировкуСтрок()
Описание:
Начинает автоматическую группировку строк. При автоматической группировке учитываются значения уровней, заданные при выводе строк методом Вывести.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
// см. примеры метода Вывести и пример в описании объекта РезультатЗапроса.
См. также:
ТабличныйДокумент, метод ЗакончитьАвтогруппировкуСтрок
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Создать сворачиваемые группы строк отчёта
Выводим две группы и их товарные строки с уровнями 1 и 2, затем показываем интерактивную группировку.
Где и как запускать
В учебной управляемой форме создайте команду УчебныйПример и кнопку для неё. Назначьте обработчик действия УчебныйПример. Приведённую процедуру целиком вставьте в модуль формы. Не вставляйте её внутрь другой процедуры. Запустите форму в тонком или толстом клиенте Windows.
Подготовка
Создайте отдельную учебную обработку с управляемой формой; рабочие печатные формы не изменяйте.
ТабличныйДокумент.Показать открывает окно просмотра, но не отправляет документ на физический принтер.
&НаКлиенте
Процедура УчебныйПример(Команда)
Отчёт = Новый ТабличныйДокумент;
Отчёт.ОтображатьГруппировки = Истина;
Отчёт.Область(, 1, , 1).ШиринаКолонки = 32;
Отчёт.НачатьАвтогруппировкуСтрок();
Заголовок = Новый ТабличныйДокумент;
Заголовок.Область(1, 1).Текст = "Книги";
Отчёт.Вывести(Заголовок, 1);
СтрокаТовара = Новый ТабличныйДокумент;
СтрокаТовара.Область(1, 1).Текст = "Учебник: 3";
Отчёт.Вывести(СтрокаТовара, 2, "Книги", Истина);
СтрокаТовара.Область(1, 1).Текст = "Словарь: 1";
Отчёт.Вывести(СтрокаТовара, 2, "Книги", Истина);
Заголовок.Область(1, 1).Текст = "Канцелярия";
Отчёт.Вывести(Заголовок, 1);
СтрокаТовара.Область(1, 1).Текст = "Ручка: 2";
Отчёт.Вывести(СтрокаТовара, 2, "Канцелярия", Истина);
Отчёт.ЗакончитьАвтогруппировкуСтрок();
Отчёт.Показать("Группировка учебного отчёта");
КонецПроцедурыРазбор по шагам
Включаем отображение группировок и начинаем автоматическое построение групп.
Заголовки выводим с минимальным уровнем 1; они разделяют соседние группы.
Детали выводим с уровнем 2: соседние строки этого уровня объединяются в группу.
ЗакончитьАвтогруппировкуСтрок завершает построение; открываем документ и проверяем сворачивание.
Как проверить результат
В отчёте пять строк: два заголовка и три товара. В группе Книги две товарные строки.
Сверните Книги: детали скрываются, заголовок Книги остаётся видимым.
Замените уровень деталей на 1: автоматическая группировка деталей исчезнет; одинаковое имя группы не заменяет уровень.
Ожидаемый результат
Учебный отчёт позволяет сворачивать и разворачивать детализацию групп.
На что обратить внимание
Это визуальная группировка, не расчёт итогов: суммы должны вычисляться отдельно.
Порядок вывода важен: строки уровня 1 разделяют последовательности уровня 2.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.