MapChart

Namespace: PP;

Inheritance hierarchy

Object

Control

DataVisualizer

MapChart

Description

The MapChart class implements the MapChart component used to show maps.

Syntax

PP.initClass(PP.MapChart, PP.Ui.DataVisualizer, "PP.MapChart", [PP.Ui.IDataView, PP.Ui.IVisualizerItemActivatable, PP.Ui.IMiniMappable]);

Constructor

	Constructor name	Brief description
	MapChart	The MapChart constructor creates an instance of the MapChartcomponent.

Properties

	Property name	Brief description
	ActiveItems	The ActiveItems property determines active areas of map layer.
	AmbientLightValue	The AmbientLightValue method determines level of map ambient light.
	AnimationEnabled	The AnimationEnabled property enables and disables map animation.
	ArrowEffectsMode	The ArrowEffectsMode property determines map arrow highlighting mode.
	Background	The Background property sets map background color.
	DirectLightDirection	The DirectLightDirection property determines direction of ambient light.
	DisableVisuals	The DisableVisuals property disables displaying all map factors.
	Has3DVisualInSettings	The Has3DVisualInSettings property determines whether 3D map settings are read from file or set programmatically.
	HoveredArrows	The HoveredArrows property determines an array of arrows, for which hovering is set.
	HoveredBars	The HoveredBars property determines an array of bar factors, for which hovering is set.
	HoveredBubbles	The HoveredBubbles property determines an array of bubble factors, for which hovering is set.
	HoveredMarkers	The HoveredMarkers property determines an array of markers, for which hovering is set.
	HoveredPies	The HoveredPies property determines an array of pie factors, for which hovering is set.
	InactiveItemsOpacity	The InactiveItemsOpacity property determines transparency for inactive regions of map layer.
	IsHandCursor	The IsHandCursor property determines whether mouse pointer is displayed in the Link Selection mode on hovering over a map layer region.
	LastHoveredItem	The LastHoveredItem property determines an arrow, map layer or factor that was last hovered over with the mouse.
	MapGrid	The MapGrid property sets map grid.
	MapMarkers	The MapMarkers property determines an array of map markers.
	MaxScale	The MaxScale property determines maximum possible map scale.
	MiniMap	The MiniMap property determines a minimap.
	MiniMapEnabled	The MiniMapEnabled property determines whether there is minimap.
	MiniMapScale	The MiniMapScale property determines minimap scale.
	MinScale	The MinScale property determines minimum map scale.
	PixelsPerRadian	The PixelsPerRadian property determines the number of radians per one map pixel horizontally and vertically.
	RenderToCanvas	The RenderToCanvas property determines whether map elements are rendered on the canvas if the canvas is available.
	Scale	The Scale property sets map scale.
	SelectedArrows	The SelectedArrows property determines an array of selected arrows.
	SelectedBars	The SelectedBars property determines an array of selected bar factors.
	SelectedBubbles	The SelectedBubbles property determines an array of selected bubble factors.
	SelectedMarkers	The SelectedMarkers property determines an array of selected markers.
	SelectedPies	The SelectedPies property determines an array of selected pie factors.
	Shape3DOpacity	The Shape3DOpacity property determines transparency for regions of 3D map layer.
	ShapesBorderColor	The ShapesBorderColor property determines color of borders for map layer regions.
	SphereTexture	The SphereTexture property determines address of the image used as a texture for the Sphere topobase.
	ToolTipDelay	The ToolTipDelay property determines delay before a tooltip is displayed.
	TopobaseHorizontalAlignment	The TopobaseHorizontalAlignment property sets type of horizontal alignment.
	TopobaseSize	The TopobaseSize property determines map topobase size.
	TopobaseVerticalAlignment	The TopobaseVerticalAlignment property sets vertical alignment type.
	TopoBoundingAngles	The TopoBoundingAngles property determines a rectangular area that limits map topobase.
	TopoBoundingBox	The TopoBoundingBox property determines a bounding box for map topobase.
	TopoNormalization	The TopoNormalization property determines settings of map topobase geometric normalization.
	Type	The Type property sets map rendering method.
	UnhoverTimeout	The UnhoverTimeout property determines the time interval of highlighting elements after unhovering.
	UseItemColorForToolTipBorder	The UseItemColorForToolTipBorder property determines whether tooltip border color is set based on the fill color of the corresponding map layer region.
	UseMorphFill	The UseMorphFill property determines whether gradient fill is used for map layer region.
	UseSelectOnClick	The UseSelectOnClick property determines whether map layer region can be selected when it is chosen with mouse cursor.
	UseZoomOnWheel	The UseZoomOnWheel property determines whether a map will be zoomed with mouse wheel.

Methods

	Method name	Brief description
	activateSpectrumLegend	The activateSpectrumLegend method controls displaying of a spectrum legend on a map.
	afterGoogleLoad	The afterGoogleLoad method invokes actions to be executed after loading a map with a Google topobase.
	changeTopobase	The resumeTimeline method changes topobase.
	clearLastHoveredItem	The clearLastHoveredItem method clears information about arrow, map layer region, or factor hovered over with the mouse cursor.
	clearLayer	The clearLayer method clears the specified layer.
	clearLayers	The clearLayers method clears all map layers.
	clearPaper	The clearPaper method clears a map.
	findValueFormat	The findValueFormat method converts format of map legend interval label to array of value formats.
	formatValue	The formatValue method formats value in accordance with the specified format.
	geoToTopobase	The geoToTopobase method converts geographical coordinates into topobase coordinates.
	getArrowLayer	The getArrowLayer method returns map arrows layer.
	getBarLayer	The getBarLayer method returns the layer of map bar factors.
	getBubbleLayer	The getBubbleLayer method returns the layer of map bubble factors.
	getContentMilestoneLayer	The getContentMilestoneLayer method returns contents of the milestones layer for a map.
	getDataSource	The getDataSource method returns data source by its identifier.
	getFirstVisual	The getFirstVisual method returns the first map factor.
	getGMapDomNode	The getGMapDomNode method returns DOM element of a Google map topobase.
	getGoogleMap	The getGoogleMap method returns Google map topobase.
	getInstance	The getInstance method returns map instance.
	getLabelColor	The getLabelColor method returns data label border color.
	getLabelLayer	The getLabelLayer method returns map labels layer.
	getLayer	The getLayer method returns map layer by its identifier.
	getMapGridLayer	The getMapGridLayer method returns map grid layer.
	getMarkerLayer	The getMarkerLayer method returns map labels layer.
	getMilestoneLayer	The getMilestoneLayer method returns map milestones layer.
	getPaper	The getPaper method returns map region.
	getPaperArea	The getPaperArea method returns rectangle that bounds a map region.
	getPieLayer	The getPieLayer method returns the layer of map pie factors.
	getRegionName	The getRegionName method returns region name by its identifier.
	getScaleSettings	The getScaleSettings method returns map scale settings.
	getSelectedShape	The getSelectedShape method returns map layer region by coordinates of the point that belongs to a map.
	getShape	The getShape method returns map region by its identifier.
	getState	The getState method returns map settings.
	getToolTipArea	The getToolTipArea method returns the area available for displaying tooltips.
	getToolTipColor	The getToolTipColor method returns tooltip border color.
	getToolTipLayer	The getToolTipLayer method returns tooltip layer for map layer regions.
	getTopobase	The getTopobase method returns topobase of a map.
	getTopobaseLeft	The getTopobaseLeft method returns topobase offset from the left edge of a map in pixels.
	getTopobaseTop	The getTopobaseTop method returns topobase offset from the top edge of a map in pixels.
	isLoaded	The isLoaded method checks if a map is loaded and rendered.
	isSomethingSelected	The isSomethingSelected method determines whether a map contains selected elements.
	refreshView	The refreshView method refreshes map in accordance with the specified settings.
	requestContentChanged	The requestContentChanged method calls the ContentChanged event.
	resumeTimeline	The resumeTimeline method resumes timeline animation.
	pauseTimeline	The pauseTimeline method pauses timeline animation.
	scale	The scale method increases the current scale.
	sceneToScreen	The sceneToScreen method returns window coordinates of the point corresponding to world coordinates.
	sceneToScreenIfVisible	The sceneToScreenIfVisible method returns window coordinates of the point, corresponding to world coordinates, on condition that this point is visible.
	setMasterSettings	The setMasterSettings method applies the specified map settings.
	setViewArea	The setViewArea method sets map view area.
	topobaseToScreen	The topobaseToScreen method converts coordinates of the specified topobase area to screen coordinates.

Event

	Event name	Brief description
	ContentChanged	The ContentChanged event occurs after changing map contents.
	Loaded	The Loaded event occurs after map loading.
	Refreshed	The Refreshed event occurs after map refreshing.
	TimelineStepChanged	The TimelineStepChanged event occurs after changing timeline step.
	TimelineStepChanging	The TimelineStepChanging event occurs before changing timeline step.
	ViewAreaChanged	The ViewAreaChanged event occurs after changing map view area.

Properties inherited from the class DataVisualizer

	Property name	Brief description
	ActiveMappingItems	The ActiveMappingItems property determines an array of active values of a bubble chart.
	AreaSelection	The AreaSelection property sets selection area for charts.
	AreaSelectionAction	The AreaSelectionAction property determines the action on selecting visualizer area.
	CustomData	The CustomData property is used to store custom data.
	DataSources	The DataSources property sets and returns an object that contains data sources for charts.
	EnableBatchData	The EnableBatchData property controls availability of batch data in a chart source.
	EnableSelection	The EnableSelection property determines whether visualizer elements can be selected.
	GlobalItemsIds	The GlobalItemsIds method determines a dictionary of global identifiers of elements.
	HoverActiveEffects	The HoverActiveEffects property determines effects applied to objects on hovering the cursor on them.
	HoveredItems	The HoveredItems property determines an array of elements, which can be hovered.
	HoverInactiveEffects	The HoverInactiveEffects property determines effects applied to the objects, which are not hovered.
	ItemHoverness	The ItemHoverness property determines whether a chart element can be hovered.
	ItemSelection	The ItemSelection property determines element selection.
	LegendMapping	The LegendMapping property determines a dictionary of connection of legends with data bindings.
	Legends	The Legends property sets and returns array of chart legends.
	LegendsPackingMaxPart	The LegendsPackingMaxPart property sets and returns maximum part of chart legends from their packing.
	MappingActiveEffects	The MappingActiveEffects property compares effects for active elements.
	MappingInactiveEffects	The MappingInactiveEffects property compares effects for inactive elements.
	MappingItemActiveness	The MappingItemActiveness property determines whether effect comparison is active for visualizer element.
	Scales	The Scales property sets and returns chart scales.
	SelectActiveEffects	The SelectActiveEffects property determines an array of effects applied to the selected bubble chart elements.
	SelectedItems	The SelectedItems property determines an array of selected bubble chart elements.
	SelectInactiveEffects	The SelectInactiveEffects property determines an array of effects applied to non-selected bubble chart elements.
	SettingsProvider	The SettingsProvider property determines a basic class for specified settings.
	Timeline	The Timeline property returns and sets a chart timeline.
	UseLegendsPacking	The UseLegendsPacking property allows and prohibits using chart legend packing.
	UseSelectOnClick	The UseSelectOnClick property determines whether an element can be selected by means of the mouse cursor.
	UseSelectOnRightClick	The UseSelectOnRightClick property determines whether an element can be selected by means of the right mouse button.
	Visuals	The Visuals property sets and returns settings of mapping data series values with chart axes, color and size of chart elements.

Methods inherited from the class DataVisualizer

	Method name	Brief description
	addVisual	The addVisual method compares visualizer data with the specified identifier.
	animate	The animate method plays chart animation.
	beginUpdate	The beginUpdate method starts data update mode that disables component rerendering until exiting from this mode.
	clearAreaSelection	The clearAreaSelection method clears chart selection.
	disposeData	The disposeData method deletes complex properties of visualizer.
	draw	The draw method completely rerenders a chart.
	endUpdate	The endUpdate method disables data update mode that disables component rerendering until exiting from this mode.
	getBackwardGlobalItemsIds	The getBackwardGlobalItemsIds method returns backward dictionary of global identifiers of elements.
	getBackwardLegendMapping	The getBackwardLegendMapping method returns backward dictionary of connection of legends with data bindings.
	getEnableHover	The getEnableHover method returns whether effects are used on hovering the cursor on bubble chart bubbles.
	getFirstDataSource	The getFirstDataSource method returns the first data source for chart data visualizer.
	getFirstLegend	The getFirstLegend method returns the chart first legend.
	getFirstScale	The getFirstScale method returns the first scale in a chart.
	getGlobalItemId	The getGlobalItemId method returns global identifier of element.
	getItemsByAreaRect	The getItemsByAreaRect method returns elements within the specified chart area.
	getLegendByDataMapping	The getLegendByDataMapping method returns visualizer legend by data comparison identifier.
	getLegendById	The getLegendById method returns bubble chart legend by its identifier.
	getLocalItemId	The getLocalItemId method returns internal identifier of element.
	getTimelineStepName	The getTimeLineStepName method returns the current timeline step.
	getVisualById	The getVisualById method returns comparison of visualizer data by its identifier.
	loadData	The loadData method uploads specified data to a chart.
	refresh	The refresh method refreshes a chart.
	setTimelineStep	The setTimelineStep method sets a timeline step.
	updateData	The updateData method assigns new index value to parameters of chart series data values mapping.

Events inherited from the class DataVisualizer

	Event name	Brief description
	AreaSelected	The AreaSelected event occurs after a chart area is selected.
	AreaSelecting	The AreaSelecting event occurs in the process of chart area selection.
	ItemsSelected	The ItemSelected event occurs after visualizer elements are selected.
	ItemsSelecting	The ItemSelecting event occurs before selecting visualizer elements.
	LegendHeaderClicked	The LegendHeaderClicked event occurs on clicking the chart legend title.
	LegendItemSelected	The LegendItemSelected event occurs after selecting a legend element.
	LegendItemSelecting	The LegendItemSelecting event occurs on selecting a legend element.
	RequestData	The RequestData event occurs when it is necessary to load data to a data source.
	TimelineStep	The TimelineStep event occurs on changing the current step of the chart timeline.

Properties inherited from the class Control

	Property name	Brief description
	Anchors	The Anchors property determines position of the component placed within container.
	Animation	The Animation property sets animation parameters for component.
	Bottom	The Bottom property sets bottom offset on placing the component within the LayoutPanel.
	Content	The Content property sets the component contents.
	ContextMenu	The ContextMenu property sets the context menu for the component.
	Data	The Data property is used to store any custom data.
	DataContext	The DataContext property contains an object with data.
	Enabled	The Enabled property sets whether the component is enabled.
	Height	The Height property determines the component height.
	IsResizable	The IsResizable property determines whether the component can be resized.
	IsRTL	The lsRTL property sets right to left text direction.
	IsVisible	The IsVisible property determines whether the component is displayed.
	Left	The Left property sets left offset on placing the component within the GridPanel.
	Offset	The Offset property determines coordinates of root DOM node of a control.
	Opacity	The Opacity property determines component transparency.
	Parent	The Parent property determines a parent component of a control.
	ParentNode	The ParentNode property sets parent DOM node.
	ResourceKey	The ResourceKey property sets the resource key for the component.
	Right	The Right property sets right offset on placing the component within the LayoutPanel.
	Rotate	The Rotate property sets component rotation angle.
	ShowToolTip	The ShowToolTip property determines whether the tooltip of the component can be displayed.
	Style	The Style property sets component style.
	TabIndex	The TabIndex property sets the order of the control element passing inside the container.
	Tag	The Tag property sets JSON object associated with the component.
	ToolTip	The ToolTip property determines text of component tooltip.
	Top	The Top property sets top offset on placing the component within the GridPanel.
	Value	The Value property sets the value to the component.
	Width	The Width property sets the component width.

Methods inherited from the class Control

	Method name	Brief description
	addClass	The addClass method adds a CSS class to the component.
	addEvent	The addEvent method adds an event handler to a DOM node.
	addEventHandler	The addEventHandler method adds an event handler to a DOM node.
	addEvents	The addEvents method adds an array of event handlers to a DOM node.
	addStateClass	The addStateClass method adds a CSS class to the component and removes the previous CSS class.
	addStyleBySelector	The addStyleBySelector method creates a block that contains a style with the specified CSS selector.
	addToNode	The addToNode method adds a component to the specified node.
	bindEvents	The bindEvents method subscribes an element to all available events.
	clearStylesCache	The clearStylesCache method clears cache of component styles.
	getAnchorFlags	The getAnchorFlags method returns JSON object that contains settings of the current component's position.
	getClass	The getClass method returns the current CSS classes of the component.
	getCssStyle	The getCssStyle method returns style for the specified node.
	getDomNode	The getDomNode method returns main DOM node of the component.
	getFocused	The getFocused method determines whether the component is focused.
	getFunctionByName	The getFunctionByName method returns function by name.
	getIsBinded	The getIsBinded method returns whether an element is subscribed to all DOM node events.
	hasClass	The hasClass method determines whether the specified CSS class is set for root DOM node of the control.
	hide	The hide method hides a control.
	hideToolTip	The hideToolTip method clears tooltip timeout and hides the tooltip if it is displayed.
	isResingNow	The isResingNow method determines whether the component is being resized.
	refreshBindingProperty	The refreshBindingProperty method refreshes the bound property by name.
	refreshItemsStyle	The refreshItemsStyle method refreshes CSS styles of child elements.
	refreshStyle	The refreshStyle method refreshes element CSS styles.
	removeClass	The removeClass method removes CSS class from the component.
	removeEvent	The removeEvent method removes event handler from DOM node.
	removeEventHandler	The removeEventHandler method removes event handler from DOM node.
	removeFromDOM	The removeFromDOM method removes node from the DOM structure.
	removeStateClasses	The removeStateClasses method removes CSS classes of the component.
	setDraggable	The setDraggable method determines whether it is possible to drag component on the HTML page.
	setFocus	The setFocus method sets the component focus.
	setIsHovered	The setIsHovered method displays the component as on hover.
	setIsPressed	The setIsPressed method displays the component as if clicked upon.
	setOpacityIE8	The setOpacityIE8 method sets component transparency value in Internet Explorer 8.
	setSize	The setSize method establishes the sizes of the component.
	show	The show method displays a control.
	unBindEvents	The unBindEvents method unsubscribes an element from all standard events.
	updatePosition	The updatePosition method updates size and position when absolute positioning based on the current parameters is used.
	updateSize	The updateSize method updates the component size on changing the size of the container that contains the component.

Events inherited from the class Control

	Event name	Brief description
	Drag	The Drag event occurs on clicking and holding the left mouse button.
	DragEnd	The DragEnd event occurs when dragging the component finishes.
	DragStart	The DragStart event occurs when dragging the component starts.
	OnContextMenu	The OnContextMenu event occurs on calling context menu of the component.
	SizeChanged	The SizeChanged event occurs after the component is resized.
	SizeChanging	The SizeChanging event occurs during component resize.

Properties inherited from the class Object

	Property name	Brief description
	Data	The Data property associates a random object with this component.
	Id	The Id property sets component identifier.
	Settings	The Settings property sets the component parameters.

Methods inherited from the class Control

	Method name	Brief description
	clone	The clone method creates a copy of object. It is not implemented in PP.Ui.Control.
	dispose	The dispose method deletes the component.
	getTypeName	The getTypeName method returns the name of the object type without the namespace, to which it belongs.

See also:

Classes Used to Work with DHTML Map