МоиОтчеты Десктоп

Наши продукты постоянно развиваются, непрерывно добавляется новый функционал и улучается качество программного кода. В этой статье рассмотрим новые возможности редактор отчетов и не рассмотренные в руководстве пользователя.   Инспектор объектов Добавлена возможность помещать отдельные свойства в «Избранное». Для этого сфокусируйте курсор на инспекторе объектов и нажмите на клавишу CTRL. Рядом с именами свойств появятся чекбоксы, выберите необходимые вам свойства и добавьте их в список избранного. Удалять свойства можно таким же способом во вкладке «Избранное». События поместить в избранное нельзя. Теперь рядом со вкладками инспектора объектов расположено окно ввода для быстрого поиска свойств. Окно поиска может быть не видно, если у инспектора объектов малая ширина. При вводе данных в это окно инспектор начинает показывать только те свойства, которые содержат введенную строку. Инспектор выделяет значения свойств жирным стилем если те отличаются от значений по умолчанию. Это позволяет быстро находить свойства объекта, которые были изменены в процессе редактирования.  Примечание: не у всех свойств имеются значения по умолчанию, поэтому не все свойства могут быть подсвечены.      Дерево отчета В дерево отчетов также добавлен поиск компонентов по имени. Чтобы появилась строка поиска, то внутри дерева необходимо нажать на значок >>, расположенный справа внизу. Помимо этого, в дереве отчета можно выделять несколько элементов с использованием клавиши CTRL.  Дополнительно можно вызвать меню редактирования с помощью правой кнопки мыши – оно аналогично меню, которое вызывается при щелчке по компоненту. При выделении нескольких компонентов можно отредактировать их все одновременно. Например, скрыть их все с помощью свойства Visible, или, например удалить.     Дерево данных Интересной возможностью дерева данных является перетаскивание полей на рабочее поле дизайнера со вкладки «Поля БД». Если вы сделали активными кнопки «вставлять поле» или «вставлять заголовок» (кнопки F и C на изображении выше), то на рабочем поле дизайнера создастся frxMemoView либо с текстом заголовка из поля данных, либо привязанный к данным. В том случае, когда будут нажаты обе кнопки, то сгенерируются два TfrxMemoView - и с заголовком поля и привязанный к данным. Если данные берутся из TfrxDataSet, то в редакторе этого компонента (в самой IDE Delphi) можно настроить тип компонента, который создаётся при перетаскивании. Группы полей также можно перетаскивать. При этом, если вместе с полями выбрать и датасет, то создастся бэнд с данными полями. Если перетаскивается поле данных, то имя компонента составляется из имени датасета и имени поля данных. Помимо этого, можно перетащить поле данных и на существующий компонент. Тогда этот компонент привяжется к перетаскиваемому полю данных (предыдущее значение будет потеряно). Поле данных также можно перетащить в любое строковое свойство инспектора объектов. В дереве данных ещё есть 2 вкладки: «Функции» и «Классы», на которых отображаются все доступные в отчете классы и функции. Их также можно перетаскивать в дизайнер отчета.   Рабочее поле дизайнера Рабочее поле дизайнера обладает рядом интересных возможностей, облегчающих жизнь разработчика. На большинстве контролов, если у них есть обработчики событий, то в верхнем левом углу появляется маленький красный треугольник. Если на привязанном к датасету бэнде находится TfrxMemoView, то при наведении на него мышкой у него справа появляется треугольник (как у комбобокса). При нажатии на него можно привязать к TfrxMemoView поле из датасета бэнда. Если содержимое текстового компонента не полностью видно на экране (обрезано), то при наведении на такой компонент появляется подсказка с полным содержимым данного компонента. Эти подсказки можно убрать в настройках дизайнера, для этого перейдите в меню «Вид» -> «Настройки» и уберите галочку «Enable workspace hints».     Выносные линии Выносные линии – это набор вертикальных и горизонтальных линий для позиционирования вдоль них компонентов отчета. Управление видимостью выносных линий организовано с помощью подэлеменов меню «Вид».  «Выносные линии» – этот пункт меню разрешает использование выносных линий. Для создания выносной линии необходимо щелкнуть мышью 2 раза по линейке сверху или сбоку дизайнера. Выносные линии отображаются голубым цветом. «Автоматические выносные линии» – выносные линии появляются вдоль каждой границы компонента. Если выносная линия создана пользователем и не связана с границей компонента, то она исчезает, а если связана – то становится коричневого цвета. Создание пользовательских выносных линий в этом режиме невозможно.  «Использование горизонтальных и вертикальных выносных линий» – эти 2 пункта меню отвечают за видимость горизонтальных и вертикальных выносных линий. Также регулировать видимость выносных линий можно с помощью кнопки, находящейся на пересечении вертикальной и горизонтальной линеек, в верхнем левом углу поля редактирования дизайнера отчетов (скриншот ниже). Эта кнопка по кругу переключает режимы выносных линий в следующем порядке:-    без автоматических выносных линий;-    все автоматические выносные линии;-    горизонтальные автоматические выносные линии;-    вертикальные автоматические выносные линии. Для удаления пользовательской выносной линии достаточно переместить её за пределы области дизайнера или щёлкнуть правой кнопкой мыши по указателю выносной линии. В режиме автоматических выносных линий можно преобразовать эти линии в пользовательские, а затем вернуть обратно в автоматические. Для этого 2 раза нажмите по указателю выносной линии на линейке. Выносные линии применяются для расположения элементов отчета в нужном порядке. Главное свойство выносных линий – границы компонентов «прилипают» к выносным линиям при любом изменении размеров компонентов.  Помимо этого, при перетаскивании выносной линии вместе с ней перемещаются все «прилипшие» границы компонентов. Если противоположная граница компонента «прилипла» к другой выносной линии, то компонент изменяет свои размеры. Если противоположная граница компонента свободна, то компонент перемещается вслед за выносной линией, его размеры не меняются (каждую из настроек можно отключить в опциях дизайнера, например «Прилипать к выносным линям» и «Использовать выносные линии как якорь»).  Также выносные линии имеют способность «слипаться» между собой – если одну выносную линию переместить на другую, то они сольются. Таким образом с помощью выносных линий можно быстро выстроить компоненты отчета по пользовательской сетке. Данный функционал очень важен при экспорте отчета в некоторые форматы (например, в таблицу Excel), получение табличных отчетов без использования компонентов-сеток и так далее.     Дополнительные кнопки панели инструментов дизайнера На панель инструментов «Стандартная» добавлены 2 новые кнопки «Подсвечивать пересечение объектов» и «Поиск».  Первая кнопка переназначена для показа пересекающихся объектов, которые на изображении выше автоматически выделяются красным цветом. Сам цвет можно изменить в настройках редактора.  Вторая кнопка открывает окно поиска текста или его замены. В этом окне можно задать области поиска: искать в именах компонентов, в значениях строковых свойств, в содержимом, в тексте скрипта. Под содержимым понимается, например, значение свойства Memo компонента TfrxMemoView. Перейдем к настройкам поиска. Если активен чекбокс «Различать регистр», то будут различаться строчные и прописные буквы.  Если активен чекбокс «Искать все», то список найденного будет выведен на панели ниже, с пояснениями, какому элементу отчета принадлежит найденный текст. При щелчке мышью на любом элементе будет произведен переход к найденному элементу.  В ситуациях, когда чекбокс «Искать все» не активен, то по нажатию кнопки «Искать далее» (или клавиша F3 на клавиатуре) будет произведен переход к следующему найденному элементу. Переходы между элементами идут по вкладкам «Data», «Page», либо по «Code» в зависимости от активной вкладки. При наличии чекбокса на настройке «Заменить на» становится активным окно, в которое необходимо вписать новый текст для замены текущего. При этом надпись на кнопке «Искать текст» меняется на «Замена». Теперь при нажатии на кнопку «Замена» появляется диалог следующего вида: Этот диалог позволяет подтвердить или отменить замену текста. Данный функционал может понадобиться, например, при необходимости сменить один шрифт у всех компонентов на другой. Или, например, если вы переименовали датасет, который активно используется в скриптах. 

Под стилем (Style) в FastReport VCL понимается набор визуальных параметров компонента, а именно: шрифт, заливка, и рамка. Прямо в дизайнере отчетов вы можете создать стиль, который будет содержать только информацию о шрифте, либо только о рамке или заливке с рамкой. Вы можете одновременно использовать все эти параметры или чередовать в зависимости от ваших нужд. Стиль удобен для массового изменения внешнего вида компонентов. Это поможет при настройке нескольких параметров чтобы не выставлять одни и те же свойства вручную много раз. Также с помощью изменения параметров стиля можно быстро изменить внешний вид отчета. Готовую библиотеку стилей можно сохранить в отдельный файл, чтобы использовать для настройки нескольких отчетов. В FastReport VCL стили могут объединяться в «Страницу стилей (StyleSheet)». В совокупности набор страниц стилей называется «Таблица стилей» (или «Книга стилей»). Каждый стиль существует в каждой странице стилей. И в каждой странице стилей сам стиль может иметь разные параметры. При этом становится возможным быстро изменить настройки внешнего вида отчета, просто сменив текущую страницу стилей. Такое может быть полезно, например, если один и тот же отчет необходимо использовать в нескольких операционных системах с разными шрифтами. Тем самым необходимые стили устанавливаются просто переключением страницы стилей. Можно считать, что в FastReport VCL в каждом отчете имеется как минимум одна страница стилей с именем «По умолчанию» (Default).     Элементы управления стилями Для управления и работы со стилями и таблицами стилей имеется панель инструментов «Стили».   Управляет режимом использования таблиц стилей, содержит подменю с двумя элементами: «Designer style book» – разрешает использование таблиц стилей в дизайнере отчетов.«Preview Style book» – разрешает использование таблиц стилей в окне предварительного просмотра (изменение текущей таблицы стилей). Включает режим редактирования стилей непосредственно в отчете. Добавляет новую страницу стилей. Отвечает за выбор активной страницы стилей, а также за изменение имени страницы стиля. Удаляет текущую выбранную страницу стилей. Добавляет новый стиль. Позволяет выбрать стиль для текущего выделенного компонента, изменение имени текущего стиля. Удаление текущего стиля.   Также для редактирования и управления стилями можно использовать форму, которая доступна из меню «Отчет» -> «Стили». Кнопки тулбара этой формы имеют те же функции, что и на панели инструментов «Стили». Дополнительно можно сохранить и прочитать с диска таблицу стилей. Слева на форме расположен список стилей, доступных в отчете. При выборе любого стиля становится возможным редактирование его параметров. На панели ниже расположен образец применения стиля к элементу отчета. По центру на форме имеется 3 кнопки, с помощью которых можно отредактировать составляющие стиля. Рядом с кнопками расположены 3 чекбокса. В них можно указать содержит ли стиль тот или иной компонент – цвет фона, шрифт или рамку. Причем использование той или иной составляющей стиля одновременно разрешено или запрещено во всех страницах стилей.     Работа со стилями Для установки свойств стилей служит специальная форма, доступная из меню «Отчет –> Стили…» (скриншот выше). С помощью этой формы можно добавлять и удалять стили в отчет, переименовывать их, а также устанавливать их свойства. Также можно сохранять и загружать их из файлов стилей. Задать стиль выбранному компоненту отчета можно с помощью ComboBox на панели стилей, либо с помощью свойства «Style» в инспекторе объектов. Если задать для компонента отчета стиль под названием «Нет стиля» или удалить имя стиля в инспекторе объектов, то внешний вид компонента сохранится. Однако после этих действий данный компонент перестанет зависеть от стиля. Также можно перевести дизайнер отчетов в режим редактирования стилей с помощью кнопки на панели стилей (Edit Styles Mode).  В этом режиме становятся активными 2 кнопки по бокам ComboBox с именами стилей – можно добавлять и удалять стили с помощью них. При создании стиля с помощью кнопки на панели стилей, то такому стилю присваиваются свойства текущего выделенного компонента. При удалении стиля форматирование компонентов отчета сохраняется. Однако теперь форматирование будет храниться не в стиле, а в самом компоненте. Каждый пользователь имеет возможность редактировать стили непосредственно в отчете. Если отредактировать визуальные свойства элемента, которому назначен стиль, то фактически будут отредактированы свойства этого стиля. Такое поведение можно увидеть непосредственно в дизайнере. При изменении параметров одного компонента будут меняться все компоненты, имеющие данный стиль.      Работа с таблицами стилей Для работы с таблицами стилей сначала необходимо их включить. Это делается путем нажатия кнопки «Style Book Mode» и выбора режимов «Design Style Book» или «Preview Style Book». После этого становятся активными кнопки «Add Style Sheet», «Delete style Sheet» и ComboBox с именами таблиц стилей. Вы можете добавлять, удалять и переименовывать таблицы стилей, а также сделать какую-либо из них активной. При активации таблицы стилей все стили изменяют свое состояние на то, что хранится в текущей таблице стилей. При создании новой таблицы стилей данные для неё берутся из текущей активной таблицы стилей. При активной опции «Preview Style Book» изменение страниц стилей доступно в предварительном просмотре. Тогда у вас справа на панели инструментов появится ComboBox. В нем можно выбрать требуемую страницу стилей, и она немедленно применится к отчету.     Сохранение и чтение стилей Вернёмся в окно настройки стилей. В этом окне имеются кнопки «сохранить» и «прочитать». При нажатии на них вызываются диалоги чтения и записи файла, позволяющие сохранить и прочитать таблицу стилей в формате *.fs3. Независимо от режима работы со стилями, в файл записываются все таблицы стилей, которые находятся в отчете.  Как правило, конечный пользователь не должен редактировать отчет, у него есть только возможность предварительного просмотра. Поэтому программист должен уметь задавать текущий стиль отчета в коде приложения.  Это можно сделать так: begin  //загружаем отчет  frxReport1.LoadFromFile(DefPath+'main.fr3');  //загружаем стили  frxReport1.Styles.LoadFromFile(DefPath+'main.fs3');  //для управления таблицами стилей frxReport1.Styles.StyleBookMode не должно быть равно []  frxReport1.Styles.StyleBookMode:=[fsbDesigner];  //задаем стиль, который нам нужен  frxReport1.Styles.ActiveStyleSheet:='MyStyleSheet';  //применяем стиль к отчету  frxReport1.Styles.Apply;  frxReport1.ShowReport();end; Более подробно работа со стилями описана в руководстве программиста.     Таблицы стилей и условное форматирование Следует с осторожностью применять условное форматирование совместно с таблицами стилей. Если активен режим «Preview Style Book», то при изменении стиля условное форматирование теряется. Без проблем при этом можно менять те элементы форматирования, которые не используются стилем. Подведём итоги. Работать со стилями и со страницами стилей совсем не сложно. Данный функционал значительно упрощает и ускоряет построение отчетов. Это позволяет вам гораздо быстрее делать группы отчетов с одинаковым стилем оформления.

До обновления 2024.1 для добавления строки или столбца приходилось искать нужное свойство в панели свойств и задавать необходимое значение. А если строку или столбец хотелось вставить не в конец таблицы, то приходилось переносить все значения ячеек вручную. Ко всему прочему для переноса значений требовалось открыть редактор, скопировать значение и через такой же редактор другой ячейки его вставить. Для устранения этих проблем и упрощения работы с TableObject в дизайнере был добавлен ряд изменений. 1. Возможность добавлять столбцы и строки с помощью кнопок «+»; 2. Возможность копировать, вырезать, вставлять содержимое ячеек в другие ячейки с помощью сочетания клавиш; 3. Возможность добавлять строки сверху и снизу с помощью контекстного меню; 4. Возможность добавлять столбцы справа и слева с помощью контекстного меню; 5. Возможность устанавливать стили для группы ячеек через контекстное меню; Благодаря всем этим изменениям работа с таблицами в дизайнере стала гораздо проще.