Векторное изображение

Данный компонент отображает рисунок в масштабируемой векторной графике (SVG).

Компонент "Векторное изображение" выглядит следующим образом:

Общие свойства

Ширина, Высота, Привязки, Видимый, Рамка, Курсор, Всплывающее меню

Пользовательские свойства

Файл SVG

(свойство по умолчанию)

Отображаемый файл SVG.

Имя свойства: drawing

Тип свойства: Data Block

Включить взаимодействия

Когда включены взаимодействия, то векторным рисунком в окне виджета можно управлять при помощи следующих сочетаний клавиш и мыши:

Сочетание

Значение

клавиша Ctrl + кнопка мыши button 1

Увеличить (приблизить область)

клавиша Shift + кнопка мыши button 2

Масштабировать

клавиша Shift + кнопка мыши button 1

Панорамирование

клавиша Ctrl + кнопка мыши button 2

Повернуть

клавиша Ctrl + клавиша Shift + кнопка мыши button 2

Сброс изменений

Анимационный

Свойство должно быть активировано для изображений, содержащих SVG анимацию.

Имя свойства: animated

Тип свойства: Boolean

Квадратное вращение

Вращает изображение на определенные углы: 0°, 90°, 180°, 270°. Значением является количество дуг в 90°, по которым происходит вращение. Если включено сохранить форматное соотношение и изображение находится в компоновке Абсолютное позиционирование, вращение происходит на 90° или 270° от ширины/высоты рамки компонента.

Имя свойства: quadrantRotation

Тип свойства: Integer

Когда квадратное вращение отличается от 0°, отключается и игнорируется свойство Вращение.

Перевернуть по горизонтали

Переворачивает рисунок по горизонтальной оси.

Имя свойства: flipHorizontal

Тип свойства: Boolean

Перевернуть по вертикали

Переворачивает рисунок по вертикальной оси.

Имя свойства: flipVertical

Тип свойства: Boolean

Масштаб

Коэффициент масштабирования. Значение 1.0 используется для отключения масштабирования.

Если масштабированный и повернутый рисунок не входит по размеру в компонент, он будет обрезан.

Имя свойства: scale

Тип свойства: Float

Вращение

Угол масштабирования, в градусах.

Если масштабированный и повернутый рисунок не подходит по размеру компоненту, он будет обрезан.

Имя свойства: rotation

Тип свойства: Float

Сохранить форматное соотношение

Включает/выключает сохранение форматного соотношения изображения. Если сохранение выключено, изображение растягивается, занимая все пространство компонента. Когда сохранение включено и изображение находится в компоновке Абсолютное позиционирование, границы компонента пропорционально меняют свой размер.

Имя свойства: preserveAspectRatio

Тип свойства: Boolean

Когда сохранение форматного соотношения выключено, также выключаются свойства Горизонтальное/Вертикальное выравнивание.

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

Выравнивание по горизонтали

Определяет выравнивание рисунка по горизонтали, когда область компонента шире рисунка:

Слева, По центру, Справа.

Имя свойства: horizontalAlignment

Тип свойства: String

Выравнивание по вертикали

Определяет выравнивание рисунка по вертикали, когда область компонента больше рисунка по высоте: Сверху, По центру, Снизу.

Имя свойства: verticalAlignment

Тип свойства: String

Максимизировать

Включает автоматическое увеличение изображения, чтобы отбросить его поля (пустое пространство вокруг изображения).

Когда Максимизировать проверено, включаются свойства Процент отступа X/Y. Настройка маленьких полей X/Y может использоваться для предотвращения обрезания краев, когда автоматически определяется размер изображения.

Имя свойства: maximize

Тип свойства: Boolean

Процент отступа по X

Отступ от границы X в виде процентного отношения к ширине рисунка. Включено при выборе свойства Растянуть.

Имя свойства: xMarginPercent

Тип свойства: Float

Процент отступа по Y

Отступ от границы Y в виде процентного отношения к высоте рисунка. Включено при выборе свойства Растянуть.

Имя свойства: yMarginPercent

Тип свойства: Float

Пользовательские свойства SVG

SVG рисунки, входящие в состав некоторых пакетов дистрибутива AggreGate, усовершенствованы для поддержки  дополнительных свойств. Компонент Векторное изображение извлекает эти свойства из SVG файлов и представляет их как "обычные" свойства компонента, позволяя редактировать их в Редакторе, управлять ими при помощи привязок виджета и др.

Пользовательские свойства видны в отдельной группе Свойства SVG. Типичными свойствами SVG являются:

  • Цвет заливки (например, цвета элементов)
  • Ширина и цвет штриха (например, штрихов контура)
  • Угол вращения (например, стрелки индикатора)
  • Триггер анимации (например, переключатели запуска/остановки вентилятора)
  • Позиции элементов (например, уровни резервуаров, позиции амортизаторов)
  • И многое другое (позиции кнопок и т.д.)

Общие события

Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса

Пользовательские события

Событие "щелчок мыши"

Это событие создается, когда кликнута кнопка мыши по элементу векторного изображения.

Имя события: elementMouseClicked

Поля события: Событие "щелчок мыши" имеет все поля стандартных событий мыши (исключая Идентификатор, Модификаторы, Нажатие Alt Graph, Расширенные модификаторы и Триггер всплывающего меню). Оно также определяет следующие поля:

Поле

Имя

Тип

Описание

Идентификатор

id

String

ID элемента векторного изображения.

Класс

class

String

Класс элемента векторного изображения.

Заголовок

title

String

Заголовок элемента векторного изображения.

Событие "курсор в области объекта"

Это событие создается, когда курсор мыши находится в области элемента векторного изображения.

Имя события: elementMouseEntered

Поля события: Событие "курсор мыши в области объекта" имеет все поля события "щелчок мыши.

Событие "курсор за пределами объекта"

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

Имя события: elementMouseExited

Поля события: Событие "курсор мыши покинул объект" имеет все поля события "щелчок мыши.