Перейти к основному содержимому

ВыводимаяОбластьТабличногоДокумента

Стд::ТабличныйДокумент::ВыводимаяОбластьТабличногоДокумента Доступность: Сервер

Сравнение ссылочное.

Иерархия типа​

Базовые типы: Объект

Примеры​

Вывод в табличный документ список контактов:

структура КонтактнаяИнформация
    знч ФИО: Строка
    знч Телефон: Строка
    знч ЭлектроннаяПочта: Строка
;

метод ПолучитьСписокКонтактнойИнформацииКакТабличныйДокумент(): ТабличныйДокумент
    знч ТабличныйДокумент = новый ТабличныйДокумент()
    знч Макет = ПолучитьМакетДляВыводаКонтактнойИнформации()
    знч ОбластьШапки = Макет.ПолучитьОбласть("ШапкаТаблицы")
 
    ТабличныйДокумент.Запись.ВывестиВертикально(ОбластьШапки)
 
    знч СписокКонтактнойИнформации = ПолучитьСписокКонтактнойИнформации()
    для КонтактнаяИнформация из СписокКонтактнойИнформации
        знч ОбластьСтроки = Макет.ПолучитьОбласть("СтрокаТаблицы")
        знч ВыводимаяОбласть = ОбластьСтроки.ВВыводимуюОбласть()
        ВыводимаяОбласть.ЗаполнитьПараметры(КонтактнаяИнформация)
         
        ТабличныйДокумент.Запись.ВывестиВертикально(ВыводимаяОбласть)      
    ;
 
    возврат ТабличныйДокумент
;

метод ПолучитьМакетДляВыводаКонтактнойИнформации(): ТабличныйДокумент
// .. получение макета, например, из ресурсов
;

метод ПолучитьСписокКонтактнойИнформации(): ЧитаемыйМассив<КонтактнаяИнформация>
// .. заполнение списка контактной информации
;

Выводимая область служит логическим объединением ячеек табличного документа. Одна и та же ячейка может входить во множество областей. В отличии от ОбластьТабличногоДокумента поддерживает заполнение параметров и данных рисунков.

Методы​

ЗаполнитьПараметры​

Доступность: Сервер

ЗаполнитьПараметры(Значение: Объект): ВыводимаяОбластьТабличногоДокумента
Заполняет параметры в выводимой области по произвольному объекту. Для заполнения могут быть использованы объекты:

  • ЧитаемоеСоответствие и его наследники;
  • Структуры;
  • любой объект, у которого могут быть свойства.

При отсутствии какого-либо параметра в выводимой области, исключение не будет выброшено, в отличии от методов УстановитьПараметры и УстановитьПараметр.

Обвести​

Доступность: Сервер

Обвести(
ГраницаСлева: ГраницаЯчейкиТабличногоДокумента?,
ГраницаСверху: ГраницаЯчейкиТабличногоДокумента?,
ГраницаСправа: ГраницаЯчейкиТабличногоДокумента?,
ГраницаСнизу: ГраницаЯчейкиТабличногоДокумента?
): ВыводимаяОбластьТабличногоДокумента
Обводит выводимую область рамкой с указанными границами.

  • ГраницаСлева - Задает границу слева. Если параметр не указан, граница слева не рисуется.
  • ГраницаСверху - Задает границу сверху. Если параметр не указан, граница сверху не рисуется.
  • ГраницаСправа - Задает границу справа. Если параметр не указан, граница справа не рисуется.
  • ГраницаСнизу - Задает границу снизу. Если параметр не указан, граница снизу не рисуется.
метод ОбвестиОбластьШтампа(ВыводимаяОбласть: ВыводимаяОбластьТабличногоДокумента)
    знч ГраницаРамки = новый ГраницаЯчейкиТабличногоДокумента(ВидГраницыЯчейкиТабличногоДокумента.Двойная, 1)
    ВыводимаяОбласть.Обвести(ГраницаРамки, ГраницаРамки, ГраницаРамки, ГраницаРамки)
;

УстановитьВыравниваниеПоВертикали​

Доступность: Сервер

УстановитьВыравниваниеПоВертикали(Выравнивание: ВыравниваниеПоВертикалиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает выравнивание по вертикали (по высоте) в выводимой области

ВыводимаяОбласть.УстановитьВыравниваниеПоГоризонтали(ВыравниваниеПоВертикалиТабличногоДокумента.Верх)

УстановитьВыравниваниеПоГоризонтали​

Доступность: Сервер

УстановитьВыравниваниеПоГоризонтали(Выравнивание: ВыравниваниеПоГоризонталиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает выравнивание текста по горизонтали (по ширине) в выводимой области.

ВыводимаяОбласть.УстановитьВыравниваниеПоГоризонтали(ВыравниваниеПоГоризонталиТабличногоДокумента.Центр)

УстановитьГраницуСверху​

Доступность: Сервер

УстановитьГраницуСверху(Граница: ГраницаЯчейкиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает границу области сверху.

УстановитьГраницуСлева​

Доступность: Сервер

УстановитьГраницуСлева(Граница: ГраницаЯчейкиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает границу области слева.

УстановитьГраницуСнизу​

Доступность: Сервер

УстановитьГраницуСнизу(Граница: ГраницаЯчейкиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает границу области снизу.

УстановитьГраницуСправа​

Доступность: Сервер

УстановитьГраницуСправа(Граница: ГраницаЯчейкиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает границу области справа.

УстановитьДанныеРисунков​

Доступность: Сервер

УстановитьДанныеРисунков(ДанныеРисунков: ЧитаемыйМассив<ДанныеВыводаРисункаТабличногоДокумента>): ВыводимаяОбластьТабличногоДокумента
Устанавливает данные рисунков в выводимой области.

УстановитьИзображение​

Доступность: Сервер

УстановитьИзображение(
Изображение: Байты?,
ПрозрачныйФон: Булево = Ложь
): ВыводимаяОбластьТабличногоДокумента
Устанавливает изображение в ячейки области.

Поддерживаются изображения следующих форматов:

  • BMP
  • EMF
  • GIF
  • Icon
  • JPEG
  • PNG
  • SVG
  • TIFF
  • WMF

УстановитьОриентациюТекста​

Доступность: Сервер

УстановитьОриентациюТекста(Угол: Число): ВыводимаяОбластьТабличногоДокумента
Устанавливает угол ориентации текста.

Если ячеек больше одной, то в каждую будет выставлен одинаковый угол.

УстановитьОтступСверху​

Доступность: Сервер

УстановитьОтступСверху(Отступ: Число): ВыводимаяОбластьТабличногоДокумента
Устанавливает отступ от верхней границы ячейки. В пунктах (1/72 дюйма).

УстановитьОтступСлева​

Доступность: Сервер

УстановитьОтступСлева(Отступ: Число): ВыводимаяОбластьТабличногоДокумента
Устанавливает отступ от левой границы ячейки. В пунктах (1/72 дюйма).

УстановитьОтступСнизу​

Доступность: Сервер

УстановитьОтступСнизу(Отступ: Число): ВыводимаяОбластьТабличногоДокумента
Устанавливает отступ от нижней границы ячейки. В пунктах (1/72 дюйма).

УстановитьОтступСправа​

Доступность: Сервер

УстановитьОтступСправа(Отступ: Число): ВыводимаяОбластьТабличногоДокумента
Устанавливает отступ от правой границы ячейки. В пунктах (1/72 дюйма).

УстановитьПараметр​

Доступность: Сервер

УстановитьПараметр(
ИмяПараметра: Строка,
Значение: Объект?
): ВыводимаяОбластьТабличногоДокумента
Устанавливает значение параметра в выводимую область.

  • ИмяПараметра - Имя параметра, для которого будет установлено значение.
  • Значение - Значение параметры. Для не примитивных типов будет использован результат выполнения ВСтроку.

Исключения​

null - если параметр не существует в параметрах выводимой области.

УстановитьПараметры​

Доступность: Сервер

УстановитьПараметры(Параметры: ЧитаемоеСоответствие<Строка, Объект?>): ВыводимаяОбластьТабличногоДокумента
Устанавливает параметры в выводимую область.

Исключения​

null - Если хотя бы один параметр отсутствует в параметрах выводимой области.

УстановитьПереносТекста​

Доступность: Сервер

УстановитьПереносТекста(ПереносТекста: ПереносТекстаТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает размещение (перенос) текста в ячейках выводимой области.

ВыводимаяОбласть.УстановитьПереносТекста(ПереносТекстаТабличногоДокумента.Переносить)

УстановитьТекст​

Доступность: Сервер

УстановитьТекст(
Текст: Строка,
Шаблон: Булево = Ложь
): ВыводимаяОбластьТабличногоДокумента
Устанавливает текст в ячейки области. Если признак шаблона Истина, то при выводе ячейки нужно будет передать шаблонные параметры. Шаблонные параметры в макете табличного документа выделяются квадратными скобками.

Если ячеек больше одной, то в каждую будет выставлен одинаковый текст.

Примеры​

// Заранее подготовленный макет, в котором в диапазоне "R1C1:R1C3" объединены ячейки.
пер Макет = ПолучитьМакетТабличногоДокумента()
пер ЗаголовокШапка = Макет.ПолучитьОбласть("R1C1:R1C3").ВВыводимуюОбласть()
ЗаголовокШапка.УстановитьТекст(Шапка.Текст + " от [ДатаФормирования]", Истина)
ЗаголовокШапка.УстановитьПараметр("ДатаФормирования", "10.11.2022")

УстановитьУзор​

Доступность: Сервер

УстановитьУзор(Узор: УзорТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает узор в ячейках области.

Если ячеек больше одной, то в каждую будет установлен одинаковый узор.

УстановитьЦветРамки​

Доступность: Сервер

УстановитьЦветРамки(Цвет: Цвет): ВыводимаяОбластьТабличногоДокумента
Устанавливает цвет рамки в ячейках области.

Если ячеек больше одной, то в каждую будет выставлен одинаковый цвет.

  • Цвет - Цвет рамки.

Исключения​

ИсключениеНедопустимыйАргумент - если будет передан НЕ абсолютный цвет.

УстановитьЦветРамкиПоУмолчанию​

Доступность: Сервер

УстановитьЦветРамкиПоУмолчанию(): ВыводимаяОбластьТабличногоДокумента
Устанавливает в каждую ячейку области цвет рамки по умолчанию.

УстановитьЦветТекста​

Доступность: Сервер

УстановитьЦветТекста(Цвет: Цвет): ВыводимаяОбластьТабличногоДокумента
Устанавливает цвет текста в ячейках области.

Если ячеек больше одной, то в каждую будет выставлен одинаковый цвет.

  • Цвет - Цвет текста.

Исключения​

ИсключениеНедопустимыйАргумент - Если будет передан НЕ абсолютный цвет.

УстановитьЦветТекстаПоУмолчанию​

Доступность: Сервер

УстановитьЦветТекстаПоУмолчанию(): ВыводимаяОбластьТабличногоДокумента
Устанавливает в каждую ячейку области цвет текста по умолчанию.

УстановитьЦветУзора​

Доступность: Сервер

УстановитьЦветУзора(Цвет: Цвет): ВыводимаяОбластьТабличногоДокумента
Устанавливает цвет узора в ячейках области.

Если ячеек больше одной, то в каждую будет выставлен одинаковый цвет.

  • Цвет - Цвет узора.

Исключения​

ИсключениеНедопустимыйАргумент - Если будет передан НЕ абсолютный цвет.

УстановитьЦветУзораПоУмолчанию​

Доступность: Сервер

УстановитьЦветУзораПоУмолчанию(): ВыводимаяОбластьТабличногоДокумента
Устанавливает в каждую ячейку области цвет узора по умолчанию.

УстановитьЦветФона​

Доступность: Сервер

УстановитьЦветФона(Цвет: Цвет): ВыводимаяОбластьТабличногоДокумента
Устанавливает цвет фона в ячейках области.

Если ячеек больше одной, то в каждую будет выставлен одинаковый цвет.

  • Цвет - Цвет фона.

Исключения​

ИсключениеНедопустимыйАргумент - Если будет передан НЕ абсолютный цвет.

УстановитьЦветФонаПоУмолчанию​

Доступность: Сервер

УстановитьЦветФонаПоУмолчанию(): ВыводимаяОбластьТабличногоДокумента
Устанавливает в каждую ячейку области цвет фона по умолчанию.

УстановитьШрифт​

Доступность: Сервер

УстановитьШрифт(Шрифт: ШрифтОбластиТабличногоДокумента): ВыводимаяОбластьТабличногоДокумента
Устанавливает шрифт в ячейках области.

Если ячеек больше одной, то в каждую будет выставлен одинаковый шрифт.

УстановитьШрифтПоУмолчанию​

Доступность: Сервер

УстановитьШрифтПоУмолчанию(): ВыводимаяОбластьТабличногоДокумента
Устанавливает в каждую ячейку области шрифт по умолчанию.

Список унаследованных методов​

Объект​

ВСтроку, ПолучитьТип, Представление

Последнее обновление