Руководство разработчика

Объединение и заполнение ячеек данными

Прежде чем заполнять отчет данными, необходимо добавить в отчет строки. Когда отчет еще пустой и в нем нет строк, добавление строк осуществляется в конец отчета методом ДОБАВИТЬ_СТРОКУ, если в отчете присутствует хотя бы одна строка можно воспользоваться методом ВСТАВИТЬ_СТРОКУ.

Далее заполнение ячеек происходит при помощи методов ЯЧЕЙКА и ЯЧЕЙКА_ПОЗ. Стоит отметить, что метод ЯЧЕЙКА_ПОЗ более оптимальный вариант для заполнения, так как он использует координаты ячейки, а не имя столбца, также данный метод используется только для видимых столбцов. В ячейках могут содержаться значения стандартных типов: ЧИСЛО, ЦЕЛОЕ, СТРОКА, ДАТА, ВРЕМЯ. При необходимости можно изменить формат отображения содержимого ячейки и строки. Это осуществляется при помощи метода УСТ_ФОРМАТ_ЯЧЕЙКИ и УСТ_ФОРМАТ_СТРОКИ , а также функций и объектных типов модуля FORMAT.

Отображение в ячейках отрицательных чисел можно настраивать. Если в поле подсветка_отрицательных объектного типа ОТЧЕТ установить значение ДА, то отрицательные числа отображаются красным цветом.

Также строковые данные, отображающиеся в ячейках таблицы, можно отформатировать при помощи тэгов форматирования. Тэги форматирования указываются непосредственно в строке значения ячейки.

Для того чтобы создать многоуровневый заголовок таблицы, используется метод ОБЪЕДИНИТЬ_СТОЛБЦЫ. А для объединения произвольных ячеек отчета используется метод ОБЪЕДИНИТЬ_ЯЧЕЙКИ.

Пример

Пример иллюстрирует функцию, которая осуществляет добавление 10 строк в отчет, заполнение ячеек.

  ФУНКЦИЯ Заполнение
    //создание многоуровнего заголовка 
    ОБЪЕДИНИТЬ_СТОЛБЦЫ("цена", "цена_проп", "ЦЕНА")
    ПЕРЕМ ЦЕЛОЕ: счетчик = 1
    ПЕРЕМ ДАТА: начало = 01.01.2017;
    ЦИКЛ ПОКА(счетчик <= 10)
	    //добавление строки
    	номер_стр = ДОБАВИТЬ_СТРОКУ("строка" + СТР(счетчик))
    	ПЕРЕМ ЦЕЛОЕ: зн = СЛУЧ_ЧИСЛО(2000)
		//задание формата отображения
    	ПЕРЕМ ФОРМАТ_ДАТЫ: формат = [маска = "dd.mm.yyyy",
        разделитель = "/"]
		//установка формата отображения значению
    	ПЕРЕМ СТРОКА: стр = ФОРМАТ_Д(начало, формат)
		//заполнение ячеек данными
    	ЯЧЕЙКА("номер", счетчик, счетчик)
    	ЯЧЕЙКА("наим", счетчик, "ТОВАР "+ СТР(счетчик))
    	ЯЧЕЙКА("ед_из", счетчик, "шт")
    	ЯЧЕЙКА("цена", счетчик, зн)
    	ЯЧЕЙКА("цена_проп", счетчик, СУММАП(зн))
    	ЯЧЕЙКА("дата", счетчик, стр)
    	ЕСЛИ счетчик > 3 ТО
    	  начало += 2
    	КОНЕЦ_ЕСЛИ
    	Поиск_Сортировка(номер_стр)
    	счетчик++
    КОНЕЦ_ЦИКЛА
	//объединение первых трех ячеек в столбце "дата"
    ОБЪЕДИНИТЬ_ЯЧЕЙКИ("дата", "дата", 1, 3)
  КОНЕЦ_ФУНКЦИИ

См. также: