MapCtrl Class

Print this page
Learn more about Verizon Connect GeoBase.
Get information about the latest release

Map Control Object for Windows Forms.

Inheritance Hierarchy

SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsScrollableControl
          System.Windows.FormsContainerControl
            System.Windows.FormsUserControl
              Telogis.GeoBaseMapCtrl

Namespace: Telogis.GeoBase
Assembly: geobase.net (in geobase.net.dll) Version: 4.99.0.0

Syntax

Copy

public class MapCtrl : UserControl, IMap

Public Class MapCtrl
	Inherits UserControl
	Implements IMap

The MapCtrl type exposes the following members.

Constructors

	Name	Description
	MapCtrl	Create a new Map Control.

Top

Properties

	Name	Description
	AccessibilityObject	Gets the AccessibleObject assigned to the control. (Inherited from Control.)
	AccessibleDefaultActionDescription	Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
	AccessibleDescription	Gets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
	AccessibleName	Gets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
	AccessibleRole	Gets or sets the accessible role of the control (Inherited from Control.)
	ActiveControl	Gets or sets the active control on the container control. (Inherited from ContainerControl.)
	ActiveMouseHandler	Gets the active IMapMouseHandler, or null if there is no handler under the cursor.
	AllowDrop	Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.)
	AllowEdgePan	Gets or sets whether the edges of the map should act as hotspots for panning.
	Anchor	Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control.)
	AutoScaleDimensions	Gets or sets the dimensions that the control was designed to. (Inherited from ContainerControl.)
	AutoScaleMode	Gets or sets the automatic scaling mode of the control. (Inherited from ContainerControl.)
	AutoScroll	Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. (Inherited from ScrollableControl.)
	AutoScrollMargin	Gets or sets the size of the auto-scroll margin. (Inherited from ScrollableControl.)
	AutoScrollMinSize	Gets or sets the minimum size of the auto-scroll. (Inherited from ScrollableControl.)
	AutoScrollOffset	Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). (Inherited from Control.)
	AutoScrollPosition	Gets or sets the location of the auto-scroll position. (Inherited from ScrollableControl.)
	AutoSize	This property is not relevant for this class. (Inherited from UserControl.)
	AutoSizeMode	Gets or sets how the control will resize itself. (Inherited from UserControl.)
	AutoValidate	Gets or sets how the control performs validation when the user changes focus to another control. (Inherited from UserControl.)
	BackBufferRenderer	Gets or sets the back buffer's renderer.
	BackColor	Gets or sets the background color for the control. (Inherited from Control.)
	BackgroundImage	Gets a copy of the Image of the current map. (Overrides ControlBackgroundImage.)
	BackgroundImageLayout	Gets or sets the background image layout as defined in the ImageLayout enumeration. (Inherited from Control.)
	BindingContext	Gets or sets the BindingContext for the control. (Inherited from ContainerControl.)
	BorderStyle	Gets or sets the border style of the user control. (Inherited from UserControl.)
	Bottom	Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control.)
	Bounds	Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.)
	Busy	Returns true if the map is busy (for example, during a render or update).
	CanFocus	Gets a value indicating whether the control can receive focus. (Inherited from Control.)
	CanSelect	Gets a value indicating whether the control can be selected. (Inherited from Control.)
	Capture	Gets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
	CausesValidation	Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control.)
	Center	Gets or sets the current Center of the map.
	CenterLat	Gets or sets the center latitude.
	CenterLon	Gets or sets the center longitude.
	ClientRectangle	Gets the rectangle that represents the client area of the control. (Inherited from Control.)
	ClientSize	Gets or sets the height and width of the client area of the control. (Inherited from Control.)
	CompanyName	Gets the name of the company or creator of the application containing the control. (Inherited from Control.)
	Container	Gets the IContainer that contains the Component. (Inherited from Component.)
	ContainsFocus	Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
	ContextMenu	Gets or sets the shortcut menu associated with the control. (Inherited from Control.)
	ContextMenuStrip	Gets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
	Controls	Gets the collection of controls contained within the control. (Inherited from Control.)
	Created	Gets a value indicating whether the control has been created. (Inherited from Control.)
	CurrentAutoScaleDimensions	Gets the current run-time dimensions of the screen. (Inherited from ContainerControl.)
	Cursor	Gets or sets the cursor that is displayed when the mouse pointer is over the control. (Inherited from Control.)
	CustomMapBehavior	If any custom behavior is desired, handlers for the events can be assigned here. If behavior for an event is added, default behavior will not be executed.
	DataBindings	Gets the data bindings for the control. (Inherited from Control.)
	DefaultMapCtrlBehavior	The default behavior of this MapCtrl.
	DisplayRectangle	Gets the rectangle that represents the virtual display area of the control. (Inherited from ScrollableControl.)
	DisplayScale	Gets or sets the scale of map overlay objects (such as labels, shields, direction arrows, and highlights) relative to the underlying map tiles.
	Disposing	Gets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
	Dock	Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. (Inherited from Control.)
	DockPadding	Gets the dock padding settings for all edges of the control. (Inherited from ScrollableControl.)
	DoubleBuffering	Double buffering allows Renderers to redraw without incurring the cost of a complete map redraw. Renderers on a double buffered map cannot interact with labels.
	DragBehavior	Set the behavior of the left button on the map when dragging.
	EdgePanPixels	The number of pixels around the border where the edge panning is active.
	Enabled	Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.)
	Focused	Gets a value indicating whether the control has input focus. (Inherited from Control.)
	Font	Gets or sets the font of the text displayed by the control. (Inherited from Control.)
	ForeColor	Gets or sets the foreground color of the control. (Inherited from Control.)
	Handle	Gets the window handle that the control is bound to. (Inherited from Control.)
	HasChildren	Gets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
	Heading	Gets or sets the heading (orientation) of the map.
	Height	Gets or sets the height of the control. (Inherited from Control.)
	HitHandler	Gets or sets the IMapMouseHandler hit handler to use.
	HorizontalScroll	Gets the characteristics associated with the horizontal scroll bar. (Inherited from ScrollableControl.)
	ImeMode	Gets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control.)
	InvokeRequired	Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control.)
	IsAccessible	Gets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
	IsDisposed	Gets a value indicating whether the control has been disposed of. (Inherited from Control.)
	IsHandleCreated	Gets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
	IsMirrored	Gets a value indicating whether the control is mirrored. (Inherited from Control.)
	LastMapCached	Get whether the last map was drawn from cache.
	LastMapError	Gets the exception that occured last time the map was drawn, if any.
	LastMapTime	Gets the time taken to render the last map.
	Layers	Gets or sets an array of map layer names. These layers are rendered in accordance with the LayersRenderMode property.
	LayersRenderMode	Gets or sets the render mode used to render the map's Layers.
	LayoutEngine	Gets a cached instance of the control's layout engine. (Inherited from Control.)
	Left	Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control.)
	Location	Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control.)
	Map	Gets the underlying IMap.
	MapQuality	Gets or sets the quality at which the map will be rendered.
	MapScale	Gets the scale of the map.
	Margin	Gets or sets the space between controls. (Inherited from Control.)
	MaximumSize	Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. (Inherited from Control.)
	MaxZoom	Gets or sets the maximum zoom level when operating in local mode.
	MinimumSize	Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify. (Inherited from Control.)
	MinZoom	Gets or sets the minimum zoom level when operating in local mode.
	MouseButton	Gets the mouse button that was used to generate the event.
	Name	Gets or sets the name of the control. (Inherited from Control.)
	Padding	Gets or sets padding within the control. (Inherited from Control.)
	PanEnable	Specifies whether the user should be able to pan the map with the mouse. If this is false, then all dragging behaviors for the map are disabled (including the zoom-to-rect action).
	Parent	Gets or sets the parent container of the control. (Inherited from Control.)
	ParentForm	Gets the form that the container control is assigned to. (Inherited from ContainerControl.)
	Perspective	Gets or sets the map's perspective (if supported by the map).
	PixelSizeMeters	Gets the pixel size in meters.
	PixelSizeMiles	Gets the pixel size in miles.
	PreferredSize	Gets the size of a rectangular area into which the control can fit. (Inherited from Control.)
	ProductName	Gets the product name of the assembly containing the control. (Inherited from Control.)
	ProductVersion	Gets the version of the assembly containing the control. (Inherited from Control.)
	Progressive	Obsolete. For internal use only.
	Projected	Gets or sets whether the map is projected.
	RecreatingHandle	Gets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
	Region	Gets or sets the window region associated with the control. (Inherited from Control.)
	Renderer	The IMapRenderer to use for this map.
	RenderLabels	Gets or sets whether to render labels on the map.
	Right	Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control.)
	RightDragBehavior	Set the behavior of the right button on the map when dragging.
	RightToLeft	Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control.)
	Satellite	Switch satellite imagery on / off.
	SatelliteLayerName	The name of the map layer that will be used to provide satellite imagery. If specified then the imagery will be taken from the appropriate WMS layer in the GeoStream's layers.config file. Otherwise, standard GeoBase satellite imagery will be used.
	Site	Gets or sets the site of the control. (Inherited from Control.)
	Size	Gets or sets the height and width of the control. (Inherited from Control.)
	Style	Gets or sets the MapStyle used to draw the map. Set this value to null to use the default map style.
	StyleName	Gets or sets the name of the style used to draw the map. Set this value to null to use the default map style.
	TabIndex	Gets or sets the tab order of the control within its container. (Inherited from Control.)
	TabStop	Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
	Tag	Gets or sets the object that contains data about the control. (Inherited from Control.)
	Text	Gets or sets the text associated with this control. (Inherited from UserControl.)
	TilePerSuperTile	Gets or sets the number of tiles per supertile.
	TileSize	Gets or sets the size of a tile.
	Top	Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control.)
	TopLevelControl	Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control.)
	UiEnable	Specifies whether the user should be able to zoom and pan using the built-in map UI. This acts as an override for the individual settings of PanEnable and ZoomEnable: if UiEnable is false, both panning and zooming will be disabled, regardless of these more specific flags. If it is true, interactivity is determined by PanEnable and ZoomEnable.
	UseWaitCursor	Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.)
	VerticalScroll	Gets the characteristics associated with the vertical scroll bar. (Inherited from ScrollableControl.)
	Visible	Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
	Warnings	The Warnings generated during the last map render.
	Width	Gets or sets the width of the control. (Inherited from Control.)
	WindowTarget	This property is not relevant for this class. (Inherited from Control.)
	Zoom	Gets or sets the current zoom level.
	ZoomEnable	Specifies whether the user should be able to zoom the map in and out, either by scrolling the mouse wheel or by dragging out a zoom-box. If this is false, then the zoom-to-rect behavior will be disabled, and scrolling the mouse-wheel over the map will have no effect.
	ZoomLevel	Defines the current zoom level for a MapCtrl operating in GeoStream mode. This differs from Zoom, in that ZoomLevel is expressed in terms of the array of Zooms; ZoomLevel is an index into the array.
	Zooms	Defines the set of zoom levels to use when the MapCtrl is operating in GeoStream mode.

Top

Methods

	Name	Description
	BeginInvoke(Delegate)	Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
	BeginInvoke(Delegate, Object)	Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.)
	BringToFront	Brings the control to the front of the z-order. (Inherited from Control.)
	CancelAsync	Cancels an asynchronous update, if one is in progress. Non-functional.
	Contains(Control)	Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
	Contains(LatLon)	Check whether the LatLon coordinates lie within this IMap.
	CreateControl	Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
	CreateGraphics	Creates the Graphics for the control. (Inherited from Control.)
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	Dispose	Releases all resources used by the Component. (Inherited from Component.)
	DoDragDrop	Begins a drag-and-drop operation. (Inherited from Control.)
	DrawToBitmap	Supports rendering to the specified bitmap. (Inherited from Control.)
	EndInvoke	Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	FindForm	Retrieves the form that the control is on. (Inherited from Control.)
	Focus	Sets input focus to the control. (Inherited from Control.)
	GetBackgroundImage	Gets the background image of the current map.
	GetBoundingBox	Gets the BoundingBox of the Map
	GetChildAtPoint(Point)	Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
	GetChildAtPoint(Point, GetChildAtPointSkip)	Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.)
	GetContainerControl	Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetLastError	Returns the error that occurred during the last attempt to draw the map. This will return null if the last map was successfully drawn.
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetMap	Gets the current map Image.
	GetMap(Boolean, MapProgress, Boolean)	Gets an Image of the current map.
	GetNextControl	Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
	GetPreferredSize	Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Hide	Conceals the control from the user. (Inherited from Control.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	Invalidate	Invalidating the map causes it to be redrawn.
	Invalidate(Boolean)	Invalidate the map and specify whether the redraw should be carried out immediately.
	Invalidate(Rectangle)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
	Invalidate(Region)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
	Invalidate(Rectangle, Boolean)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
	Invalidate(Region, Boolean)	Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
	InvalidateBackBuffer	Clears the back buffer that is used for DoubleBuffering.
	Invoke(Delegate)	Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
	Invoke(Delegate, Object)	Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.)
	IsSelected	Check if the given IMapMouseHandler is selected.
	LatLontoXY	Convert from a LatLon to an X,Y location on the map.
	PerformAutoScale	Performs scaling of the container control and its children. (Inherited from ContainerControl.)
	PerformLayout	Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
	PerformLayout(Control, String)	Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
	PointToClient	Computes the location of the specified screen point into client coordinates. (Inherited from Control.)
	PointToScreen	Computes the location of the specified client point into screen coordinates. (Inherited from Control.)
	PreProcessControlMessage	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
	PreProcessMessage	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
	RectangleToClient	Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
	RectangleToScreen	Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
	Refresh	Refresh the current map. (Overrides ControlRefresh.)
	ResetBackColor	Resets the BackColor property to its default value. (Inherited from Control.)
	ResetBindings	Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
	ResetCursor	Resets the Cursor property to its default value. (Inherited from Control.)
	ResetFont	Resets the Font property to its default value. (Inherited from Control.)
	ResetForeColor	Resets the ForeColor property to its default value. (Inherited from Control.)
	ResetImeMode	Resets the ImeMode property to its default value. (Inherited from Control.)
	ResetRightToLeft	Resets the RightToLeft property to its default value. (Inherited from Control.)
	ResetText	Resets the Text property to its default value (Empty). (Inherited from Control.)
	ResumeLayout	Resumes usual layout logic. (Inherited from Control.)
	ResumeLayout(Boolean)	Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
	Scale(Single)	Obsolete. Scales the control and any child controls. (Inherited from Control.)
	Scale(SizeF)	Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
	Scale(Single, Single)	Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
	ScrollControlIntoView	Scrolls the specified child control into view on an auto-scroll enabled control. (Inherited from ScrollableControl.)
	Select	Activates the control. (Inherited from Control.)
	SelectNextControl	Activates the next control. (Inherited from Control.)
	SendToBack	Sends the control to the back of the z-order. (Inherited from Control.)
	SetAutoScrollMargin	Sets the size of the auto-scroll margins. (Inherited from ScrollableControl.)
	SetBounds(Int32, Int32, Int32, Int32)	Sets the bounds of the control to the specified location and size. (Inherited from Control.)
	SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)	Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
	SetProperty	Allows map-specific (internal) properties to be set. For internal use.
	SetRepository	Set the repository to draw the maps with. If not set, then the default repository is used.
	SetSelection	Sets the current selection, and return the old selection.
	Show	Displays the control to the user. (Inherited from Control.)
	SuspendLayout	Temporarily suspends the layout logic for the control. (Inherited from Control.)
	ToString	Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
	Update	Causes the control to redraw the invalidated regions within its client area. (Inherited from Control.)
	Validate	Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. (Inherited from ContainerControl.)
	Validate(Boolean)	Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. (Inherited from ContainerControl.)
	ValidateChildren	Causes all of the child controls within a control that support validation to validate their data. (Inherited from UserControl.)
	ValidateChildren(ValidationConstraints)	Causes all of the child controls within a control that support validation to validate their data. (Inherited from UserControl.)
	XYtoBoundingBox	Gets the BoundingBox of two pixel locations, x1,y1 and x2,y2.
	XYtoLatLon	Gets the LatLon of a point on the map given by x & y coordinates.
	ZoomToBoundingBox(BoundingBox, Int32)	Zooms the map and centers on the given BoundingBox.
	ZoomToBoundingBox(BoundingBox, MapBuffer)	Zooms the map to display the given bounding box with a separate buffer on each side.

Top

Events

	Name	Description
	AutoSizeChanged	Occurs when the AutoSize property changes. (Inherited from UserControl.)
	AutoValidateChanged	Occurs when the AutoValidate property changes. (Inherited from UserControl.)
	BackColorChanged	Occurs when the value of the BackColor property changes. (Inherited from Control.)
	BackgroundImageChanged	Occurs when the value of the BackgroundImage property changes. (Inherited from Control.)
	BackgroundImageLayoutChanged	Occurs when the BackgroundImageLayout property changes. (Inherited from Control.)
	BindingContextChanged	Occurs when the value of the BindingContext property changes. (Inherited from Control.)
	CausesValidationChanged	Occurs when the value of the CausesValidation property changes. (Inherited from Control.)
	CenterChanged	This event handler is called when the map is panned, changing the center location.
	ChangeUICues	Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.)
	Click	Occurs when the control is clicked. (Inherited from Control.)
	ClientSizeChanged	Occurs when the value of the ClientSize property changes. (Inherited from Control.)
	ContextMenuChanged	Occurs when the value of the ContextMenu property changes. (Inherited from Control.)
	ContextMenuStripChanged	Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
	ControlAdded	Occurs when a new control is added to the ControlControlCollection. (Inherited from Control.)
	ControlRemoved	Occurs when a control is removed from the ControlControlCollection. (Inherited from Control.)
	CursorChanged	Occurs when the value of the Cursor property changes. (Inherited from Control.)
	Disposed	Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
	DockChanged	Occurs when the value of the Dock property changes. (Inherited from Control.)
	DoubleClick	Occurs when the control is double-clicked. (Inherited from Control.)
	DragDrop	Occurs when a drag-and-drop operation is completed. (Inherited from Control.)
	DragEnter	Occurs when an object is dragged into the control's bounds. (Inherited from Control.)
	DragLeave	Occurs when an object is dragged out of the control's bounds. (Inherited from Control.)
	DragOver	Occurs when an object is dragged over the control's bounds. (Inherited from Control.)
	EnabledChanged	Occurs when the Enabled property value has changed. (Inherited from Control.)
	Enter	Occurs when the control is entered. (Inherited from Control.)
	FontChanged	Occurs when the Font property value changes. (Inherited from Control.)
	ForeColorChanged	Occurs when the ForeColor property value changes. (Inherited from Control.)
	GiveFeedback	Occurs during a drag operation. (Inherited from Control.)
	GotFocus	Occurs when the control receives focus. (Inherited from Control.)
	HandleCreated	Occurs when a handle is created for the control. (Inherited from Control.)
	HandleDestroyed	Occurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
	HelpRequested	Occurs when the user requests help for a control. (Inherited from Control.)
	ImeModeChanged	Occurs when the ImeMode property has changed. (Inherited from Control.)
	Invalidated	Occurs when a control's display requires redrawing. (Inherited from Control.)
	KeyDown	Occurs when a key is pressed while the control has focus. (Inherited from Control.)
	KeyPress	Occurs when a character. space or backspace key is pressed while the control has focus. (Inherited from Control.)
	KeyUp	Occurs when a key is released while the control has focus. (Inherited from Control.)
	Layout	Occurs when a control should reposition its child controls. (Inherited from Control.)
	Leave	Occurs when the input focus leaves the control. (Inherited from Control.)
	Load	Occurs before the control becomes visible for the first time. (Inherited from UserControl.)
	LocationChanged	Occurs when the Location property value has changed. (Inherited from Control.)
	LostFocus	Occurs when the control loses focus. (Inherited from Control.)
	MapSizeChanged	This event handler is called when the map is resized.
	MarginChanged	Occurs when the control's margin changes. (Inherited from Control.)
	MouseCaptureChanged	Occurs when the control loses mouse capture. (Inherited from Control.)
	MouseClick	Occurs when the control is clicked by the mouse. (Inherited from Control.)
	MouseDoubleClick	Occurs when the control is double clicked by the mouse. (Inherited from Control.)
	MouseDown	Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.)
	MouseEnter	Occurs when the mouse pointer enters the control. (Inherited from Control.)
	MouseHover	Occurs when the mouse pointer rests on the control. (Inherited from Control.)
	MouseLeave	Occurs when the mouse pointer leaves the control. (Inherited from Control.)
	MouseMove	Occurs when the mouse pointer is moved over the control. (Inherited from Control.)
	MouseUp	Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.)
	MouseWheel	Occurs when the mouse wheel moves while the control has focus. (Inherited from Control.)
	Move	Occurs when the control is moved. (Inherited from Control.)
	OnRedraw	Called when the map has changed.
	OnRenderComplete	This EventHandler is called when rendering is complete.
	OnRenderException	This EventHandler is called when an exception is encountered during rendering.
	OnRenderStart	This EventHandler is called when rendering is begun.
	OnZoomLevelChanged	This EventHandler is called when the ZoomLevel has changed. Note that this is only valid if the current repository is a GeoStreamRepository
	PaddingChanged	Occurs when the control's padding changes. (Inherited from Control.)
	Paint	Occurs when the control is redrawn. (Inherited from Control.)
	ParentChanged	Occurs when the Parent property value changes. (Inherited from Control.)
	PreviewKeyDown	Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
	QueryAccessibilityHelp	Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.)
	QueryContinueDrag	Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control.)
	RegionChanged	Occurs when the value of the Region property changes. (Inherited from Control.)
	Resize	Occurs when the control is resized. (Inherited from Control.)
	RightToLeftChanged	Occurs when the RightToLeft property value changes. (Inherited from Control.)
	Scroll	Occurs when the user or code scrolls through the client area. (Inherited from ScrollableControl.)
	SizeChanged	Occurs when the Size property value changes. (Inherited from Control.)
	StyleChanged	Occurs when the control style changes. (Inherited from Control.)
	SystemColorsChanged	Occurs when the system colors change. (Inherited from Control.)
	TabIndexChanged	Occurs when the TabIndex property value changes. (Inherited from Control.)
	TabStopChanged	Occurs when the TabStop property value changes. (Inherited from Control.)
	TextChanged	Raises the TextChanged event. (Inherited from UserControl.)
	Validated	Occurs when the control is finished validating. (Inherited from Control.)
	Validating	Occurs when the control is validating. (Inherited from Control.)
	VisibleChanged	Occurs when the Visible property value changes. (Inherited from Control.)
	ZoomChanged	This event handler is called when the zoom level changes.

Top

Fields

	Name	Description
	ClickToCenter	A left-click will center the map on the mouse location, if set to true and DragBehavior is set to Box.
	DrawMaps	Set to false to prevent maps being drawn.
	RememberClip	When true, the map will try to remember Clip before use and set it back to this value after use. When false, the map will clear Clip after use.

Top

Remarks

Use this object for Windows Forms applications. For ASP.NET and other server applications, use the Map Object or the Map class.

There are a number of functions common to most MapCtrl applications. These functions include:

Displaying custom objects on the map.
Responding to mouse clicks.

Custom objects can be displayed on the map by implementing the IMapRenderer interface. An example of such an object is the PushPin location marker. To display multiple objects it is necessary to use a RendererList - essentially a collection of renderable objects. The Tutorials section contains a tutorial on IMapRenderers which also covers RendererLists.

Rendered objects that need to respond to mouse clicks should implement the IMapMouseHandler interface. The MapMouseEventsHandler may be used to simplify this procedure. The application example in the Tutorials section contains examples of mouse event handling.

Two keyboard-modifiers affect mouse behavior in MapCtrl by default.

When the Shift key is pressed, the selected mouse function temporarily inverts: The pan tool becomes the area selection tool, and the area selection tool becomes the pan tool.
When the Ctrl key is pressed, mouse wheel zoom intervals are temporarily decreased.

Reference

Telogis.GeoBase Namespace