Speedometer

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

Комментарии

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

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

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

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

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

Пример

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

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

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

Конструктор

Свойства

	Имя свойства	Краткое описание
	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 применяет указанные настройки спидометра.

События

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

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

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

Свойства, унаследованные от класса 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

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

Методы, унаследованные от класса 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 возвращает массив названий методов и свойств для указанного объекта.

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

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

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

Speedometer: компонент

Описание