Skip to content

< Back


InteractiveOverlay

Namespace: ThinkGeo.Core

This class inherits from Overlay abstract class. This specified overlay describle the interative process with MapControl using Mouse or Keyborad.

public abstract class InteractiveOverlay : Overlay, System.IDisposable

Inheritance ObjectOverlayInteractiveOverlay
Implements IDisposable

Properties

DoubleClickMaxIntervalInMS

Gets and sets click interval.

It defines the maximum time interval for double click. It will be reconized as 2 single clickes if the internal time is greater than this property.

public static int DoubleClickMaxIntervalInMS { get; set; }

Property Value

Int32

DrawingMarginPercentage

This property gets and sets the extra drawing margin as a percentage around the map that draw to ensure that labeling is correct.

public double DrawingMarginPercentage { get; set; }

Property Value

Double

        This property gets the extra drawing margin as a percentage around the map that
        draws to ensure that labeling is correct.

Remarks:

This extra margin that we draw exists so that labels match up if they are partially cut off.

RenderMode

This property gets and sets the render mode for drawing this overlay.

public RenderMode RenderMode { get; set; }

Property Value

RenderMode

Remarks:

Set GdiPlus to render map image with Gdi+. We recommend use this value with large data.

Set DrawingVisual to render map image with DrawingVisual feature in WPF. Use it when the spatial data is small to get better responding.

CanRefreshRegion

public bool CanRefreshRegion { get; protected set; }

Property Value

Boolean

IsBase

public bool IsBase { get; set; }

Property Value

Boolean

Name

Gets or sets the name of this overaly.

public string Name { get; set; }

Property Value

String

MapArguments

Gets or sets current map information which will be used for calculating mechanism.

public MapArguments MapArguments { get; set; }

Property Value

MapArguments

OverlayCanvas

Gets or sets the actual canvas which maintains all the visual elements on the overlay.

public Canvas OverlayCanvas { get; set; }

Property Value

Canvas

DrawingExceptionMode

This property gets and sets the DrawingExceptionMode used when an exception occurs during drawing.

public DrawingExceptionMode DrawingExceptionMode { get; set; }

Property Value

DrawingExceptionMode

IsVisible

Gets or sets if this overlay is visible.

public bool IsVisible { get; set; }

Property Value

Boolean

RefreshTypeOnResize

public OverlayRefreshType RefreshTypeOnResize { get; set; }

Property Value

OverlayRefreshType

Attribution

public string Attribution { get; set; }

Property Value

String

IsEmpty

This property gets if this overlay is empty or not.

public bool IsEmpty { get; }

Property Value

Boolean

Remarks:

This property enhances the performance of the overlay while drawing. If is true, we will skip drawing this overlay and continue drawing the next overlay.

AutoRefreshInterval

public TimeSpan AutoRefreshInterval { get; set; }

Property Value

TimeSpan

Methods

MouseDown(InteractionArguments)

This method will simulate the MouseDown interaction.

public InteractiveResult MouseDown(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseDownCore(InteractionArguments)

This protected virtual method is the Core method of MouseDown API.

protected InteractiveResult MouseDownCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Exceptions

ArgumentNullException
If you pass a null as the interactionArguments, we will throw an ArgumentNullException.

MouseMove(InteractionArguments)

This method will simulate the MouseMove interaction.

public InteractiveResult MouseMove(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseMoveCore(InteractionArguments)

This protected virtual method is the Core method of MouseMove API.

protected InteractiveResult MouseMoveCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

ManipulationStarted(InteractionArguments)

public InteractiveResult ManipulationStarted(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

ManipulationStartedCore(InteractionArguments)

protected InteractiveResult ManipulationStartedCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

ManipulationDelta(InteractionArguments)

public InteractiveResult ManipulationDelta(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

ManipulationDeltaCore(InteractionArguments)

protected InteractiveResult ManipulationDeltaCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

ManipulationCompleted(InteractionArguments)

public InteractiveResult ManipulationCompleted(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

ManipulationCompletedCore(InteractionArguments)

protected InteractiveResult ManipulationCompletedCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments

Returns

InteractiveResult

MouseUp(InteractionArguments)

This method will simulate the MouseUp interaction.

public InteractiveResult MouseUp(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseUpCore(InteractionArguments)

This protected virtual method is the Core method of MouseUp API.

protected InteractiveResult MouseUpCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Exceptions

ArgumentNullException
If you pass a null as the interactionArguments, we will throw an ArgumentNullException.

MouseClick(InteractionArguments)

This method will simulate the MouseClick interaction.

public InteractiveResult MouseClick(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseClickCore(InteractionArguments)

This protected virtual method is the Core method of MouseClick API.

protected InteractiveResult MouseClickCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

MouseDoubleClick(InteractionArguments)

This method will simulate the MouseDoubleClick interaction.

public InteractiveResult MouseDoubleClick(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseDoubleClickCore(InteractionArguments)

This protected virtual method is the Core method of MouseDoubleClick API.

protected InteractiveResult MouseDoubleClickCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Exceptions

ArgumentNullException
If you pass a null as the interactionArguments, we will throw an ArgumentNullException.

MouseWheel(InteractionArguments)

This method will simulate the MouseWheel interaction.

public InteractiveResult MouseWheel(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Remarks:

This method is the concrete wrapper for its virtual Core method.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

MouseWheelCore(InteractionArguments)

This protected virtual method is the Core method of MouseWheel API.

protected InteractiveResult MouseWheelCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
This parameter is the interaction auguments for the method.

Returns

InteractiveResult
Interaction results of this method.

Exceptions

ArgumentNullException
If you pass a null as the interactionArguments, we will throw an ArgumentNullException.

MouseLeave(InteractionArguments)

Occurs when the mouse leave the map.

public InteractiveResult MouseLeave(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
Interaction arguments for mouse leave the map.

Returns

InteractiveResult
A interactive result for mouse leave the map.

MouseLeaveCore(InteractionArguments)

Occurs when the mouse leave the map.

protected InteractiveResult MouseLeaveCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
Interaction arguments for mouse leaving the map.

Returns

InteractiveResult
A interactive result for mouse leaving the map.

MouseEnter(InteractionArguments)

Occurs when the mouse enter the map.

public InteractiveResult MouseEnter(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
Interaction arguments for mouse entering the map.

Returns

InteractiveResult
A interactive result for mouse entering the map.

MouseEnterCore(InteractionArguments)

Occurs when the mouse enter the map.

protected InteractiveResult MouseEnterCore(InteractionArguments interactionArguments)

Parameters

interactionArguments InteractionArguments
Interaction arguments for mouse entering the map.

Returns

InteractiveResult
A interactive result for mouse entering the map.

KeyUp(KeyEventInteractionArguments)

Occurs when key up on the map.

public InteractiveResult KeyUp(KeyEventInteractionArguments interactionArguments)

Parameters

interactionArguments KeyEventInteractionArguments
Interaction arguments for key up on the map.

Returns

InteractiveResult
A interactive result for key up on the map.

KeyUpCore(KeyEventInteractionArguments)

Occurs when key up on the map.

protected InteractiveResult KeyUpCore(KeyEventInteractionArguments interactionArguments)

Parameters

interactionArguments KeyEventInteractionArguments
Interaction arguments for key up on the map.

Returns

InteractiveResult
A interactive result for key up on the map.

KeyDown(KeyEventInteractionArguments)

Occurs when key down on the map.

public InteractiveResult KeyDown(KeyEventInteractionArguments interactionArguments)

Parameters

interactionArguments KeyEventInteractionArguments
Interaction arguments for key down on the map.

Returns

InteractiveResult
A interactive result for key down on the map.

KeyDownCore(KeyEventInteractionArguments)

Occurs when key down on the map.

protected InteractiveResult KeyDownCore(KeyEventInteractionArguments interactionArguments)

Parameters

interactionArguments KeyEventInteractionArguments
Interaction arguments for key down on the map.

Returns

InteractiveResult
A interactive result for key down on the map.

OnMapMouseDown(MapMouseDownInteractiveOverlayEventArgs)

This event will be fired when MapMouseDown is called.

protected void OnMapMouseDown(MapMouseDownInteractiveOverlayEventArgs e)

Parameters

e MapMouseDownInteractiveOverlayEventArgs
The MapMouseDownInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseMove(MapMouseMoveInteractiveOverlayEventArgs)

This event will be fired when MapMouseMove is called.

protected void OnMapMouseMove(MapMouseMoveInteractiveOverlayEventArgs e)

Parameters

e MapMouseMoveInteractiveOverlayEventArgs
The MapMouseMoveInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseUp(MapMouseUpInteractiveOverlayEventArgs)

This event will be fired when MapMouseUp is called.

protected void OnMapMouseUp(MapMouseUpInteractiveOverlayEventArgs e)

Parameters

e MapMouseUpInteractiveOverlayEventArgs
The MapMouseUpInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseClick(MapMouseClickInteractiveOverlayEventArgs)

This event will be fired when MapMouseClick is called.

protected void OnMapMouseClick(MapMouseClickInteractiveOverlayEventArgs e)

Parameters

e MapMouseClickInteractiveOverlayEventArgs
The MapMouseClickInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseDoubleClick(MapMouseDoubleClickInteractiveOverlayEventArgs)

This event will be fired when MapMouseDoubleClick is called.

protected void OnMapMouseDoubleClick(MapMouseDoubleClickInteractiveOverlayEventArgs e)

Parameters

e MapMouseDoubleClickInteractiveOverlayEventArgs
The MapMouseDoubleClickInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseWheel(MapMouseWheelInteractiveOverlayEventArgs)

This event will be fired when MapMouseWheel is called.

protected void OnMapMouseWheel(MapMouseWheelInteractiveOverlayEventArgs e)

Parameters

e MapMouseWheelInteractiveOverlayEventArgs
The MapMouseWheelInteractiveOverlayEventArgs passed for the event raised.

OnMapMouseLeave(MapMouseLeaveInteractiveOverlayEventArgs)

Occurs when mouse leave from the map object.

protected void OnMapMouseLeave(MapMouseLeaveInteractiveOverlayEventArgs e)

Parameters

e MapMouseLeaveInteractiveOverlayEventArgs
Event argument for the MapMouseLeave event.

OnMapMouseEnter(MapMouseEnterInteractiveOverlayEventArgs)

Occurs when mouse enter on the map object.

protected void OnMapMouseEnter(MapMouseEnterInteractiveOverlayEventArgs e)

Parameters

e MapMouseEnterInteractiveOverlayEventArgs
Event argument for the MapMouseEnter event.

OnMapKeyUp(MapKeyUpInteractiveOverlayEventArgs)

Occurs when key up on the map object.

protected void OnMapKeyUp(MapKeyUpInteractiveOverlayEventArgs e)

Parameters

e MapKeyUpInteractiveOverlayEventArgs
Event argument for the MapKeyUp event.

OnMapKeyDown(MapKeyDownInteractiveOverlayEventArgs)

Occurs when key down on the map object.

protected void OnMapKeyDown(MapKeyDownInteractiveOverlayEventArgs e)

Parameters

e MapKeyDownInteractiveOverlayEventArgs
Event argument for the MapKeyDown event.

DrawCore(RectangleShape, OverlayRefreshType)

This method draws the InterativeInterativeOverlay abstract class. You have to override this API in its sub concrete classes, or it will throw NotImplementedException.

protected void DrawCore(RectangleShape targetExtent, OverlayRefreshType overlayRefreshType)

Parameters

targetExtent RectangleShape
This parameter is the world extent to draw.

overlayRefreshType OverlayRefreshType
This parameter indicates whether the overlay needs to be refreshed.

DrawTileAsync(LayerTileView)

internal Task DrawTileAsync(LayerTileView layerTile)

Parameters

layerTile LayerTileView

Returns

Task

ClearTile(LayerTileView)

internal void ClearTile(LayerTileView layerTile)

Parameters

layerTile LayerTileView

GetBufferedExtent(RectangleShape, Double)

internal RectangleShape GetBufferedExtent(RectangleShape targetExtent, double resolution)

Parameters

targetExtent RectangleShape

resolution Double

Returns

RectangleShape

DrawTileAsyncCore(GeoCanvas)

protected Task DrawTileAsyncCore(GeoCanvas geoCanvas)

Parameters

geoCanvas GeoCanvas

Returns

Task

Events

MapMouseDown

This event will be fired when Mouse pressed Down on the Map.

public event EventHandler<MapMouseDownInteractiveOverlayEventArgs> MapMouseDown;

MapMouseMove

This event will be fired when Mouse moved on the Map.

public event EventHandler<MapMouseMoveInteractiveOverlayEventArgs> MapMouseMove;

MapMouseUp

This event will be fired when Mouse released up on the Map.

public event EventHandler<MapMouseUpInteractiveOverlayEventArgs> MapMouseUp;

MapMouseClick

This event will be fired when Mouse clicked(mouse up and mouse down in the same postion) on the Map.

public event EventHandler<MapMouseClickInteractiveOverlayEventArgs> MapMouseClick;

MapMouseDoubleClick

This event will be fired when Mouse double clicked on the Map.

public event EventHandler<MapMouseDoubleClickInteractiveOverlayEventArgs> MapMouseDoubleClick;

MapMouseWheel

This event will be fired when Mouse wheel on the Map.

public event EventHandler<MapMouseWheelInteractiveOverlayEventArgs> MapMouseWheel;

MapMouseLeave

Occurs when mouse leave the map canvas.

public event EventHandler<MapMouseLeaveInteractiveOverlayEventArgs> MapMouseLeave;

MapMouseEnter

Occurs when mouse enter the map canvas.

public event EventHandler<MapMouseEnterInteractiveOverlayEventArgs> MapMouseEnter;

MapKeyDown

Occurs when key down on the map canvas.

public event EventHandler<MapKeyDownInteractiveOverlayEventArgs> MapKeyDown;

MapKeyUp

Occurs when key up on the map canvas.

public event EventHandler<MapKeyUpInteractiveOverlayEventArgs> MapKeyUp;

Drawing

This event raises before the overlay is drawing.

public event EventHandler<DrawingOverlayEventArgs> Drawing;

Drawn

This event raises after the overlay is drawn.

public event EventHandler<DrawnOverlayEventArgs> Drawn;

DrawingAttribution

public event EventHandler<DrawingAttributionOverlayEventArgs> DrawingAttribution;

DrawnAttribution

public event EventHandler<DrawnAttributionOverlayEventArgs> DrawnAttribution;

< Back