Простой индикатор
Этот компонент отображает простой индикатор с одним или несколькими указателями и шкалами. |
|
Простой индикатор выглядит следующим образом:
Общие свойства
Ширина, Высота, Привязки, Активный, Видимый, Граница, Курсор, Всплывающее меню
Пользовательские свойства
Значения данных
Список значений данных, которые указываются индикатором. Это индексированное свойство.
Имя свойства: datasets
Тип свойства: Data Table
Фон
Фон индикатора (может быть сплошной цвет, линейный/радиальный градиент или текстура).
Поля фона индикатора:
Поле | Тип | Описание |
Видимый | логическое | Флажок, определяющий, изображен ли фон. |
Цвет | таблица данных | Цвет, используемый для заливки фона. |
Имя свойства: gaugeBackground
Тип свойства: Data Table
Рамка
Свойства рамки кругового типа.
Поля рамки индикатора:
Поле | Тип | Описание |
Видимый | логическое | Флажок, определяющий, изображена ли шкала. |
Цвет фона | таблица данных | Цвет, используемый для заливки пространства между двойными линиями вокруг внешней границы круговой рамки. |
Цвет переднего фона | таблица данных | Цвет, используемый для изображения двойных линий вокруг внешней границы индикатора. |
Радиус | плавающее | Радиус, выраженный в виде процента, относящегося к треугольной рамке. |
Штрих | таблица данных | Штрих, используемый для изображения контура рамки. |
Имя свойства: frame
Тип свойства: Data Table
Обзор
Размеры поля построения индикатора рассчитываются относительно прямоугольной рамки, но в некоторых случаях требуется установить только подмножество поля в области построения. Параметр Обзор позволяет сделать это при помощи установки обозреваемого прямоугольника относительно прямоугольной рамки области построения.
Поля обзора:
Поле | Тип | Описание |
X | плавающее | Относительная позиция обзора x-координаты прямоугольника с ссылкой на прямоугольную рамку. Значение может варьироваться от 0.0 до 1.0. |
Y | плавающее | Относительная позиция обзора y-координаты прямоугольника с ссылкой на прямоугольную рамку. Значение может варьироваться от 0.0 до 1.0. |
Ширина | плавающее | Относительная ширина обозреваемого прямоугольника с ссылкой на прямоугольную рамку. Значение может варьироваться от 0.0 до 1.0. |
Высота | плавающее | Относительная высота обозреваемого прямоугольника с ссылкой на прямоугольную рамку. Значение может варьироваться от 0.0 до 1.0. |
Имя свойства: view
Тип свойства: Data Table
Крышка
Крышка индикатора. Это кружок в середине индикатора (к которому присоединяются указатели).
Поля крышки индикатора:
Поле | Тип | Описание |
Видимый | логическое | Флажок, определяющий, изображена ли крышка. |
Цвет заливки | таблица данных | Цвет заливки крышки. |
Цвет контура | таблица данных | Цвет контура крышки. |
Штрих контура | таблица данных | Штрих контура крышки. |
Радиус | плавающее | Радиус для крышки в виде процента от размера прямоугольной рамки индикатора. |
Имя свойства: cap
Тип свойства: Data Table
Шкалы
Таблица шкал индикатора и их ассоциации со значениями данных. Каждая запись имеет поле Индекс Значений Данных, которое определяет, какое значение данных обозначено на шкале.
Шкала может отображать основные и дополнительные деления с определенным пользователем интервалом и числовые значения для основных меток деления. Чтобы контролировать дугу, на которой изображена шкала, вы можете определить стартовый угол и диапазон (в градусах).
Поля таблицы шкал:
Поле | Тип | Описание |
Индекс значения данных | целое | Индекс значения данных, указанных на шкале. |
Шкала | таблица данных | Свойства шкалы. |
Поля шкалы индикатора:
Поле | Описание |
Видимый | Флажок, определяющий, отображена ли шкала. |
Нижняя граница | Нижняя граница шкалы. |
Верхняя граница | Верхняя граница шкалы. |
Стартовый угол | Угол (в градусах) стартовой точки шкалы. |
Диапазон | Диапазон (в градусах) шкалы. |
Радиус деления | Радиус деления определяет, насколько далеко на индикаторе изображены деления (обычно они появляются рядом с внешним краем индикатора, но для индикатора, который показывает больше одной шкалы, вы, наверняка, захотите поместить шкалу ближе к центру). Радиус деления определяет точки нахождения основных и дополнительных делений, равно как и метки основных делений. Он представляется в виде процента от прямоугольной рамки индикатора. |
Интервал основных делений | Интервал между основными делениями. |
Длина основных делений | Длина основных делений, выраженная в количестве, которое нужно вычесть из радиуса делений. |
Цвет основных делений | Цвет, используемый для изображения основных делений. |
Штрих основных делений | Штрих, используемый для изображения основных делений. |
Количество дополнительных делений | Количество дополнительных делений, изображаемое между основными делениями. |
Длина дополнительных делений | Длина дополнительных делений в виде радиуса, обозначенного процентом от прямоугольной рамки индикатора. |
Цвет дополнительных делений | Цвет, используемый для изображения дополнительных делений. |
Штрих дополнительных делений | Штрих, используемый для изображения дополнительных делений. |
Шрифт метки деления | Шрифт, используемый для изображения меток делений. |
Форматтер метки деления | Числовой форматтер, используемый для конвертирования значений меток делений в строки. |
Смещение метки деления | Точка привязки для каждой метки определяется использованием радиуса метки, настроенного при помощи значения смещения. Как только определяется точка привязки, метка значения центрируется на точке привязки. |
Цвет метки деления | Цвет, используемый для изображения меток деления. |
Видимая область меток деления | Флажок, определяющий, видимы ли метки деления. |
Видимая область метки первого деления | Флажок, определяющий, видима ли метка первого деления. |
Имя свойства: scales
Тип свойства: Data Table
Область значений
Область значений индикатора. Каждая область представлена в виде цветной дуги. Она используется для выделения области значений, например, “обычное”, “высокое” и “предельное”. Область значений в основном определяется ее нижними и верхними границами. Выделения области значений появляются на определенном радиусе в пределах индикатора.
Поля области значений:
Поле | Тип | Описание |
Видимый | логическое | Флажок, определяющий, изображается ли область значения. |
Индекс шкалы | целое | Область значений измеряется относительно шкалы со специальным индексом. |
Нижняя граница | плавающее | Нижняя граница области значений, в единицах данных. |
Верхняя граница | плавающее | Верхняя граница области значений, в единицах данных. |
Внутренний радиус | плавающее | Радиус внутренного выделения области значений в виде процента от размера прямоугольной рамки индикатора. |
Внешний радиус | плавающее | Радиус внешнего выделения области значений в виде процента от размера прямоугольной рамки индикатора. |
Цвет | таблица данных | Цвет, используемый для выделения области значений. |
Имя свойства: ranges
Тип свойства: Data Table
Обычные указатели
Список обычных указателей, имеющих длинную треугольную форму. Указатели используют для обозначения текущего значения на индикаторе.
Поля обычных указателей:
Поле | Тип | Описание |
Индекс значения данных | целое | Индекс значения данных, обозначенный указателем. |
Видимый | логическое | Флажок, определяющий, отображен ли указатель. |
Цвет заливки | таблица данных | Цвет указателя. |
Цвет контура | таблица данных | Цвет контура указателя. |
Радиус | плавающее | Длина указателя в виде процента от размера прямоугольной рамки индикатора. |
Ширина радиуса | плавающее | Ширина основания указателя определена как радиус в процентах относительно размера прямоугольной рамки индикатора. |
Имя свойства: normalPointers
Тип свойства: Data Table
Булавочные указатели
Список булавочных указателей. Булавочный указатель, изображенный как тонкая прямая линия. Указатели используются для указания текущего значения на индикаторе.
Поля булавочных указателей:
Поле | Тип | Описание |
Индекс значения данных | целое | Индекс значения данных, обозначенный указателем. |
Видимый | логическое | Флажок, определяющий, отображен ли указатель. |
Цвет | таблица данных | Цвет указателя. |
Радиус | плавающее | Длина указателя в виде процента от размера прямоугольной рамки индикатора. |
Штрих | таблица данных | Штрих, используемый для изображения указателя. |
Имя свойства: pinPointers
Тип свойства: Data Table
Индикаторы значений
Список индикаторо значений, показывающий текущие значения данных.
Поля индикатора значений:
Поле | Тип | Описание |
Индекс значения данных | целое | Индекс значения данных, изображаемый индикатором. |
Видимый | логическое | Флажок, определяющий, изображен ли индикатор. |
Угол | плавающее | Точка привязки для позиционирования индикатора определяется при помощи угла и радиуса. Данное свойство - это угол, в градусах, для расчета точки привязки. |
Радиус | плавающее | Радиус относительно прямоугольной рамки индикатора. |
Шрифт | таблица данных | Шрифт, используемый для изображения значения индикатора. |
Рамочная точка привязки | строка | Значение, которое индикатор отображает в виде текста в рамке. Точка привязки рамки определяет точку на рамке, которая будет выравнена относительно точки привязки (рассчитывается исходя из угла и радиуса). |
Отступы | таблица данных | Отступы (сверху, слева, снизу, справа), которые определяют размер белого пространства вокруг значения индикатора. |
Числовой формат | строка | Числовой форматтер, используемый для форматирования значения. |
Цвет контура | таблица данных | Цвет, используемый для отрисовки контура вокруг индикатора. |
Штрих контура | таблица данных | Штрих, используемый для отрисовки контура вокруг индикатора. |
Цвет | таблица данных | Цвет, используемый для отображения значения индикатора. |
Цвет фона | таблица данных | Цвет, используемый для заливки фона индикатора. |
Эталон значения | плавающее | Чтобы убедиться, что индикатор значения имеет фиксированную ширину независимо от текущего значения в пакете данных, используется эталонное значение для расчета размеров индикатора. Это эталонное значение форматируется с использованием текущего числового форматтера, затем используются размеры строки для определения размеров значения индикатора. |
Значение точки привязки | строка | Значение точки привязки определяет точку, относительно которой будет выравниваться текст значения. |
Текст точки привязки | строка | Точка текста, выравниваемая относительно точки привязки значения. |
Имя свойства: indicators
Тип свойства: Data Table
Текстовые аннотации
Список текстовых аннотаций. Текстовая аннотация - это строка текста, отображаемая в произвольной области индикатора.
Поля текстовой аннтоации:
Поле | Тип | Описание |
Метка | строка | Текст, отображаемый аннотацией. |
Видимый | логическое | Флажок, определяющий, отображена ли аннотация. |
Угол | плавающее | Точка привязки метки текста определяется углом и радиусом. Данное свойство - это угол (в градусах), который определяет точку привязки текста. |
Радиус | плавающее | Радиус, используемый для определения точки привязки текста в виде процента относительно прямоугольной рамки индикатора. |
Точка привязки | строка | Точка привязки определяет, как текст выравнивается относительно точки привязки. |
Цвет | таблица данных | Цвет метки. |
Шрифт | таблица данных | Шрифт метки. |
Имя свойства: annotations
Тип свойства: Data Table
Общие события
Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса