Speedometer: компонент

Описание

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

Комментарии

Компонент Speedometer  реализован с помощью класса Speedometer.

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

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

 На всех диаграммах определяется минимальное и максимальное значения (нижняя граница, верхняя граница).

 Можно задать цвета диапазонов, чтобы классифицировать данные. Например, можно задать диапазон с названием «Best» , который состоит из значений между 60 и 100 и определить свой цвет, что поможет визуально отличить его от других.

Пример

 Варианты представления спидометров показаны на рисунке:

Компонент может быть представлен в виде датчика топлива:

Пример создания спидометра показан на странице «Пример создания датчика топлива».

Вариант представления спидометра в виде стрелочных часов:

Пример создания показан на странице «Пример создания стрелочных часов».

Пример создания спидометра с мастером

Конструктор

  Имя конструктора Краткое описание
Speedometer Конструктор Speedometer создает экземпляр компонента Speedometer.

Свойства

  Имя свойства Краткое описание
Background Свойство Background определяет кисть для заливки фона спидометра.
BaseHeight Свойство BaseHeight определяет базовую высоту спидометра.
BaseWidth Свойство BaseWidth определяет базовую ширину спидометра.
Borders Свойство Borders определяет массив из элементов, задающих параметры отрисовки спидометра.
BorderStyle Свойство BorderStyle определяет стиль границ спидометра.
Center Свойство Center определяет маркер для отрисовки центра спидометра.
CenterLabel Свойство CenterLabel определяет центральную текстовую метку спидометра.
CenterPosition Свойство CenterPosition определяет координаты центра спидометра.
Markers Свойство Markers определяет массив из элементов, задающих параметры отрисовки маркеров спидометра.
NumberFormat Свойство NumberFormat определяет формат данных спидометра.
OuterRadius Свойство OuterRadius определяет радиус спидометра.
Padding Свойство Padding определяет отступы компонента.
Scales Свойство Scales определяет массив элементов, задающих параметры отрисовки шкалы спидометра.
TimeLineStep Свойство TimeLineStep определяет текущий шаг временной шкалы.

Методы

  Имя метода Краткое описание
calcCenterPosition Метод calcCenterPosition вычисляет координаты центра спидометра.
calcOuterRadius Метод calcOuterRadius вычисляет радиус спидометра, если он не задан относительно размеров контейнера.
getArrowById Метод getArrowById возвращает указатель по его идентификатору.
getChildren Метод getChildren возвращает массив дочерних элементов спидометра.
getInstance Метод getInstance возвращает экземпляр текущего спидометра.
getOpacityEnabled Метод getOpacityEnabled возвращает признак использования прозрачности спидометром.
getState Метод getState возвращает настройки шкалы спидометра.
getSVGNode Метод getSVGNode возвращает SVG-элемент, предназначенный для отрисовки спидометра.
paint Метод paint раскрашивает фон и границу SVG-элемента соответственно установкам.
redraw Метод redraw перерисовывает спидометр.
redrawScales Метод redrawScales перерисовывает все шкалы спидометра.
refreshView Метод refreshView обновляет представление спидометра, основываясь на указанных настройках.
setMasterSettings Метод setMasterSettings применяет указанные настройки спидометра.

События

   Имя события Краткое описание
Loaded Событие Loaded наступает после загрузки спидометра.
Refreshed Событие Refreshed наступает после обновления представления спидометра.

Свойства, унаследованные от класса GaugeObject

  Имя свойства Краткое описание
Background Свойство Background определяет кисть для заливки фона элемента.
Border Свойство Border определяет кисть для отрисовки границ элемента.
BorderEnabled Свойство BorderEnabled определяет наличие границы элемента спидометра.
BorderStyle Свойство BorderStyle определяет стиль отрисовки границ элемента.
BorderWidth Свойство BorderWidth определяет толщину границ элемента.
MajorArrow Свойство MajorArrow определяет основной указатель для шкалы спидометра.
Name Свойство Name определяет наименование указателя для шкалы спидометра.
OpacityEnabled Свойство OpacityEnabled определяет признак использования настроек прозрачности элемента.
Shadow Свойство Shadow определяет тень для элемента.

Методы, унаследованные от класса GaugeObject

  Имя метода Краткое описание
calcOffset Метод calcOffset вычисляет смещение по радиусу от центра шкалы.
calcSize Метод calcSize вычисляет размер маркера.

Свойства, унаследованные от класса Control

  Имя свойства Краткое описание
Anchors Свойство Anchors определяет позицию компонента, размещенного внутри контейнера.
Animation Свойство Animation определяет параметры анимации для компонента.
Bottom Свойство Bottom определяет отступ снизу при размещении компонента внутри LayoutPanel.
Content Свойство Content определяет содержимое компонента.
ContextMenu Свойство ContextMenu определяет контекстное меню для компонента.
Data Свойство Data предназначено для хранения любых пользовательских данных.
Enabled Свойство Enabled определяет признак доступности компонента для использования.
Height Свойство Height определяет высоту компонента.
IsRTL Свойство IsRTL определяет признак расположения элементов компонента по правому краю.
IsVisible Свойство IsVisible определяет признак отображения компонента.
Left Свойство Left определяет отступ слева при размещении компонента внутри GridPanel.
Opacity Свойство Opacity определяет прозрачность компонента.
Parent Свойство Parent определяет родительский компонент элемента управления.
ParentNode Свойство ParentNode определяет родительскую DOM-вершину.
ResourceKey Свойство ResourceKey определяет ресурсный ключ для компонента.
Right Свойство Right определяет отступ справа при размещении компонента внутри LayoutPanel.
Rotate Свойство Rotate определяет угол поворота компонента.
ShowToolTip Свойство ShowToolTip определяет признак возможности отображения всплывающей подсказки компонента.
Style Свойство Style определяет стиль для компонента.
TabIndex Свойство TabIndex определяет последовательность перехода элемента управления внутри контейнера.
Tag Свойство Tag определяет JSON-объект, ассоциированный с компонентом.
ToolTip Свойство ToolTip определяет текст всплывающей подсказки компонента.
Top Свойство Top определяет отступ сверху при размещении компонента внутри GridPanel.
Value Свойство Value определяет значение компонента.
Width Свойство Width определяет ширину компонента.

Методы, унаследованные от класса Control

  Имя метода Краткое описание

addClass

Метод addClass добавляет CSS-класс к компоненту.
addEventHandler Метод addEventHandler добавляет обработчик события на DOM-вершину.

addStateClass

Метод addStateClass добавляет CSS-класс к компоненту и удаляет прежний CSS-класс.

addToNode

Метод addToNode добавляет компонент в указанную вершину.
bindEvents Метод bindEvents подписывает элемент на все стандартные события.

getAnchorFlags

Метод getAnchorFlags возвращает JSON-объект с настройками текущей позиции компонента.

getClass

Метод getClass возвращает текущие css-классы компонента.

getCssStyle

Метод getCssStyle возвращает стили для указанной вершины.

getDomNode

Метод getDomNode возвращает главную DOM-вершину компонента.

getFocused

Метод getFocused определяет наличие фокуса у компонента.
getIsBinded Метод getIsBinded возвращает признак подписи элемента на события DOM-вершины.

hide

Метод hide скрывает элемент управления.

hideToolTip

Метод hideToolTip очищает таймаут появления подсказки и скрывает её, если она был показана.
refreshStyle Метод refreshStyle обновляет CSS-стили элемента.

removeClass

Метод removeClass удаляет CSS-класс из компонента.
removeEventHandler Метод removeEventHandler удаляет обработчик события DOM-вершины.
removeFromDOM Метод removeFromDOM удаляет вершину из DOM-структуры.

removeStateClasses

Метод removeStateClasses удаляет CSS-классы компонента.

setDraggable

Метод setDraggable устанавливает возможность перетаскивания компонента на HTML-странице.

setFocus

Метод setFocus устанавливает фокус компонента.

setIsHovered

Метод setIsHovered настраивает отображение компонента только при наведении на него курсора.

setSize

Метод setSize устанавливает размеры компонента.

show

Метод show отображает элемент управления.
unBindEvents Метод unBindEvents отписывает элемент от всех стандартных событий.

updatePosition

Метод updatePosition корректирует размер и положение при абсолютном позиционировании на основе текущих параметров.

updateSize

Метод updateSize обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент.

События, унаследованные от класса Control

  Имя события Краткое описание
Drag Событие Drag наступает при нажатии и удерживании клавиши мыши.
DragEnd Событие DragEnd наступает при окончании перетаскивания компонента.
DragStart Событие DragStart наступает, когда начинается перетаскивание компонента.
OnContextMenu Событие OnContextMenu наступает при вызове контекстного меню компонента.
SizeChanged Событие SizeChanged наступает после изменения размеров компонента.
SizeChanging Событие SizeChanging наступает во время изменения размеров компонента.

Свойства, унаследованные от класса Object

  Имя свойства Краткое описание

Id

Свойство Id определяет идентификатор объекта репозитория.

Методы, унаследованные от класса Object

  Имя метода Краткое описание
clone Метод clone создает копию объекта.
dispose Метод dispose уничтожает компонент.
getHashCode Метод getHashCode возвращает хэш-код объекта репозитория.
getId Метод getId возвращает идентификатор объекта репозитория.
getSettings Метод getSettings возвращает настройки объекта репозитория.
getTypeName Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит.
isEqual Метод isEqual определяет, равен ли заданный объект текущему объекту репозитория.
isLive Метод isLive определяет действительность объекта репозитория.
removeAllEvents Метод removeAllEvents удаляет все обработчики событий объекта по заданному контексту.
setId Метод setId определяет идентификатор объекта репозитория.
setSettings Метод setSettings задает настройки объекта репозитория.
defineProps Метод defineProps создает методы get и set из массива имен для указанного класса.
keys Метод keys возвращает массив названий методов и свойств для указанного объекта.

См. также:

DHTML-компоненты