5.11.2. Изображения ресурсов прикладного проекта

Application Server предоставляет API для работы с изображениями ресурсов прикладного проекта.

See also

Свойства в метаданных Postgres решения

Редакторы атрибута

Фреймы

Компоновщики

Перечисления

Свойства в GTK Core API

Редакторы атрибута

Фреймы

Компоновщики

Перечисления

5.11.2.1. Назначение

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

5.11.2.2. Хранение

Изображения располагаются внутри каталога КореньПроекта/Модуль/src/main/resources прикладного проекта.

5.11.2.3. Поддерживаемые форматы

  • .jpeg

  • .jpg

  • .png

  • .ico

  • .svg

5.11.2.4. Получение изображений

Доступ к изображениям ресурсов прикладного проекта осуществляется при помощи:

  1. EngineEndpoint.get_resource_image

  2. Сервис загрузки ресурсных файлов

5.11.2.5. Рекомендации

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

  • Не добавляйте такие изображения в коллекции изображений, если они не повторяются в интерфейсе и не имеют общего размера или тематики.

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

5.11.2.6. Использование в прикладном коде

В этом разделе описана спецификация работы с изображениями ресурсов прикладного проекта на уровне метаданных/API элементов интерфейса.

Краткое описание использования коллекций изображений в прикладном коде: Укажите путь до изображения относительно ресурсов прикладного проекта — см. Путь до изображения в ресурсах прикладного проекта.

5.11.2.6.1. Путь до изображения относительно ресурсов прикладного проекта

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

Attention

Если в метаданных/API одновременно указаны Номер изображения в коллекции изображений и Путь до изображения относительно ресурсов прикладного проекта, то будет выбрано изображение, которое хранится в ресурсах прикладного проекта.

В метаданных/API наименование свойства должно содержать imageUri.

Способы задания пути до изображения относительно ресурсов прикладного проекта:

  1. Прямое значение. В свойство записывается путь до изображения относительно ресурсов прикладного проекта.

  2. Ссылка на атрибут. В свойство записывается наименование атрибута, где хранится путь до изображения относительно ресурсов прикладного проекта.

Примеры значений: toolbarprimary/0.png, imagecollections/somecollection/0.svg.

Пример (Разметка закладки)
<tabItem id="0"
         selection="someselection"
         representation="somerepresentation"
         caption="Закладка 1"
         imageUri="toolbarprimary/0.png"/>