MapChart

Описание

Компонент MapChart предназначен для отображения и настройки карты на SVG-топоснове.

На картах могут быть отображены:

• стрелки для обозначения потоков между регионами или странами;

• значки, например, для обозначения городов;

• столбиковые и круговые диаграммы для наглядного представления данных;

• легенда карты;

• расшифровка территорий;

• всплывающие подсказки;

• метки;

• временная линия.

Настройки карты и различные эффекты можно задавать из xml-файла или из API.

Комментарии

Компонент реализован классом MapChart.

Пример

Создание DHTML-карты

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

Пример размещения компонентов MapMaster и MapChart

Конструктор

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

Свойства

	Имя свойства	Краткое описание
	ActiveItems	Свойство ActiveItems определяет активные области слоя карты.
	AmbientLightValue	Свойство AmbientLightValue определяет уровень внешнего освещения карты.
	AnimationEnabled	Свойство AnimationEnabled управляет разрешением на воспроизведение анимации в карте.
	ArrowEffectsMode	Свойство ArrowEffectsMode определяет вариант подсветки стрелок карты.
	Background	Свойство Background устанавливает цвет фона карты.
	DirectLightDirection	Свойство DirectLightDirection определяет направление внешнего освещения.
	DisableVisuals	Свойство DisableVisuals отключает отображение всех показателей карты.
	Has3DVisualInSettings	Свойство Has3DVisualInSettings определяет, прочитаны ли настройки трёхмерной карты из файла или же они заданы программно.
	HoveredArrows	Свойство HoveredArrows определяет массив стрелок, для которых установлено наведение.
	HoveredBars	Свойство HoveredBars определяет массив столбиковых показателей, для которых установлено наведение.
	HoveredBubbles	Свойство HoveredBubbles определяет массив пузырьковых показателей, для которых установлено наведение.
	HoveredMarkers	Свойство HoveredMarkers определяет массив маркеров, для которых установлено наведение.
	HoveredPies	Свойство HoveredPies определяет массив круговых показателей, для которых установлено наведение.
	InactiveItemsOpacity	Свойство InactiveItemsOpacity определяет прозрачность неактивных областей слоя карты.
	IsHandCursor	Свойство IsHandCursor определяет, отображается ли указатель мыши в режиме «Выбор ссылки» при наведении на область слоя карты.
	LastHoveredItem	Свойство LastHoveredItem определяет стрелку, область слоя карты или показатель под указателем мыши.
	MapGrid	Свойство MapGrid устанавливает сетку для карты.
	MapMarkers	Свойство MapMarkers определяет массив маркеров карты.
	MaxScale	Свойство MaxScale определяет максимально допустимый масштаб карты.
	MiniMap	Свойство MiniMap определяет мини-карту.
	MiniMapEnabled	Свойство MiniMapEnabled определяет признак наличия мини-карты.
	MiniMapScale	Свойство MiniMapScale определяет масштаб мини-карты.
	MinScale	Свойство MinScale определяет минимально допустимый масштаб карты.
	PixelsPerRadian	Свойство PixelsPerRadian определяет количество радиан, соответствующих одному пикселю карты по горизонтали и вертикали.
	RenderToCanvas	Свойство RenderToCanvas определяет признак того, отрисовываются ли элементы карты на канве в случае, если она доступна.
	Scale	Свойство Scale устанавливает масштаб для карты.
	SelectedArrows	Свойство SelectedArrows определяет массив выделенных стрелок.
	SelectedBars	Свойство SelectedBars определяет массив выделенных столбиковых показателей.
	SelectedBubbles	Свойство SelectedBubbles определяет массив выделенных пузырьковых показателей.
	SelectedMarkers	Свойство SelectedMarkers определяет массив выделенных маркеров.
	SelectedPies	Свойство SelectedPies определяет массив выделенных круговых показателей.
	Shape3DOpacity	Свойство Shape3DOpacity определяет прозрачность областей слоя трёхмерной карты.
	ShapesBorderColor	Свойство ShapesBorderColor определяет цвет границ областей слоя карты.
	SphereTexture	Свойство SphereTexture определяет адрес изображения, используемого в качестве текстуры для топоосновы Sphere.
	ToolTipDelay	Свойство ToolTipDelay определяет задержку перед отображением всплывающей подсказки.
	TopobaseHorizontalAlignment	Свойство TopobaseHorizontalAlignment устанавливает тип выравнивания по горизонтали.
	TopobaseSize	Cвойство TopobaseSize определяет размер топоосновы карты.
	TopobaseVerticalAlignment	Свойство TopobaseVerticalAlignment устанавливает тип выравнивания по вертикали.
	TopoBoundingAngles	Свойство TopoBoundingAngles определяет прямоугольную область, ограничивающую топооснову карты.
	TopoBoundingBox	Свойство TopoBoundingBox определяет ограничительный куб топоосновы карты.
	TopoNormalization	Свойство TopoNormalization определяет настройки геометрический нормализации топоосновы карты.
	Type	Свойство Type устанавливает технологию отрисовки карты.
	UnhoverTimeout	Свойство UnhoverTimeout определяет временной период подсвечивания элементов после отмены наведения.
	UseItemColorForToolTipBorder	Свойство UseItemColorForToolTipBorder определяет, используется ли для задания цвета границы всплывающей подсказки цвет заливки соответствующей области слоя карты.
	UseMorphFill	Свойство UseMorphFill определяет, будет ли использована градиентная заливка для области слоя карты.
	UseSelectOnClick	Свойство UseSelectOnClick определяет, разрешено ли выделение области слоя карты при её выборе с помощью указателя мыши.
	UseZoomOnWheel	Свойство UseZoomOnWheel определяет, будет ли масштабироваться карта  помощью колесика мыши.

Методы

	Имя метода	Краткое описание
	activateSpectrumLegend	Метод activateSpectrumLegend управляет отображением спектральной легенды на карте.
	afterGoogleLoad	Метод afterGoogleLoad вызывает действия, требующие выполнения после загрузки карты с топоосновой Google.
	changeTopobase	Метод resumeTimeline меняет топооснову.
	clearLastHoveredItem	Метод clearLastHoveredItem удаляет информацию о стрелке, области слоя карты или показателе под указателем мыши.
	clearLayer	Метод clearLayer очищает указанный слой.
	clearLayers	Метод clearLayers очищает все слои в карте.
	clearPaper	Метод clearPaper очищает карту.
	findValueFormat	Метод findValueFormat преобразует формат подписи к интервалам легенды карты в массив форматов значений.
	formatValue	Метод formatValue форматирует значение в соответствии с указанным форматом.
	geoToTopobase	Метод geoToTopobase преобразует географические координаты в координаты топоосновы.
	getArrowLayer	Метод getArrowLayer возвращает слой для стрелок карты.
	getBarLayer	Метод getBarLayer возвращает слой столбиковых показателей карты.
	getBubbleLayer	Метод getBubbleLayer возвращает слой пузырьковых показателей карты.
	getContentMilestoneLayer	Метод getContentMilestoneLayer возвращает содержимое слоя значков для карты.
	getDataSource	Метод getDataSource возвращает источник данных по его идентификатору.
	getFirstVisual	Метод getFirstVisual возвращает первый показатель карты.
	getGMapDomNode	Метод getGMapDomNode возвращает DOM-элемент топоосновы карты Google.
	getGoogleMap	Метод getGoogleMap возвращает топооснову карты Google.
	getInstance	Метод getInstance возвращает экземпляр карты.
	getLabelColor	Метод getLabelColor возвращает цвет границы подписи данных.
	getLabelLayer	Метод getLabelLayer возвращает слой меток карты.
	getLayer	Метод getLayer возвращает слой карты по его идентификатору.
	getMapGridLayer	Метод getMapGridLayer возвращает слой сетки карты.
	getMarkerLayer	Метод getMarkerLayer возвращает слой маркеров карты.
	getMilestoneLayer	Метод getMilestoneLayer возвращает слой значков карты.
	getPaper	Метод getPaper возвращает область карты.
	getPaperArea	Метод getPaperArea возвращает прямоугольник, ограничивающий область карты.
	getPieLayer	Метод getPieLayer возвращает слой круговых показателей карты.
	getRegionName	Метод getRegionName возвращает имя региона по его идентификатору.
	getScaleSettings	Метод getScaleSettings возвращает настройки масштаба карты.
	getSelectedShape	Метод getSelectedShape вовзращает область слоя карты по координатам принадлежащей ей точки.
	getShape	Метод getShape возвращает область карты по ее идентификатору.
	getState	Метод getState возвращает настройки карты.
	getToolTipArea	Метод getToolTipArea возвращает область, доступную для отображения всплывающих подсказок.
	getToolTipColor	Метод getToolTipColor возвращает цвет границы всплывающей подсказки.
	getToolTipLayer	Метод getToolTipLayer возвращает слой всплывающих подсказок для областей слоя карты.
	getTopobase	Метод getTopobase возвращает топооснову карты.
	getTopobaseLeft	Метод getTopobaseLeft возвращает отступ топоосновы от левой границы карты в пикселях.
	getTopobaseTop	Метод getTopobaseTop возвращает отступ топоосновы от верхней границы карты в пикселях.
	isLoaded	Метод isLoaded определяет, загружена и отрисована ли карта.
	isSomethingSelected	Метод isSomethingSelected определяет, содержатся ли на карте выделенные элементы.
	refreshView	Метод refreshView обновляет карту в соответствии с указанными настройками.
	requestContentChanged	Метод requestContentChanged вызывает событие ContentChanged.
	resumeTimeline	Метод resumeTimeline возобновляет анимацию временной шкалы.
	pauseTimeline	Метод pauseTimeline приостанавливает анимацию временной шкалы.
	scale	Метод scale увеличивает текущий масштаб.
	sceneToScreen	Метод sceneToScreen возвращает оконные координаты точки, соответствующие мировым.
	sceneToScreenIfVisible	Метод sceneToScreenIfVisible возвращает оконные координаты точки, соответствующие мировым, при условии, если она является видимой.
	setMasterSettings	Метод setMasterSettings применяет указанные настройки карты.
	setViewArea	Метод setViewArea устанавливает область просмотра карты.
	topobaseToScreen	Метод topobaseToScreen преобразует координаты указанной области топоосновы в экранные координаты.

Событие

	Имя события	Краткое описание
	ContentChanged	Событие ContentChanged наступает после изменения содержимого карты.
	Loaded	Событие Loaded наступает после загрузки карты.
	Refreshed	Событие Refreshed наступает после обновления карты.
	TimelineStepChanged	Событие TimelineStepChanged наступает после изменения шага временной шкалы.
	TimelineStepChanging	Событие TimelineStepChanging наступает перед изменением шага временной шкалы.
	ViewAreaChanged	Событие ViewAreaChanged наступает после изменения области просмотра карты.

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

	Имя свойства	Краткое описание
	Anchors	Свойство Anchors определяет позицию компонента, размещенного внутри контейнера.
	Animation	Свойство Animation устанавливает параметры анимации для компонента.
	Bottom	Свойство Bottom устанавливает отступ снизу при размещении компонента внутри LayoutPanel.
	Content	Свойство Content устанавливает содержимое компонента.
	ContextMenu	Свойство ContextMenu устанавливает контекстное меню для компонента.
	Data	Свойство Data предназначено для хранения любых пользовательских данных.
	DataContext	Свойство DataContext содержит объект с данными.
	Enabled	Свойство Enabled устанавливает, является ли компонент доступным для использования.
	Height	Свойство Height устанавливает высоту компонента.
	IsResizable	Свойство IsResizable определяет, можно ли изменять размеры компонента.
	IsRTL	Свойство IsRTL устанавливает направление текста справа налево.
	IsVisible	Свойство IsVisible определяет, отображается ли компонент.
	Left	Свойство Left устанавливает отступ слева при размещении компонента внутри GridPanel.
	Offset	Свойство Offset определяет координаты корневой DOM-вершины элемента управления.
	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-класс к компоненту.
	addEvent	Метод addEvent добавляет обработчик события на DOM-вершину.
	addEventHandler	Метод addEventHandler добавляет обработчик события на DOM-вершину.
	addEvents	Метод addEvents добавляет массив обработчиков событий на DOM-вершину.
	addStateClass	Метод addStateClass добавляет CSS-класс к компоненту и удаляет прежний CSS-класс.
	addStyleBySelector	Метод addStyleBySelector создает блок со стилем с указанным css-селектором.
	addToNode	Метод addToNode добавляет компонент в указанную вершину.
	bindEvents	Метод bindEvents подписывает элемент на все стандартные события.
	clearStylesCache	Метод clearStylesCache очищает кэш стилей компонента.
	getAnchorFlags	Метод getAnchorFlags возвращает JSON-объект с настройками текущей позиции компонента.
	getClass	Метод getClass возвращает текущие css-классы компонента.
	getCssStyle	Метод getCssStyle возвращает стили для указанной вершины.
	getDomNode	Метод getDomNode возвращает главную DOM-вершину компонента.
	getFocused	Метод getFocused определяет наличие фокуса у компонента.
	getFunctionByName	Метод getFunctionByName возвращает функцию по имени.
	getIsBinded	Метод getIsBinded возвращает признак подписи элемента на события DOM-вершины.
	hasClass	Метод hasClass определяет, задан ли для корневой DOM-вершины элемента управления указанный CSS-класс.
	hide	Метод hide скрывает элемент управления.
	hideToolTip	Метод hideToolTip очищает таймаут появления подсказки и скрывает ее, если она был показана.
	isResingNow	Метод isResingNow определяет, изменяются ли в данный момент размеры компонента.
	refreshBindingProperty	Метод refreshBindingProperty обновляет привязанное свойство по имени.
	refreshItemsStyle	Метод refreshItemsStyle обновляет CSS-стили дочерних элементов.
	refreshStyle	Метод refreshStyle обновляет CSS-стили элемента.
	removeClass	Метод removeClass удаляет CSS-класс из компонента.
	removeEvent	Метод removeEvent удаляет обработчик события у DOM-вершины.
	removeEventHandler	Метод removeEventHandler удаляет обработчик события DOM-вершины.
	removeFromDOM	Метод removeFromDOM удаляет вершину из DOM-структуры.
	removeStateClasses	Метод removeStateClasses удаляет CSS-классы компонента.
	setDraggable	Метод setDraggable устанавливает возможность перетаскивания компонента на html-странице.
	setFocus	Метод setFocus устанавливает фокус компонента.
	setIsHovered	Метод setIsHovered отображает компонент как при наведении на него курсора.
	setIsPressed	Метод setIsPressed отображает компонент как при клике по нему.
	setOpacityIE8	Метод setOpacityIE8 устанавливает значение прозрачности компонента в браузере InternetExplorer 8.
	setSize	Метод setSize устанавливает размеры компонента.
	show	Метод show отображает элемент управления.
	unBindEvents	Метод unBindEvents отписывает элемент от всех стандартных событий.
	updatePosition	Метод updatePosition корректирует размер и положение при абсолютном позиционировании на основе текущих параметров.
	updateSize	Метод updateSize обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент.

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

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

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

	Имя свойства	Краткое описание
	Data	Свойство Data ассоциирует произвольный объект с данным компонентом.
	Id	Свойство Id устанавливает идентификатор компонента.
	Settings	Свойство Settings задает параметры компонента.

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

	Имя метода	Краткое описание
	clone	Метод clone создает копию объекта. Не реализован в PP.Ui.Control.
	dispose	Метод dispose уничтожает компонент.
	getTypeName	Метод getTypeName возвращает имя типа объекта без пространства имён, к которому он принадлежит.

См. также:

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