The main map view component. This class cannot be inherited.


The following tables list the members exposed by MapView.

Public Constructors

  Name Description
Public method MapView Constructor. Sets paining styles.
Top

Private Fields

  Name Description
Private field components Required designer variable.
Private field 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.
Private field m_AddedLayers Layers currently added to the map.
Private field m_BackBuffer Background buffer -- used to speed up rendering when the control is invalidated due to minimize, coverup, etc.
Private field m_BackColor Background color of the map display for transparent polygons and for regions outside of the map data.
Private field m_CurrentExtents Current extents of the map view.
Private field m_CursorMode Current mouse cursor mode for clicks on the map.
Private field m_HaltDrawing Indicates that drawing should temporarily be halted.
Private field m_LayerPositions Layer positions of layers in the map. Key is the layerhandle; position in the array is the layer position.
Private field m_MapResizeBehavior Current behavior when resizing the map.
Private field m_MouseWheelZooms Indicates whether the mouse wheel should zoom when the control has focus.
Private field m_Panning_CaptureX Captured Projected X coordinate for panning line.
Private field m_Panning_CaptureY Captured Projected Y coordinate for panning line.
Private field m_Panning_End Captured Screen Y coordinate for panning line.
Private field m_Panning_ReversibleDrawn Indicates whether a panning line has been drawn.
Private field m_Panning_Start Captured Screen X coordinate for panning line.
Private field m_pixelPerProjectionX The number of pixels per projected coordinate in the X direction.
Private field m_pixelPerProjectionY The number of pixels per projected coordinate in the Y direction.
Private field m_ZoomPercent Current extents percentage that a zoom operation will affect the map with.
Top

Public Properties

  Name Description
Public property AccessibilityObject Gets the AccessibleObject assigned to the control. (inherited from Control)
Public property AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications. (inherited from Control)
Public property AccessibleDescription Gets or sets the description of the control used by accessibility client applications. (inherited from Control)
Public property AccessibleName Gets or sets the name of the control used by accessibility client applications. (inherited from Control)
Public property AccessibleRole Gets or sets the accessible role of the control (inherited from Control)
Public property ActiveControl Gets or sets the active control on the container control. (inherited from ContainerControl)
Public property AllowDrop Gets or sets a value indicating whether the control can accept data that the user drags onto it. (inherited from Control)
Public property 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)
Public property AutoScaleDimensions Gets or sets the dimensions that the control was designed to. (inherited from ContainerControl)
Public property AutoScaleMode Gets or sets the automatic scaling mode of the control. (inherited from ContainerControl)
Public property 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)
Public property AutoScrollMargin Gets or sets the size of the auto-scroll margin. (inherited from ScrollableControl)
Public property AutoScrollMinSize Gets or sets the minimum size of the auto-scroll. (inherited from ScrollableControl)
Public property AutoScrollOffset Gets or sets where this control is scrolled to in ScrollControlIntoView. (inherited from Control)
Public property AutoScrollPosition Gets or sets the location of the auto-scroll position. (inherited from ScrollableControl)
Public property AutoSize   (inherited from UserControl)
Public property AutoSizeMode Gets or sets how the control will resize itself. (inherited from UserControl)
Public property AutoValidate Gets or sets how the control performs validation when the user changes focus to another control. (inherited from UserControl)
Public property BackColor Overridden. Indicates or sets the background color of the map surface.
Public property BackgroundImage Gets or sets the background image displayed in the control. (inherited from Control)
Public property BackgroundImageLayout Gets or sets the background image layout as defined in the ImageLayout enumeration. (inherited from Control)
Public property BindingContext   (inherited from ContainerControl)
Public property BorderStyle Gets or sets the border style of the tree view control. (inherited from UserControl)
Public property 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)
Public property 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)
Public property CanFocus Gets a value indicating whether the control can receive focus. (inherited from Control)
Public property CanSelect Gets a value indicating whether the control can be selected. (inherited from Control)
Public property Capture Gets or sets a value indicating whether the control has captured the mouse. (inherited from Control)
Public property 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)
Public property ClientRectangle Gets the rectangle that represents the client area of the control. (inherited from Control)
Public property ClientSize Gets or sets the height and width of the client area of the control. (inherited from Control)
Public property CompanyName Gets the name of the company or creator of the application containing the control. (inherited from Control)
Public property Container Gets the IContainer that contains the Component. (inherited from Component)
Public property ContainsFocus Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (inherited from Control)
Public property ContextMenu Gets or sets the shortcut menu associated with the control. (inherited from Control)
Public property ContextMenuStrip Gets or sets the ContextMenuStrip associated with this control. (inherited from Control)
Public property Controls Gets the collection of controls contained within the control. (inherited from Control)
Public property Created Gets a value indicating whether the control has been created. (inherited from Control)
Public property CurrentAutoScaleDimensions Gets the current run-time dimensions of the screen. (inherited from ContainerControl)
Public property Cursor Gets or sets the cursor that is displayed when the mouse pointer is over the control. (inherited from Control)
Public property DataBindings Gets the data bindings for the control. (inherited from Control)
Public property DisplayExtents Returns the current extents visible in the map.
Public property DisplayRectangle Gets the rectangle that represents the virtual display area of the control. (inherited from ScrollableControl)
Public property Disposing Gets a value indicating whether the base Control class is in the process of disposing. (inherited from Control)
Public property 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)
Public property DockPadding Gets the dock padding settings for all edges of the control. (inherited from ScrollableControl)
Public property Enabled Gets or sets a value indicating whether the control can respond to user interaction. (inherited from Control)
Public property Focused Gets a value indicating whether the control has input focus. (inherited from Control)
Public property Font Gets or sets the font of the text displayed by the control. (inherited from Control)
Public property ForeColor Gets or sets the foreground color of the control. (inherited from Control)
Public property FullExtents Returns the full extents of all layers loaded in the map.
Public property HaltDrawing Indicates that the map should temporarily avoid redrawing.
Public property Handle Gets the window handle that the control is bound to. (inherited from Control)
Public property HasChildren Gets a value indicating whether the control contains one or more child controls. (inherited from Control)
Public property Height Gets or sets the height of the control. (inherited from Control)
Public property HorizontalScroll Gets the characteristics associated with the horizontal scroll bar. (inherited from ScrollableControl)
Public property ImeMode Gets or sets the Input Method Editor (IME) mode of the control. (inherited from Control)
Public property 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)
Public property IsAccessible Gets or sets a value indicating whether the control is visible to accessibility applications. (inherited from Control)
Public property IsDisposed Gets a value indicating whether the control has been disposed of. (inherited from Control)
Public property IsHandleCreated Gets a value indicating whether the control has a handle associated with it. (inherited from Control)
Public property IsMirrored Gets a value indicating whether the control is mirrored. (inherited from Control)
Public property LayoutEngine Gets a cached instance of the control's layout engine. (inherited from Control)
Public property 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)
Public property 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)
Public property Margin Gets or sets the space between controls. (inherited from Control)
Public property MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize can specify. (inherited from Control)
Public property MinimumSize Gets or sets the size that is the lower limit that GetPreferredSize can specify. (inherited from Control)
Public property MouseCursorMode Gets or sets the mouse cursor mode (i.e., zoom in, none)
Public property MouseWheelZooms Determines or sets whether the mouse wheel zooms in and out.
Public property Name Gets or sets the name of the control. (inherited from Control)
Public property NumLayers Returns the number of layers currently in the map.
Public property Padding Gets or sets padding within the control. (inherited from Control)
Public property Parent Gets or sets the parent container of the control. (inherited from Control)
Public property ParentForm Gets the form that the container control is assigned to. (inherited from ContainerControl)
Public property PreferredSize Gets the size of a rectangular area into which the control can fit. (inherited from Control)
Public property ProductName Gets the product name of the assembly containing the control. (inherited from Control)
Public property ProductVersion Gets the version of the assembly containing the control. (inherited from Control)
Public property RecreatingHandle Gets a value indicating whether the control is currently re-creating its handle. (inherited from Control)
Public property Region Gets or sets the window region associated with the control. (inherited from Control)
Public property 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)
Public property RightToLeft Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (inherited from Control)
Public property Site Gets or sets the site of the control. (inherited from Control)
Public property Size Gets or sets the height and width of the control. (inherited from Control)
Public property TabIndex Gets or sets the tab order of the control within its container. (inherited from Control)
Public property TabStop Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (inherited from Control)
Public property Tag Gets or sets the object that contains data about the control. (inherited from Control)
Public property Text   (inherited from UserControl)
Public property 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)
Public property 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)
Public property UseWaitCursor Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (inherited from Control)
Public property VerticalScroll Gets the characteristics associated with the vertical scroll bar. (inherited from ScrollableControl)
Public property Visible Gets or sets a value indicating whether the control is displayed. (inherited from Control)
Public property Width Gets or sets the width of the control. (inherited from Control)
Public property WindowTarget   (inherited from Control)
Public property ZoomPercent Determines or sets the percentage that a zoom operation will apply.
Top

Protected Properties

  Name Description
Family property AutoScaleFactor Gets the scaling factor between the current and design-time automatic scaling dimensions. (inherited from ContainerControl)
Family property CanRaiseEvents Determines if events can be raised on the control. (inherited from Control)
Family property CreateParams   (inherited from UserControl)
Family property DefaultCursor Gets or sets the default cursor for the control. (inherited from Control)
Family property DefaultImeMode Gets the default Input Method Editor (IME) mode supported by the control. (inherited from Control)
Family property DefaultMargin Gets the space, in pixels, that is specified by default between controls. (inherited from Control)
Family property DefaultMaximumSize Gets the length and height, in pixels, that is specified as the default maximum size of a control. (inherited from Control)
Family property DefaultMinimumSize Gets the length and height, in pixels, that is specified as the default minimum size of a control. (inherited from Control)
Family property DefaultPadding Gets the internal spacing, in pixels, of the contents of a control. (inherited from Control)
Family property DefaultSize   (inherited from UserControl)
Family property DesignMode Gets a value that indicates whether the Component is currently in design mode. (inherited from Component)
Family property 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)
Family property Events Gets the list of event handlers that are attached to this Component. (inherited from Component)
Family property FontHeight Gets or sets the height of the font of the control. (inherited from Control)
Family property HScroll Gets or sets a value indicating whether the horizontal scroll bar is visible. (inherited from ScrollableControl)
Family property ResizeRedraw Gets or sets a value indicating whether the control redraws itself when resized. (inherited from Control)
Family property ScaleChildren Gets a value that determines the scaling of child controls. (inherited from Control)
Family property VScroll Gets or sets a value indicating whether the vertical scroll bar is visible. (inherited from ScrollableControl)
Top

Protected Internal Properties

  Name Description
FamilyOrAssembly property RenderRightToLeft   (inherited from Control)
FamilyOrAssembly property ShowFocusCues Gets a value indicating whether the control should display focus rectangles. (inherited from Control)
FamilyOrAssembly property ShowKeyboardCues Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (inherited from Control)
Top

Public Methods

  Name Description
Public method AddLayer Overloaded.

M:MapWinView.MapView.AddLayer(MapWinView.RenderableDrawingLayer@,System.Int32)

Adds a new layer to the map. Returns the LayerHandle of the added layer.

Public method BeginInvoke Overloaded. Executes a delegate asynchronously on the thread that the control's underlying handle was created on. (inherited from Control)
Public method BringToFront Brings the control to the front of the z-order. (inherited from Control)
Public method Contains Retrieves a value indicating whether the specified control is a child of the control. (inherited from Control)
Public method CreateControl Forces the creation of the control, including the creation of the handle and any child controls. (inherited from Control)
Public method CreateGraphics Creates the Graphics for the control. (inherited from Control)
Public method 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)
Public method Dispose Overloaded.

Overload:System.Windows.Forms.ContainerControl.Dispose

Releases the resources used by the container.

Public method DoDragDrop Begins a drag-and-drop operation. (inherited from Control)
Public method DrawToBitmap Supports rendering to the specified bitmap. (inherited from Control)
Public method EndInvoke Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (inherited from Control)
Public method Equals Determines whether the specified Object is equal to the current Object. (inherited from Object)
Public method Static ExtentsFullyContained Determines if the given extents are fully contained in the container.
Public method FindForm Retrieves the form that the control is on. (inherited from Control)
Public method Focus Sets input focus to the control. (inherited from Control)
Public method GetChildAtPoint Overloaded. Retrieves the child control at a specified location. (inherited from Control)
Public method GetContainerControl Returns the next ContainerControl up the control's chain of parent controls. (inherited from Control)
Public method GetHashCode Serves as a hash function for a particular type. GetHashCode is suitable for use in hashing algorithms and data structures like a hash table. (inherited from Object)
Public method GetLayer Returns the specified layer through the LayerObject "out" parameter.
Public method GetLayerHandle Returns the handle of the later at the specified position. For positions: (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (inherited from MarshalByRefObject)
Public method GetNextControl Retrieves the next control forward or back in the tab order of child controls. (inherited from Control)
Public method GetPreferredSize Retrieves the size of a rectangular area into which a control can be fitted. (inherited from Control)
Public method GetType Gets the Type of the current instance. (inherited from Object)
Public method Hide Conceals the control from the user. (inherited from Control)
Public method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (inherited from MarshalByRefObject)
Public method Invalidate Overloaded. Invalidates a specific region of the control and causes a paint message to be sent to the control. (inherited from Control)
Public method Invoke Overloaded. Executes a delegate on the thread that owns the control's underlying window handle. (inherited from Control)
Public method LayerPosition Returns the position of the specified layer. (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer)
Public method MoveLayerTo Moves the specified layer to the specified position. (0 = First Drawn/Bottom Layer; Max=Last Drawn/Top Layer)
Public method MoveLayerToBottom Moves the specified layer to the bottom (first drawn).
Public method MoveLayerToTop Moves the specified layer to the top (last drawn).
Public method Static OutOfView Overloaded.

M:MapWinView.MapView.OutOfView(MapWinData.Envelope,MapWinData.Envelope)

Determines if the specified extent is out of the specified view.

Public method PerformAutoScale Performs scaling of the container control and its children. (inherited from ContainerControl)
Public method PerformLayout Overloaded. Forces the control to apply layout logic to child controls. (inherited from Control)
Public method PixelToProj Converts a pixel point in terms of the control into projected coordinates in terms of the map data.
Public method PointToClient Computes the location of the specified screen point into client coordinates. (inherited from Control)
Public method PointToScreen Computes the location of the specified client point into screen coordinates. (inherited from Control)
Public method PreProcessControlMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (inherited from Control)
Public method PreProcessMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (inherited from Control)
Public method ProjToPixel Converts a projected coordinate in terms of the map data into pixels in terms of the control.
Public method ProjToPixelX Converts a projected X coordinate in terms of the map data into pixels in terms of the control.
Public method ProjToPixelY Converts a projected Y coordinate in terms of the map data into pixels in terms of the control.
Public method RectangleToClient Computes the size and location of the specified screen rectangle in client coordinates. (inherited from Control)
Public method RectangleToScreen Computes the size and location of the specified client rectangle in screen coordinates. (inherited from Control)
Public method Redraw Causes the map to redraw. Call after any important manual update.
Public method Refresh Forces the control to invalidate its client area and immediately redraw itself and any child controls. (inherited from Control)
Public method RemoveLayer Removes the specified layer from the map.
Public method ResetBackColor   (inherited from Control)
Public method ResetBindings   (inherited from Control)
Public method ResetCursor   (inherited from Control)
Public method ResetFont   (inherited from Control)
Public method ResetForeColor   (inherited from Control)
Public method ResetImeMode   (inherited from Control)
Public method ResetRightToLeft   (inherited from Control)
Public method ResetText Resets the Text property to its default value. (inherited from Control)
Public method ResumeLayout Overloaded. Resumes the usual layout logic. (inherited from Control)
Public method Scale Overloaded. Scales the control and any child controls. (inherited from Control)
Public method ScrollControlIntoView Scrolls the specified child control into view on an auto-scroll enabled control. (inherited from ScrollableControl)
Public method Select Overloaded. Activates the control. (inherited from ContainerControl)
Public method SelectNextControl Activates the next control. (inherited from Control)
Public method SendToBack Sends the control to the back of the z-order. (inherited from Control)
Public method SetAutoScrollMargin Sets the size of the auto-scroll margins. (inherited from ScrollableControl)
Public method SetBounds Overloaded. Sets the bounds of the control. (inherited from Control)
Public method Show Displays the control to the user. (inherited from Control)
Public method 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.

Public method SuspendLayout Temporarily suspends the layout logic for the control. (inherited from Control)
Public method ToString Returns a String containing the name of the Component, if any. This method should not be overridden. (inherited from Component)
Public method Update Causes the control to redraw the invalidated regions within its client area. (inherited from Control)
Public method Validate Overloaded. Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. (inherited from ContainerControl)
Public method 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)
Public method ZoomIn Overloaded.

M:MapWinView.MapView.ZoomIn

Zooms in about the center of the map.

Public method ZoomOut Overloaded.

M:MapWinView.MapView.ZoomOut

Zooms out about the center of the map.

Public method ZoomToFullExtents Zooms to the full extents of the map.
Public method ZoomToLayer Zooms to the full extents of the map.
Top

Protected Methods

  Name Description
Family method AccessibilityNotifyClients Overloaded. Notifies the accessibility client applications of AccessibleEvents. (inherited from Control)
Family method AdjustFormScrollbars   (inherited from ContainerControl)
Family method CreateAccessibilityInstance Creates a new accessibility object for the control. (inherited from Control)
Family method CreateControlsInstance Creates a new instance of the control collection for the control. (inherited from Control)
Family method CreateHandle Creates a handle for the control. (inherited from Control)
Family method DefWndProc Sends the specified message to the default window procedure. (inherited from