User Tools

Site Tools


thinkgeo.mapsuite.webedition.markeroverlay

This is an old revision of the document!


ThinkGeo.MapSuite.WebEdition.MarkerOverlay

<!– Class –> Serves as the base class for the overlay that generates and manages markers.

Remarks

The &lt;strong&gt;MarkerOverlay&lt;/strong&gt; class is the base class for any overlay that deals with markers. A &lt;strong&gt;MarkerOverlay&lt;/strong&gt; object corresponds to a &lt;strong&gt;div&lt;/strong&gt; that holds a group of marker images at the client side. The MarkerOverlay class has a &lt;strong&gt;GetMarkers&lt;/strong&gt; method that generates a collection of markers. These markers will be serialized to a JSON string and sent to the client to create the client marker objects. If you want to create your own MarkerOverlay, inherit from this class and override the &lt;strong&gt;GetMarkerCore&lt;/strong&gt; method.

Inheritance Hierarchy

Members Summary

Public Constructors

Name Parameters DeclaringType Summary

Protected Constructors

Name Parameters DeclaringType Summary
Protected MethodMarkerOverlay Initialize a new instance of the MarkerOverlay class.
Protected MethodMarkerOverlay String Initialize a new instance of the MarkerOverlay class using the identifier specified.

Public Methods

Name Parameters DeclaringType Summary
Public MethodEquals Object Object
Public MethodGetHashCode Object
Public MethodGetMarkers RectangleShape, Int32 Returns a collection of markers based on the extent and zoomlevel that you passed in.
Public MethodGetType Object
Public MethodToJson Overlay Returns a JSON string which contains the information for creating an overlay at the client side.
Public MethodToString Object

Protected Methods

Name Parameters DeclaringType Summary
Protected MethodFinalize Object
Protected MethodGetMarkersCore RectangleShape, Int32 Returns a collection of markers based on the extent and zoomlevel that you passed in.
Protected MethodMemberwiseClone Object
Protected MethodOnClick MarkerOverlayClickEventArgs Raises the Click event of the MarkerOverlay object.
Protected MethodOnTick EventArgs Overlay Raises the Tick event of the MarkerOverlay.
Protected MethodRegisterJavaScriptLibraryCore Page Overlay Registers a Javascript library URL string to the client HTML page.

Public Properties

Name Return DeclaringType Summary
Public PropertyAttribution String Overlay
Public PropertyAutoRefreshInterval TimeSpan Overlay Gets or sets the time interval in which the MarkerOverlay refreshes itself.
Public PropertyId String Overlay Gets the identifier for the overlay to be found.
Public PropertyIsBaseOverlay Boolean Overlay(overriden) Gets or sets a value that indicates whether the overlay is a base overlay.
Public PropertyIsVisible Boolean Overlay Gets or sets a value that indicates whether the overlay is visible on the map.
Public PropertyIsVisibleInOverlaySwitcher Boolean Overlay Gets or sets a value that indicates whether the overlay name is displayed in the OverlaySwitcher.
Public PropertyName String Overlay Gets or sets the name of the overlay, which will display in the OverlaySwitcher.
Public PropertyOpacity Single Overlay Gets or sets the opacity level of the overlay.

Protected Properties

Name Return DeclaringType Summary
Protected PropertyHasTickEvent Boolean Overlay Indicates whether the overlay supports tick event.
Protected PropertyOverlayType String Overlay(overriden) Gets a string that indicates the overlay type.

Public Events

Name Event Arguments DeclaringType Summary
Public EventClick MarkerOverlayClickEventArgs Occurs when a marker in the overlay is clicked.
Public EventTick EventArgs Overlay Occurs when the number of milliseconds specified in the AutoRefreshInterval property has elapsed and the page is posted to the server.

Public Constructors

Protected Constructors

MarkerOverlay()

Initialize a new instance of the MarkerOverlay class.

Overloads

Initialize a new instance of the MarkerOverlay class.

Remarks

Parameters

Name Type Description

Go Back

MarkerOverlay(String)

Initialize a new instance of the MarkerOverlay class using the identifier specified.

Overloads

Initialize a new instance of the MarkerOverlay class.

Remarks

Parameters

Name Type Description
id String<!– System.String –> The identifier string of the MarkerOverlay.

Go Back

Public Methods

Equals(Object)

Remarks

Return Value

Return Type Description
Boolean<!– System.Boolean –>

Parameters

Name Type Description
obj Object<!– System.Object –>

<!– System.Object –> Go Back

GetHashCode()

Remarks

Return Value

Return Type Description
Int32<!– System.Int32 –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetMarkers(RectangleShape, Int32)

Returns a collection of markers based on the extent and zoomlevel that you passed in.

Remarks

The &lt;strong&gt;GetMarkers&lt;/strong&gt; method creates the makrers based on the current zoomlevel, the specified extent and the special logic of the MarkerOverlay. The returned markers object will be serialized and sent to the client to create client markers.

Return Value

Return Type Description
Collection<Marker><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WebEdition.Marker} –> A collection of marker objects that will be serialized to the client.

Parameters

Name Type Description
worldExtent RectangleShape<!– ThinkGeo.MapSuite.Core.RectangleShape –> The extent that includes all of the markers you want to serialize.
currentZoomLevelId Int32<!– System.Int32 –> An int value that indicates which zoomlevel the map is currently at.

<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlay –> Go Back

GetType()

Remarks

Return Value

Return Type Description
Type<!– System.Type –>

Parameters

Name Type Description

<!– System.Object –> Go Back

ToJson()

Returns a JSON string which contains the information for creating an overlay at the client side.

Remarks

Return Value

Return Type Description
String<!– System.String –> A JSON string which is used to create an overlay at the client side.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

ToString()

Remarks

Return Value

Return Type Description
String<!– System.String –>

Parameters

Name Type Description

<!– System.Object –> Go Back

Protected Methods

Finalize()

Remarks

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetMarkersCore(RectangleShape, Int32)

Returns a collection of markers based on the extent and zoomlevel that you passed in.

Remarks

The GetMarkersCore method allows derived classes to rewrite the logic used for dynamically creating the markers that will be serialized to the client.

Return Value

Return Type Description
Collection<Marker><!– System.Collections.ObjectModel.Collection{ThinkGeo.MapSuite.WebEdition.Marker} –> A collection of Marker objects that will be serialized to the client.

Parameters

Name Type Description
worldExtent RectangleShape<!– ThinkGeo.MapSuite.Core.RectangleShape –> The extent that includes all of the markers you want to serialize.
currentZoomLevelId Int32<!– System.Int32 –> An int value that indicates which zoomlevel the map is currently at.

<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlay –> Go Back

MemberwiseClone()

Remarks

Return Value

Return Type Description
Object<!– System.Object –>

Parameters

Name Type Description

<!– System.Object –> Go Back

OnClick(MarkerOverlayClickEventArgs)

Raises the Click event of the MarkerOverlay object.

Remarks

The &lt;strong&gt;OnClick&lt;/strong&gt; method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.&lt;strong&gt;Notes to Inheritors:&lt;/strong&gt; When overriding &lt;strong&gt;OnClick&lt;/strong&gt; in a derived class, be sure to call the base class's &lt;strong&gt;OnClick&lt;/strong&gt; method so that registered delegates receive the event.

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description
e MarkerOverlayClickEventArgs<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlayClickEventArgs –> The MarkerOverlayClickEventArgs that contains event data.

<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlay –> Go Back

OnTick(EventArgs)

Raises the Tick event of the MarkerOverlay.

Remarks

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description
e EventArgs<!– System.EventArgs –> An System.EventArgs object that contains the event data.

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

RegisterJavaScriptLibraryCore(Page)

Registers a Javascript library URL string to the client HTML page.

Remarks

The &lt;strong&gt;RegisterJavaScriptLibraryCore&lt;/strong&gt; method allows derived classes to override and register their own Javascript library URL to the HTML page.

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description
page Page<!– System.Web.UI.Page –> The page object that is used for registering the javascript library.

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

Public Properties

Attribution

Remarks

Return Value

Return Type
String<!– System.String –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

AutoRefreshInterval

Gets or sets the time interval in which the MarkerOverlay refreshes itself.

Remarks

Return Value

Return Type
TimeSpan<!– System.TimeSpan –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

Id

Gets the identifier for the overlay to be found.

Remarks

For the most updated Info for this topic, please check it here:<a href=“http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.WebEdition.MarkerOverlay#Id” target=“_blank”>http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.WebEdition.MarkerOverlay#Id</a>

Return Value

Return Type
String<!– System.String –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

IsBaseOverlay

Gets or sets a value that indicates whether the overlay is a base overlay.

Remarks

The MarkerOverlay can only be a non-base overlay. If you set the &lt;strong&gt;IsBaseOverlay&lt;/strong&gt; property to true, there will be an exception thrown.

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay(overriden) –> Go Back

IsVisible

Gets or sets a value that indicates whether the overlay is visible on the map.

Remarks

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

IsVisibleInOverlaySwitcher

Gets or sets a value that indicates whether the overlay name is displayed in the OverlaySwitcher.

Remarks

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

Name

Gets or sets the name of the overlay, which will display in the OverlaySwitcher.

Remarks

For the most updated Info for this topic, please check it here:<a href=“http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.WebEdition.MarkerOverlay#Name” target=“_blank”>http://wiki.thinkgeo.com/wiki/ThinkGeo.MapSuite.WebEdition.MarkerOverlay#Name</a>

Return Value

Return Type
String<!– System.String –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

Opacity

Gets or sets the opacity level of the overlay.

Remarks

The &lt;strong&gt;Opacity&lt;/strong&gt; property enables you to specify a level of transparency for the overlay. When this property is set to a value less than 100 percent (1.00), the entire overlay is made more transparent. The lower the value, the more transparent it is. Setting this property to a value of 0 percent (0.00) makes the overlay completely invisible.

Return Value

Return Type
Single<!– System.Single –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

Protected Properties

HasTickEvent

Indicates whether the overlay supports tick event.

Remarks

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

OverlayType

Gets a string that indicates the overlay type.

Remarks

Return Value

Return Type
String<!– System.String –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay(overriden) –> Go Back

Public Events

Click

Occurs when a marker in the overlay is clicked.

Remarks

Event Arguments

Event Arguments
MarkerOverlayClickEventArgs<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlayClickEventArgs –>

<!– ThinkGeo.MapSuite.WebEdition.MarkerOverlay –> Go Back

Tick

Occurs when the number of milliseconds specified in the AutoRefreshInterval property has elapsed and the page is posted to the server.

Remarks

Event Arguments

Event Arguments
EventArgs<!– System.EventArgs –>

<!– ThinkGeo.MapSuite.WebEdition.Overlay –> Go Back

NOTOC WebEdition ThinkGeo.MapSuite.WebEdition UpdateDocumentation

thinkgeo.mapsuite.webedition.markeroverlay.1440040135.txt.gz · Last modified: 2015/09/18 03:08 (external edit)