[]
        
(Showing Draft Content)

C1.Win.FlexReport.CustomFields.Map

Map Class

Represents a map showing spatial and analytical data in the report.

Inheritance
Map
Implements
Namespace: C1.Win.FlexReport.CustomFields
Assembly: C1.Win.FlexReport.CustomFields.4.8.dll
Syntax
[TypeConverter(typeof(a))]
public class Map : Field, IMapperOwner

Constructors

Name Description
Map()

Initializes a new instance of the Map class.

Properties

Name Description
ActualTileSource

Gets the actual tile source used by the Map.

AutoCenter

Gets or sets a value indicating whether to automatically center the map around the spatial data. Note that setting this property to false effectively turns off AutoZoom.

The default is true.

AutoZoom

Gets or sets a value indicating whether the map should automatically zoom in to just include all spatial data. Ignored (considered to be false) if AutoCenter is false.

The default is true.

AutoZoomPadLat

Gets or sets auto zoom latitude padding, in percent relative to the viewport height.

The default is 10%.

AutoZoomPadLon

Gets or sets auto zoom longitude padding, in percent relative to the viewport width.

The default is 10%.

CenterLatitude

Gets or sets the map center latitude. Ignored if AutoCenter is true.

CenterLongitude

Gets or sets the map center longitude. Ignored if AutoCenter is true.

CustomTileSource

Gets or sets the custom tile source used by this map.

GenericTileSource

Gets the generic tile source when the TileSource is Generic.

GeoCachePath

Gets or sets the path to the file used to cache spatial coordinates (longitude/latitude) specified as MapLocation rather than actual Longitude/Latitude values. The coordinates in such cases are retrieved using an online service such as Google, and caching them significantly imporoves performance when the same location is encountered multiple times.

The path is relative to the application startup path.

The default is "geocache.xml".

Clear this value to disable caching (not recommended).

ImageType

Gets or sets the type of image generated by the map.

KmlItemStyles

Gets the collection of styles used to render KML/KMZ items on the map. Styles allow KML items in different layers or even in different maps to use common visual properties.

Note that the set accessor is only for deserialization, and should not be used directly.

Layers

Gets the collection of layers containing markers, lines and KML data rendered on the map.

Note that the set accessor is only for deserialization, and should not be used directly.

Legends

Gets the collection of legends rendered on the map. Legends may represent layers or arbitrary information (such as captions).

Note that the set accessor is only for deserialization, and should not be used directly.

LineStyles

Gets the collection of styles used to render lines on the map. Styles allow lines in different layers or even in different maps to use common visual properties.

Note that the set accessor is only for deserialization, and should not be used directly.

MarkerStyles

Gets the collection of styles used to render markers on the map. Styles allow markers in different layers or even in different maps to use common visual properties.

Note that the set accessor is only for deserialization, and should not be used directly.

MaxAutoZoom

Gets or sets the maximum zoom level value for auto zooming. Valid values are from 0 to 20. 0 (the default) disables auto zoom limiting.

RoundAutoZoom

Gets or sets a value indicating whether to round automatically calculated zoom levels down to next integer.

The default is true.

ShowPanTool

Gets or sets a value indicating whether to show the pan tool.

The default is false.

ShowScale

Gets or sets a value indicating whether to show the map scale.

The default is true.

ShowZoomTool

Gets or sets a value indicating whether to show the zoom scale.

The default is false.

TargetDpi

Obsoleted. Gets or sets the target image resolution (dpi).

The default is 200 dpi.

TileSource

Gets or sets the map tile source.

ToolsColor

Gets or sets the background color of the map scale and other tools.

UseAntiAliasedGraphics

Gets or sets a value indicating whether to use anti-aliasing while rendering map graphics.

ZoomLevel

Gets or sets the zoom level value. 0 is no zoom, 1 - x2 zoom and so on. Valid values are from 0 to 20.

The default is 0.

Ignored if AutoZoom is true.

Methods

Name Description
AssignFrom(ReportObject, bool)

Copies properties from another object into this object.

GetRenderContent(ref string, ref IImage, ref bool, bool)

Assigns the map image that will be rendered by the field.

Load(XmlNodeList)

Overridden. Loads map specific collections.

OnPropertyChanged()

Overridden. Disposes the cached map image if any, and calls the base implementation.

OnSerializeAdded()

Overriden. Post action after the Map is added to the parent report's fields collection.

Save(XmlWriter)

Overridden. Saves map specific collections.

Events

Name Description
LayersChanged

Fired when the Layers collection is set.