The main map view component. This class cannot be inherited.
The following tables list the members exposed by MapView.
Public Constructors
Private Fields
| Name | Description | |
|---|---|---|
|
components | Required designer variable. |
|
CurrentNextHandle | Keeps track of the next layer handle to use. Use this, rather than m_AddedLayers.Count, to maintain layer handles. Using m_AddedLayers.Count may cause duplicate layer handles to be used in the same session, which could lead to errors by developers using the control. |
|
m_AddedLayers | Layers currently added to the map. |
|
m_BackBuffer | Background buffer -- used to speed up rendering when the control is invalidated due to minimize, coverup, etc. |
|
m_BackColor | Background color of the map display for transparent polygons and for regions outside of the map data. |
|
m_CurrentExtents | Current extents of the map view. |
|
m_CursorMode | Current mouse cursor mode for clicks on the map. |
|
m_HaltDrawing | Indicates that drawing should temporarily be halted. |
|
m_LayerPositions | Layer positions of layers in the map. Key is the layerhandle; position in the array is the layer position. |
|
m_MapResizeBehavior | Current behavior when resizing the map. |
|
m_MouseWheelZooms | Indicates whether the mouse wheel should zoom when the control has focus. |
|
m_Panning_CaptureX | Captured Projected X coordinate for panning line. |
|
m_Panning_CaptureY | Captured Projected Y coordinate for panning line. |
|
m_Panning_End | Captured Screen Y coordinate for panning line. |
|
m_Panning_ReversibleDrawn | Indicates whether a panning line has been drawn. |
|
m_Panning_Start | Captured Screen X coordinate for panning line. |
|
m_pixelPerProjectionX | The number of pixels per projected coordinate in the X direction. |
|
m_pixelPerProjectionY | The number of pixels per projected coordinate in the Y direction. |
|
m_ZoomPercent | Current extents percentage that a zoom operation will affect the map with. |
Public Properties
| Name | Description | |
|---|---|---|
|
AccessibilityObject | Gets the |
|
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) |
|
AllowDrop | Gets or sets a value indicating whether the control can accept data that the user drags onto it. (inherited from Control) |
|
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 |
|
AutoScrollPosition | Gets or sets the location of the auto-scroll position. (inherited from ScrollableControl) |
|
AutoSize | (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) |
|
BackColor | Overridden. Indicates or sets the background color of the map surface. |
|
BackgroundImage | Gets or sets the background image displayed in the control. (inherited from Control) |
|
BackgroundImageLayout | Gets or sets the background image layout as defined in the |
|
BindingContext | (inherited from ContainerControl) |
|
BorderStyle | Gets or sets the border style of the tree view 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) |
|
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) |
|
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 |
|
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 |
|
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) |
|
DataBindings | Gets the data bindings for the control. (inherited from Control) |
|
DisplayExtents | Returns the current extents visible in the map. |
|
DisplayRectangle | Gets the rectangle that represents the virtual display area of the control. (inherited from ScrollableControl) |
|
Disposing | Gets a value indicating whether the base |
|
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) |
|
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) |
|
FullExtents | Returns the full extents of all layers loaded in the map. |
|
HaltDrawing | Indicates that the map should temporarily avoid redrawing. |
|
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) |
|
Height | Gets or sets the height of the control. (inherited from Control) |
|
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) |
|
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) |
|
Margin | Gets or sets the space between controls. (inherited from Control) |
|
MaximumSize | Gets or sets the size that is the upper limit that |
|
MinimumSize | Gets or sets the size that is the lower limit that |
|
MouseCursorMode | Gets or sets the mouse cursor mode (i.e., zoom in, none) |
|
MouseWheelZooms | Determines or sets whether the mouse wheel zooms in and out. |
|
Name | Gets or sets the name of the control. (inherited from Control) |
|
NumLayers | Returns the number of layers currently in the map. |
|
Padding | Gets or sets padding within the control. (inherited from Control) |
|
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) |
|
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) |
|
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) |
|
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) |
|
RightToLeft | Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (inherited from Control) |
|
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) |
|
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 | (inherited from UserControl) |
|
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 |
|
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 is displayed. (inherited from Control) |
|
Width | Gets or sets the width of the control. (inherited from Control) |
|
WindowTarget | (inherited from Control) |
|
ZoomPercent | Determines or sets the percentage that a zoom operation will apply. |
Protected Properties
| Name | Description | |
|---|---|---|
|
AutoScaleFactor | Gets the scaling factor between the current and design-time automatic scaling dimensions. (inherited from ContainerControl) |
|
CanRaiseEvents | Determines if events can be raised on the control. (inherited from Control) |
|
CreateParams | (inherited from UserControl) |
|
DefaultCursor | Gets or sets the default cursor for the control. (inherited from Control) |
|
DefaultImeMode | Gets the default Input Method Editor (IME) mode supported by the control. (inherited from Control) |
|
DefaultMargin | Gets the space, in pixels, that is specified by default between controls. (inherited from Control) |
|
DefaultMaximumSize | Gets the length and height, in pixels, that is specified as the default maximum size of a control. (inherited from Control) |
|
DefaultMinimumSize | Gets the length and height, in pixels, that is specified as the default minimum size of a control. (inherited from Control) |
|
DefaultPadding | Gets the internal spacing, in pixels, of the contents of a control. (inherited from Control) |
|
DefaultSize | (inherited from UserControl) |
|
DesignMode | Gets a value that indicates whether the |
|
DoubleBuffered | Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. (inherited from Control) |
|
Events | Gets the list of event handlers that are attached to this |
|
FontHeight | Gets or sets the height of the font of the control. (inherited from Control) |
|
HScroll | Gets or sets a value indicating whether the horizontal scroll bar is visible. (inherited from ScrollableControl) |
|
ResizeRedraw | Gets or sets a value indicating whether the control redraws itself when resized. (inherited from Control) |
|
ScaleChildren | Gets a value that determines the scaling of child controls. (inherited from Control) |
|
VScroll | Gets or sets a value indicating whether the vertical scroll bar is visible. (inherited from ScrollableControl) |
Protected Internal Properties
| Name | Description | |
|---|---|---|
|
RenderRightToLeft | (inherited from Control) |
|
ShowFocusCues | Gets a value indicating whether the control should display focus rectangles. (inherited from Control) |
|
ShowKeyboardCues | Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (inherited from Control) |
Public Methods
| Name | Description | |
|---|---|---|
|
AddLayer | Overloaded. M:MapWinView.MapView.AddLayer(MapWinView.RenderableDrawingLayer@,System.Int32) Adds a new layer to the map. Returns the LayerHandle of the added layer. |
|
BeginInvoke | Overloaded. Executes a delegate asynchronously 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) |
|
Contains | Retrieves a value indicating whether the specified control is a child of the control. (inherited from Control) |
|
CreateControl | Forces the creation of the control, including the creation of the handle and any child controls. (inherited from Control) |
|
CreateGraphics | Creates the |
|
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 | Overloaded. Overload:System.Windows.Forms.ContainerControl.Dispose Releases the resources used by the container. |
|
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 |
|
Equals | Determines whether the specified |
|
ExtentsFullyContained | Determines if the given extents are fully contained in the container. |
|
FindForm | Retrieves the form that the control is on. (inherited from Control) |
|
Focus | Sets input focus to the control. (inherited from Control) |
|
GetChildAtPoint | Overloaded. Retrieves the child control at a specified location. (inherited from Control) |
|
GetContainerControl | Returns the next |
|
GetHashCode | Serves as a hash function for a particular type. |
|
GetLayer | Returns the specified layer through the LayerObject "out" parameter. |
|
GetLayerHandle | Returns the handle of the later at the specified position. For positions: (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer) |
|
GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (inherited from MarshalByRefObject) |
|
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 |
|
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 | Overloaded. Invalidates a specific region of the control and causes a paint message to be sent to the control. (inherited from Control) |
|
Invoke | Overloaded. Executes a delegate on the thread that owns the control's underlying window handle. (inherited from Control) |
|
LayerPosition | Returns the position of the specified layer. (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer) |
|
MoveLayerTo | Moves the specified layer to the specified position. (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer) |
|
MoveLayerToBottom | Moves the specified layer to the bottom (first drawn). |
|
MoveLayerToTop | Moves the specified layer to the top (last drawn). |
|
OutOfView | Overloaded. M:MapWinView.MapView.OutOfView(MapWinData.Envelope,MapWinData.Envelope) Determines if the specified extent is out of the specified view. |
|
PerformAutoScale | Performs scaling of the container control and its children. (inherited from ContainerControl) |
|
PerformLayout | Overloaded. Forces the control to apply layout logic to child controls. (inherited from Control) |
|
PixelToProj | Converts a pixel point in terms of the control into projected coordinates in terms of the map data. |
|
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) |
|
ProjToPixel | Converts a projected coordinate in terms of the map data into pixels in terms of the control. |
|
ProjToPixelX | Converts a projected X coordinate in terms of the map data into pixels in terms of the control. |
|
ProjToPixelY | Converts a projected Y coordinate in terms of the map data into pixels in terms of the 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) |
|
Redraw | Causes the map to redraw. Call after any important manual update. |
|
Refresh | Forces the control to invalidate its client area and immediately redraw itself and any child controls. (inherited from Control) |
|
RemoveLayer | Removes the specified layer from the map. |
|
ResetBackColor | (inherited from Control) |
|
ResetBindings | (inherited from Control) |
|
ResetCursor | (inherited from Control) |
|
ResetFont | (inherited from Control) |
|
ResetForeColor | (inherited from Control) |
|
ResetImeMode | (inherited from Control) |
|
ResetRightToLeft | (inherited from Control) |
|
ResetText | Resets the |
|
ResumeLayout | Overloaded. Resumes the usual layout logic. (inherited from Control) |
|
Scale | Overloaded. Scales the 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 | Overloaded. Activates the control. (inherited from ContainerControl) |
|
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 | Overloaded. Sets the bounds of the control. (inherited from Control) |
|
Show | Displays the control to the user. (inherited from Control) |
|
Snapshot | Overloaded. M:MapWinView.MapView.Snapshot(MapWinData.Envelope,System.Int32,System.Int32) Returns a System.Drawing.Bitmap with the rendered map of the specified view, of the specified size. |
|
SuspendLayout | Temporarily suspends the layout logic for the control. (inherited from Control) |
|
ToString | Returns a |
|
Update | Causes the control to redraw the invalidated regions within its client area. (inherited from Control) |
|
Validate | Overloaded. Verifies the value of the control losing focus by causing the |
|
ValidateChildren | Overloaded. Overload:System.Windows.Forms.ContainerControl.ValidateChildren Causes all of the child controls within a control that support validation to validate their data. (inherited from UserControl) |
|
ZoomIn | Overloaded. M:MapWinView.MapView.ZoomIn Zooms in about the center of the map. |
|
ZoomOut | Overloaded. M:MapWinView.MapView.ZoomOut Zooms out about the center of the map. |
|
ZoomToFullExtents | Zooms to the full extents of the map. |
|
ZoomToLayer | Zooms to the full extents of the map. |
Protected Methods
| Name | Description | |
|---|---|---|
|
AccessibilityNotifyClients | Overloaded. Notifies the accessibility client applications of |
|
AdjustFormScrollbars | (inherited from ContainerControl) |
|
CreateAccessibilityInstance | Creates a new accessibility object for the control. (inherited from Control) |
|
CreateControlsInstance | Creates a new instance of the control collection for the control. (inherited from Control) |
|
CreateHandle | Creates a handle for the control. (inherited from Control) |
|
DefWndProc | Sends the specified message to the default window procedure. (inherited from |