Начинает автоматическую группировку колонок. При автоматической группировке учитываются значения уровней, заданные при выводе колонок методом Присоединить.
Синтаксис
НачатьАвтогруппировкуКолонок()Полное описание, параметры и ограничения
ТабличныйДокумент.НачатьАвтогруппировкуКолонок (SpreadsheetDocument.StartColumnAutoGrouping)
ТабличныйДокумент (SpreadsheetDocument)
НачатьАвтогруппировкуКолонок (StartColumnAutoGrouping)
Доступен, начиная с версии 8.0.
Синтаксис:
НачатьАвтогруппировкуКолонок()
Описание:
Начинает автоматическую группировку колонок. При автоматической группировке учитываются значения уровней, заданные при выводе колонок методом Присоединить.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
См. также:
ТабличныйДокумент, метод ЗакончитьАвтогруппировкуКолонок
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Автоматически сгруппировать месячные колонки по уровням
Вместо ручного начала каждой группы передаём уровни при Присоединить. Уровень 2 отведён месячным деталям, уровень 1 — итоговой колонке.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
ТабДок.НачатьАвтогруппировкуКолонок();
Шапка = Новый ТабличныйДокумент;
Шапка.Область(1, 1).Текст = "Продажи";
ТабДок.Вывести(Шапка, 1, "Итоги", Истина);
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Название,Сумма", "Январь", 100));
Месяцы.Добавить(Новый Структура("Название,Сумма", "Февраль", 200));
Для Каждого Месяц Из Месяцы Цикл
Колонка = Новый ТабличныйДокумент;
Колонка.Область(1, 1).Текст = Месяц.Название + ": " + Строка(Месяц.Сумма);
ТабДок.Присоединить(Колонка, 2, "Месяцы", Истина);
КонецЦикла;
Итог = Новый ТабличныйДокумент;
Итог.Область(1, 1).Текст = "Итого: 300";
ТабДок.Присоединить(Итог, 1, "Итоги", Истина);
ТабДок.ЗакончитьАвтогруппировкуКолонок();
ТабДок.ИтогиСправа = Истина;
ТабДок.ОтображатьГруппировки = Истина;
ТабДок.ТолькоПросмотр = Истина;
Сообщить(ТабДок.ШиринаТаблицы = 4);
Сообщить(ТабДок.КоличествоУровнейГруппировокКолонок() > 0);
Сообщить(ТабДок.Область(1, 4).Текст = "Итого: 300");
Возврат ТабДок;
КонецФункции
Разбор по шагам
НачатьАвтогруппировкуКолонок включает учёт уровней горизонтального вывода. Вывести задаёт первый блок, Присоединить добавляет колонки справа.
Две месячные колонки имеют более глубокий уровень 2. Итог с уровнем 1 закрывает детализацию.
ЗакончитьАвтогруппировкуКолонок завершает построение структуры. Проверяем факт появления уровней, не предполагаем одинаковое число маркеров у разных режимов вывода.
Как проверить результат
Три проверки дают Истина.
В показе четыре колонки: Продажи, Январь: 100, Февраль: 200, Итого: 300. Сверните/разверните месячную детализацию.
Ожидаемый результат
Минимальный горизонтальный пример автоматических групп с подготовленными числами.
На что обратить внимание
Уровень — параметр группировки, не номер колонки.
Не смешивайте ручной и автоматический режим в одном упражнении без понимания их границ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.