ТабличныйДокумент.НачатьГруппуСтрок

Методы · StartRowGroup

Начинает новую группу строк. Можно создавать вложенные группы строк.

Синтаксис

НачатьГруппуСтрок(<ИмяГруппы>, <ОткрытаЛиГруппа>)

Примеры платформы

ТабДок = Новый ТабличныйДокумент;
Секция = ТабДок.ПолучитьОбласть("R1");
Секция.Область("R1C1").Текст = "Численность сотрудников";
ТабДок.Вывести(Секция);
ТабДок.НачатьГруппуСтрок("По всем подразделениям", Истина);
Всего = 0;
Для Н=1 По 3 Цикл
    Значение = Н; Итог = 0;
    Секция.Область("R1C1").Текст = "Отдел "+Н;
    Секция.Область("R1C2").Текст = "";
    ТабДок.Вывести(Секция);
    ТабДок.НачатьГруппуСтрок("Отдел"+Н, Истина);
    Секция.Область("R1C1").Текст = "Группа";
    Секция.Область("R1C2").Текст = "Численность";
    Секция.Область("R1C2").ГоризонтальноеПоложение =
        ГоризонтальноеПоложение.Авто;
    ТабДок.Вывести(Секция);
    ТабДок.НачатьГруппуСтрок("Группа "+Н, Истина);
    Для К=1 По 4 Цикл
        Секция.Область("R1C1").Текст = "А"+Н+К;
        Секция.Область("R1C2").Текст = Значение;
        ТабДок.Вывести(Секция);
        Итог = Итог + Значение;
        Значение = Значение + 10;
    КонецЦикла;
    ТабДок.ЗакончитьГруппуСтрок();
    ТабДок.ЗакончитьГруппуСтрок();
    Секция.Область("R1C1").Текст = "Итого"+Н;
    Секция.Область("R1C2").Текст = Итог;
    ТабДок.Вывести(Секция);
    Секция.Область("R1C1:R1C2").Текст = "";
    ТабДок.Вывести(Секция);
    Всего = Всего + Итог;
КонецЦикла;
ТабДок.ЗакончитьГруппуСтрок();
Секция.Область("R1C1").Текст = "Всего:";
Секция.Область("R1C2").Текст = Всего;
ТабДок.Вывести(Секция);
ТабДок.ИтогиСнизу = Ложь;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода НачатьГруппуСтрок");
Полное описание, параметры и ограничения

ТабличныйДокумент.НачатьГруппуСтрок (SpreadsheetDocument.StartRowGroup)

ТабличныйДокумент (SpreadsheetDocument)

НачатьГруппуСтрок (StartRowGroup)

Доступен, начиная с версии 8.0.

Синтаксис:
НачатьГруппуСтрок(<ИмяГруппы>, <ОткрытаЛиГруппа>)
Параметры:

<ИмяГруппы> (необязательный)
Тип: Строка.
Название группы.

<ОткрытаЛиГруппа> (необязательный)
Тип: Булево.
Определяет необходимость открытия группы. Истина - выведенная группа будет открыта; Ложь - группа будет выведена в свернутом виде.
Значение по умолчанию: Истина.
Описание:

Начинает новую группу строк. Можно создавать вложенные группы строк.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Пример:

ТабДок = Новый ТабличныйДокумент;
Секция = ТабДок.ПолучитьОбласть("R1");
Секция.Область("R1C1").Текст = "Численность сотрудников";
ТабДок.Вывести(Секция);
ТабДок.НачатьГруппуСтрок("По всем подразделениям", Истина);
Всего = 0;
Для Н=1 По 3 Цикл
Значение = Н; Итог = 0;
Секция.Область("R1C1").Текст = "Отдел "+Н;
Секция.Область("R1C2").Текст = "";
ТабДок.Вывести(Секция);
ТабДок.НачатьГруппуСтрок("Отдел"+Н, Истина);
Секция.Область("R1C1").Текст = "Группа";
Секция.Область("R1C2").Текст = "Численность";
Секция.Область("R1C2").ГоризонтальноеПоложение =
ГоризонтальноеПоложение.Авто;
ТабДок.Вывести(Секция);
ТабДок.НачатьГруппуСтрок("Группа "+Н, Истина);
Для К=1 По 4 Цикл
Секция.Область("R1C1").Текст = "А"+Н+К;
Секция.Область("R1C2").Текст = Значение;
ТабДок.Вывести(Секция);
Итог = Итог + Значение;
Значение = Значение + 10;
КонецЦикла;
ТабДок.ЗакончитьГруппуСтрок(); // окончить группу "Группа"

ТабДок.ЗакончитьГруппуСтрок(); // окончить группу "Отдел"

Секция.Область("R1C1").Текст = "Итого"+Н;
Секция.Область("R1C2").Текст = Итог;
ТабДок.Вывести(Секция);
Секция.Область("R1C1:R1C2").Текст = "";
ТабДок.Вывести(Секция);
Всего = Всего + Итог;
КонецЦикла;
ТабДок.ЗакончитьГруппуСтрок(); // окончить группу "По всем отделам"

Секция.Область("R1C1").Текст = "Всего:";
Секция.Область("R1C2").Текст = Всего;
ТабДок.Вывести(Секция);
ТабДок.ИтогиСнизу = Ложь;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода НачатьГруппуСтрок");

См. также:
ТабличныйДокумент, метод ЗакончитьГруппуСтрок

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Свернуть товарные строки, оставив общий итог снаружи

Граница группы определяется моментами вывода. Две строки товаров выводим между НачатьГруппуСтрок и ЗакончитьГруппуСтрок; итог — после закрытия.

Где и как запускать

Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.

Подготовка

  1. Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.

  2. На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).

  3. Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.

  4. Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.

  5. Показ и ручную проверку выполняйте в тонком клиенте 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, Ложь);
    Все.Обвести(Граница, Граница, Граница, Граница);
    Возврат ТабДок;
КонецФункции

Разбор по шагам

  1. Готовая учебная таблица используется как источник блоков, не как рабочий макет конфигурации.

  2. Начало/конец группы охватывают только строки 3–4. Итог 800 выведен вне группы, после ЗакончитьГруппуСтрок.

  3. ИтогиСнизу управляет стороной маркера группировки, а не вычисляет сумму. Сумма рассчитана функцией заранее.

Как проверить результат

  1. Две проверки дают Истина.

  2. Сверните единственную группу слева: Книга и Ручка скрываются, строка Итого 800 остаётся видимой. Разверните обратно.

Ожидаемый результат

Одна явная группа деталей с независимой итоговой строкой.

На что обратить внимание

  1. Не оставляйте группу незакрытой перед выводом итога.

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

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.