Тип: Булево. Определяет расположение маркеров секций, сворачивающих горизонтальные группы таблицы. Если значение свойства Истина, то маркеры будут располагаться внизу группы, в противном случае - вверху. Внимание! При помещении табличного документа в двоичные данные данное свойство не сохраняется. Следует иметь в виду, что при сворачивании группы видимой остается только строка, рядом с которой расположен маркер секции. Как правило, расположение маркеров связано с расположением итоговых строк в результирующей таблице по отношению к детализирующим. Внимание! Значение данного свойства не сохраняется в следующих случаях: - при сохранении документа в двоичные данные, - при сохранении документа в файл.
Полное описание, параметры и ограничения
ТабличныйДокумент.ИтогиСнизу (SpreadsheetDocument.TotalsBelow)
ТабличныйДокумент (SpreadsheetDocument)
ИтогиСнизу (TotalsBelow)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Булево.
Определяет расположение маркеров секций, сворачивающих горизонтальные группы таблицы. Если значение свойства Истина, то маркеры будут располагаться внизу группы, в противном случае - вверху.
Внимание! При помещении табличного документа в двоичные данные данное свойство не сохраняется.
Следует иметь в виду, что при сворачивании группы видимой остается только строка, рядом с которой расположен маркер секции. Как правило, расположение маркеров связано с расположением итоговых строк в результирующей таблице по отношению к детализирующим.
Внимание! Значение данного свойства не сохраняется в следующих случаях:
- при сохранении документа в двоичные данные,
- при сохранении документа в файл.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.23.
Методическая информация
Практические примеры
Свернуть товарные строки, оставив общий итог снаружи
Граница группы определяется моментами вывода. Две строки товаров выводим между НачатьГруппуСтрок и ЗакончитьГруппуСтрок; итог — после закрытия.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = УчебнаяТаблица();
ТабДок.Вывести(Источник.ПолучитьОбласть(1, 1, 2, 4));
ТабДок.НачатьГруппуСтрок("Учебные товары", Истина);
ТабДок.Вывести(Источник.ПолучитьОбласть(3, 1, 4, 4));
ТабДок.ЗакончитьГруппуСтрок();
ТабДок.Вывести(Источник.ПолучитьОбласть(5, 1, 5, 4));
ТабДок.ОтображатьГруппировки = Истина;
ТабДок.ИтогиСнизу = Истина;
ТабДок.ТолькоПросмотр = Истина;
Сообщить(ТабДок.КоличествоУровнейГруппировокСтрок() = 1);
Сообщить(ТабДок.Область(5, 4).Значение = 800);
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Готовая учебная таблица используется как источник блоков, не как рабочий макет конфигурации.
Начало/конец группы охватывают только строки 3–4. Итог 800 выведен вне группы, после ЗакончитьГруппуСтрок.
ИтогиСнизу управляет стороной маркера группировки, а не вычисляет сумму. Сумма рассчитана функцией заранее.
Как проверить результат
Две проверки дают Истина.
Сверните единственную группу слева: Книга и Ручка скрываются, строка Итого 800 остаётся видимой. Разверните обратно.
Ожидаемый результат
Одна явная группа деталей с независимой итоговой строкой.
На что обратить внимание
Не оставляйте группу незакрытой перед выводом итога.
Скрытие деталей не удаляет их значения и не уменьшает высоту области данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сгруппировать товарные строки и зафиксировать шапку при прокрутке
Группировка строк относится к представлению документа. Итог 800 расположен за пределами группы и остаётся видимым.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь приведённый модуль на уровне модуля формы: обработчик команды и функцию УчебнаяТаблица. Никакие макеты или реквизиты конфигурации не требуются.
Сохраните EPF и откройте в тонком клиенте Windows. Примеры показывают таблицу, но не вызывают принтер, не записывают файлы и не читают рабочие документы.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = УчебнаяТаблица();
ТоварныеСтроки = ТабДок.Область(3, , 4, );
ТоварныеСтроки.Сгруппировать("Учебные товары", РасположениеЗаголовкаГруппировкиТабличногоДокумента.Начало);
Сообщить(ТабДок.КоличествоУровнейГруппировокСтрок() = 1);
ТабДок.ПоказатьУровеньГруппировокСтрок(1);
ТабДок.ФиксацияСверху = 2;
ТабДок.ФиксацияСлева = 1;
ТабДок.ОтображатьЗаголовки = Истина;
ТабДок.ЦветТекстаЗаголовков = Новый Цвет(35, 45, 55);
ТабДок.ЦветФонаЗаголовков = Новый Цвет(235, 240, 245);
ТабДок.ЦветТекстаГруппировки = Новый Цвет(35, 45, 55);
ТабДок.ЦветФонаГруппировки = Новый Цвет(235, 240, 245);
ТабДок.ИтогиСнизу = Истина;
Сообщить(ТабДок.Область(5, 4).Значение = 800);
ТоварныеСтроки.Разгруппировать();
Сообщить(ТабДок.КоличествоУровнейГруппировокСтрок() = 0);
ТоварныеСтроки.Сгруппировать("Учебные товары", РасположениеЗаголовкаГруппировкиТабличногоДокумента.Начало);
ТабДок.Показать("Учебная таблица — без печати и сохранения");
КонецПроцедуры
&НаКлиенте
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Полная область строк 3–4 группируется, а не прямоугольник отдельных числовых ячеек.
РасположениеЗаголовка Начало устанавливает заголовок группы сверху.
ФиксацияСверху 2 удерживает заголовок/шапку, ФиксацияСлева 1 — колонку товара. Это не повторение на бумажных страницах.
Собственные цвета заголовков и группировки улучшают чтение; ИтогиСнизу задаёт расположение группировочных итогов.
Снимаем и возвращаем только свою группу для демонстрации. Данные и ручной итог не изменяются.
Как проверить результат
Три проверки Истина: один уровень, итог 800, после разгруппировки ноль уровней.
В конечном окне есть группа Учебные товары, итог в строке 5 вне неё.
Добавьте несколько своих учебных строк в копии урока, чтобы проверить фиксацию при прокрутке.
Ожидаемый результат
Группировка, её снятие и фиксация заголовка разобраны отдельно от расчёта данных.
На что обратить внимание
Сгруппировать не рассчитывает сумму автоматически; 800 вычислены в функции создания таблицы.
Фиксация на экране и повторение шапки при печати — разные настройки.
Снимать нужно собственную группу, не все группировки неизвестного макета.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.