rzaripov.kz

Как использовать TStyleBook в FireMonkey для кастомизации UI

FireMonkey предоставляет единый визуальный слой для приложений под Windows, macOS, Linux, Android и iOS. Однако стандартные элементы управления не всегда соответствуют фирменному стилю проекта. Для изменения цветов, шрифтов, размеров и поведения визуальных компонентов в Delphi используется TStyleBook.

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

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

Подход Где хранится оформление Когда использовать Основной недостаток
Свойства компонентов В настройках каждого объекта Для небольших локальных изменений Настройки приходится повторять
TStyleBook В ресурсах формы или отдельном файле стиля Для единой темы приложения Требуется разобраться в структуре стиля
Пользовательские StyleLookup В именованных шаблонах Для отдельных вариантов компонентов Нужно поддерживать собственные шаблоны
Ручная композиция из TRectangle, TText и TLayout В визуальном дереве формы Для уникальных элементов интерфейса Сложнее обеспечить поведение обычного контрола

Роль TStyleBook в приложении

TStyleBook — это компонент FireMonkey, связывающий форму с визуальной темой. Его можно добавить на форму через палитру компонентов, после чего назначить ему файл стиля или отредактировать тему средствами среды Delphi. Если форма использует этот компонент, стандартные элементы получают ресурсы из подключённого набора.

Связь обычно задаётся через свойство StyleBook формы. В дизайнере Delphi достаточно выбрать нужный компонент в поле StyleBook. Программный вариант выглядит так:

begin
  Form1.StyleBook := StyleBook1;
end;

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

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

Подключение и загрузка файла стиля

Файл стиля можно загрузить во время выполнения с помощью метода LoadFromFile. Например:

procedure TMainForm.FormCreate(Sender: TObject);
begin
  StyleBook1.LoadFromFile(
    TPath.Combine(TPath.GetDocumentsPath, 'themes\dark.style')
  );
  StyleBook1.Active := True;
end;

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

При разработке в IDE проще открыть редактор стилей у TStyleBook, выбрать существующую тему и сохранить её в проекте. После этого можно назначить компонент форме на этапе проектирования и сразу видеть результат в дизайнере. Если тема поставляется отдельно, следует проверить, что она добавлена в deployment для Windows, macOS, Android и iOS.

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

Настройка цветов, шрифтов и размеров

Изменение визуальных параметров выполняется через редактор стилей. Внутри темы находятся ресурсы, связанные с конкретными контролами: фоновая заливка, текст, рамка, тени, маркеры состояния и вспомогательные элементы. Например, шаблон кнопки может содержать TRectangle для фона, TText для надписи и несколько объектов для состояний нажатия и фокуса.

У компонентов есть свойства, которые можно изменить непосредственно:

Button1.Text := 'Сохранить';
Button1.TextSettings.Font.Size := 16;
Button1.TextSettings.Font.Style := [TFontStyle.fsBold];
Button1.TextSettings.FontColor := TAlphaColorRec.White;

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

При проектировании интерфейса стоит учитывать масштабирование FireMonkey. Размеры элементов желательно задавать с учётом TTextSettings, выравнивания и автоматического расчёта текста. Слишком жёсткие координаты могут хорошо выглядеть в окне Windows, но привести к обрезанию надписей на Android или при увеличенном системном шрифте.

Использование StyleLookup и шаблонов

Свойство StyleLookup позволяет выбрать именованный шаблон из текущей темы. Это один из главных механизмов кастомизации FireMonkey. Например, для кнопки можно указать имя собственного варианта:

Button1.StyleLookup := 'accentbuttonstyle';

Имя должно существовать в подключённом стиле. Если ресурс не найден, компонент обычно использует стандартный шаблон или отображается без ожидаемых визуальных изменений. Поэтому после изменения StyleLookup важно проверить наличие ресурса и корректность написания имени.

Пользовательский шаблон создаётся в редакторе стилей на основе существующего элемента. Внутри него можно изменить фон, скругление углов, толщину рамки, прозрачность, значок и оформление текста. Для состояний Normal, Pressed, Focused, Disabled и MouseOver применяются отдельные значения или триггеры.

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

Состояния элементов и интерактивность

Хорошая тема должна описывать не только внешний вид контрола в спокойном состоянии. Пользователь должен видеть, что кнопка доступна, нажата, получает фокус или недоступна. В FireMonkey эти изменения обычно реализуются через визуальные состояния и триггеры внутри стиля.

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

Не следует полагаться только на цвет. Ошибки, фокус и выбранные пункты желательно обозначать также рамкой, значком, изменением текста или положением индикатора. Это повышает доступность интерфейса и делает его понятнее для пользователей с нарушениями восприятия цвета.

При проверке стиля нужно тестировать реальные сценарии: быстрые повторные нажатия, отключение контрола во время операции, смену ориентации экрана и изменение масштаба окна. Внешне корректный шаблон может вести себя неожиданно, если его внутренние объекты не поддерживают нужные состояния.

Собственные компоненты и переиспользование темы

Для сложных элементов можно создать отдельный пользовательский компонент на базе TLayout, TControl или другого подходящего класса. Его внешний вид строится из стандартных объектов FireMonkey: TRectangle, TText, TImage, TPath и вложенных контейнеров. Такой компонент может использовать свойства темы, но его уникальная композиция остаётся под контролем разработчика.

Если элемент должен поддерживать механизм StyleLookup, для него создают стиль с согласованной структурой ресурсов. Логика компонента получает дочерние объекты по именам, а визуальная часть меняется через файл темы. Это позволяет выпускать светлую и тёмную версии без дублирования программного кода.

В крупном проекте полезно договориться о системе имён: например, использовать префиксы для кнопок, полей и навигации. Отдельно стоит хранить базовые цвета, размеры отступов и типографику. Единые правила уменьшают риск, что разные разработчики создадут несколько почти одинаковых ресурсов с разными названиями.

При обновлении Delphi или переносе приложения на другую платформу тему нужно проверять заново. Некоторые системные шрифты, эффекты прозрачности и аппаратное ускорение могут выглядеть по-разному. Для стабильного результата лучше избегать чрезмерно сложных эффектов, тестировать производительность на мобильных устройствах и сохранять резервную копию рабочих файлов стилей.

Практические рекомендации для проекта

Сначала стоит определить визуальные правила приложения: основные цвета, контраст, размеры текста, радиусы скругления и состояния элементов. После этого создаётся базовая тема, а уже затем — отдельные шаблоны для акцентных компонентов. Такой порядок помогает избежать хаотичной настройки форм.

Для часто используемых элементов лучше применять StyleLookup, а уникальные панели и карточки собирать из обычных FireMonkey-компонентов. Локальные свойства подходят для исключений, но чрезмерное количество индивидуальных настроек постепенно разрушает целостность интерфейса.

Не следует загружать тяжёлые изображения и сложные эффекты в каждый шаблон. Большие растровые ресурсы увеличивают размер приложения и могут замедлить отрисовку на Android или недорогих устройствах. Для простых фонов чаще достаточно фигур, градиентов и прозрачности.

TStyleBook раскрывает свои возможности, когда тема рассматривается как самостоятельный слой приложения. Централизованные ресурсы, именованные шаблоны, корректные состояния и проверка на всех целевых операционных системах позволяют получить единый UI для Delphi-проектов под Windows, macOS, Linux, Android и iOS.