Тип: Булево. Содержит признак отображения группировок. Истина - отображается.
Полное описание, параметры и ограничения
ТабличныйДокумент.ОтображатьГруппировки (SpreadsheetDocument.ShowGroups)
ТабличныйДокумент (SpreadsheetDocument)
ОтображатьГруппировки (ShowGroups)
Доступен, начиная с версии 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.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Автоматически сгруппировать месячные колонки по уровням
Вместо ручного начала каждой группы передаём уровни при Присоединить. Уровень 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. Сверните/разверните месячную детализацию.
Ожидаемый результат
Минимальный горизонтальный пример автоматических групп с подготовленными числами.
На что обратить внимание
Уровень — параметр группировки, не номер колонки.
Не смешивайте ручной и автоматический режим в одном упражнении без понимания их границ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.