TechEditor дозволяє відображати на аркушах звіту різні графічні елементи — лінії, прямокутники, текст, зовнішні зображення, тощо. Це реалізується за допомогою скриптових команд. Таким чином, ви можете надавати кожному аркушу індивідуального оформлення.

Запуск редактора

Щоб почати роботу, скористайтеся командою Drawing Automation на стрічці інструментів Report | Insert > Background and Graphics. Відкриється редактор скрипта:

Вкладка Script є основною; в ній розміщуються скриптові команди для рисування. На вкладці Presets & Examples ви знайдете готові приклади скриптів, які достатньо скопіювати в поле Script і натиснути кнопку Execute. Після виконання скрипта ви побачите результат у своєму звіті.

Команди для рисування

TechEditor дозволяє наступні операції з графікою:

• рисування примітивів, як-от лінія, прямокутник, коло;
• нанесення текстових написів, в тому числі вертикальних або під кутом;
• відображення рисунків з зовнішніх файлів;

Для всіх графічних примітивів можна налаштувати колір, товщину лінії, шрифт та інші атрибути. Команди розміщуються в редакторі за загальними правилами мови програмування Object Pascal: команди, записані вище, впливають на команди, що розташовані нижче. Отже, якщо ви призначили колір лінії, то всі графічні елементи, які ви додасте нижче в скрипті, матимуть цей колір.

Наступний приклад демонструє, як нарисувати рамку на аркуші формату А4 з відступами 20 мм з лівого боку і по 5 мм з інших боків (цей скрипт можна скопіювати нижче, див. Приклад 1):

Повний перелік скриптових команд для звітів дивіться тут.

Позиціювання на аркуші

Всі графічні елементи розміщуються на аркуші у вигляді фону, тобто під основним текстом. Ви можете набирати текст, формули, таблиці в звичайному режимі — всі ці "текстові" об'єкти відображаються над графічними елементами. Навіть рисунки, які ви додаєте до звіту традиційним способом (наприклад, через Copy/Paste), будуть відображені над тим, що було нарисовано засобами автоматизації. Таким чином, автоматизацію рисування логічно використовувати перш за все як інструмент для створення фонових зображень, рамок, основних написів та інших аналогічних об'єктів. Ці графічні об'єкти не залежать від абзаців тексту чи полів документу, а отже не рухаються разом з ними.

Система координат і розміри аркушу

Початок системи координат (0,0) знаходиться в лівому верхньому куті аркушу:

Осі системи координат X, Y направлені праворуч та донизу, відповідно. За стандартними налаштуваннями, розміри полотна для рисування співпадають з розміром аркушу A4 (297x210 мм). Але ви можете змінити розміри цього полотна, якщо потрібно оперувати іншою прямокутною зоною.

Команди для рисування

Перелік скриптових команд для рисування у звітах:

• бібліотека Report
• усі команди

Приклади

uses Classes, Graphics, Dialogs;
begin
  Report.PageNo := 0;
  Report.DrawRectangle(20, 5, 210-5, 297-5);
end.

uses Classes, Graphics, Dialogs;
begin
  Report.PageNo := 1;
  Report.PenColor := clRed;
  Report.PenWidth := 2;
  Report.DrawLine(0, 0, 25, 25);
end.

uses Classes, Graphics, Dialogs;
var
  Page: Integer;
begin
  for Page := 4 to 8 do
    begin
      Report.PageNo := Page;
      Report.DrawPicture(50, 50, 'C:\image1.png');
    end;
end.

uses Classes, Graphics, Dialogs;
begin
  Report.PageNo := 1;
  Report.DrawFitPagePicture('C:\image1.png');
end.