Простой дуговой индикатор

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

Простой дуговой индикатор выглядит следующим образом:

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

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

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

Значения данных

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

Список значений данных, которые указываются индикатором. Это индексированное свойство.

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

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

Фон

Фон индикатора (может быть сплошной цвет, линейный/радиальный градиент или текстура).

Поля фона индикатора:

Поле

Тип

Описание

Видимый

логическое

Флажок, определяющий, изображен ли фон.

Цвет

таблица данных

Цвет, используемый для заливки фона.

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

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

Рамка

Поля рамки индикатора:

Поле

Тип

Описание

Видимый

логическое

Флажок, определяющий, изображается ли рамка.

Цвет переднего фона

таблица данных

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

Стартовый угол

плавающее

Стартовый угол дуги, в градусах.

Размер

плавающее

Размер угла дуги, в градусах.

Внутренний радиус

плавающее

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

Внешний радиус

плавающее

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

Штрих

таблица данных

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

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

Тип свойства: 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

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

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