Click or drag to resize

FormsMap Class

A wrapper for WpfMap for easy WinForms integration.
Inheritance Hierarchy

Namespace:  Ptv.XServer.Controls.Map
Assembly:  Ptv.XServer.Controls.Map (in Ptv.XServer.Controls.Map.dll) Version: 1.7.10.0
Syntax
public class FormsMap : UserControl, IMap

The FormsMap type exposes the following members.

Constructors
  NameDescription
Public methodFormsMap
Initializes a new instance of the FormsMap class.
Top
Properties
  NameDescription
Public propertyCenter
Gets or sets the center of the map in WGS84 coordinates.
Public propertyCoordinateDiplayFormat
Gets or sets the display format for coordinates.
Public propertyCurrentCenter
Gets the center of the map in WGS84 coordinates while it is in animation mode.
Public propertyCurrentScale
Gets the current scale of the map in meters per pixel while it is in animation mode.
Public propertyCurrentZoomLevel
Gets the current zoom level of the map while it is in animation mode.
Public propertyFitInWindow
Gets or sets a value indicating whether the map should be fitted in the window or not.
Public propertyInvertMouseWheel
Gets or sets a value indicating whether the orientation for mouse-wheel zoom is inverted. If so, zoom in and zoom out mouse wheel direction is exchanged. The default value is false.
Public propertyIsAnimating
Gets a value indicating whether an animation is in progress. Returns true while the map performs a transition to a new map section.
Public propertyLayers
Gets the collection of map layers.
Public propertyMaxZoom
Gets or sets the maximal level of detail according to the standard tiling scheme. The current detail level (see ZoomLevel property) is corrected, if it is higher than the new maximum value.
Public propertyMetersPerPixel
Gets the number of meters spanned by one pixel.
Public propertyMinZoom
Gets or sets the minimal level of detail according to the standard tiling scheme. The current detail level (see ZoomLevel property) is corrected, if it is lower than the new minimum value.
Public propertyMouseDoubleClickZoom
Gets or sets the activation for zoom on double-click. If true, the user can zoom-in be double left-click and zoom-out by double right-click.
Public propertyMouseDragMode
Gets or sets the behavior when dragging the mouse while holding the left button.
Public propertyMouseWheelSpeed
Gets or sets the speed for mouse-wheel zoom. The value defines the number of map zoom levels per wheel delta. The default value is 0.5.
Public propertyScale
Gets the scale of the map in meters per pixel.
Public propertyShowCoordinates
Gets or sets a value indicating whether the coordinates gadget is shown or made invisible.
Public propertyShowLayers
Gets or sets a value indicating whether the layers gadget is shown or made invisible.
Public propertyShowMagnifier
Gets or sets a value indicating whether the magnifier gadget is shown or made invisible.
Public propertyShowNavigation
Gets or sets a value indicating whether the layers gadget is shown or made invisible.
Public propertyShowOverview
Gets or sets a value indicating whether the overview map is shown or made invisible.
Public propertyShowScale
Gets or sets a value indicating whether the scale gadget is shown or made invisible.
Public propertyShowZoomSlider
Gets or sets a value indicating whether the zoom slider gadget is shown or made invisible.
Public propertyToolTipManagement
Gets the object providing all functionality relevant for tool tip management.
Public propertyUseAnimation
Gets or sets a value indicating whether the map uses transitions for panning, zooming and fade-in of tiles. The default value is true.
Public propertyUseDefaultTheme
Gets or sets a value indicating whether the built-in PTV theme should be used, and thus overriding an optionally set style. The application theme can be set in the App.xaml. If no theme at all is set and the default PTV theme is not used either, the UI will look like the current Windows theme.
Public propertyUseMiles
Gets or sets a value indicating whether the scale unit is miles. The default value is false.
Public propertyWrappedMap
Gets the wrapped Wpf map instance. This can be used to get to the inner Wpf elements, e.g. to support mouse events on Wpf level.
Public propertyXmap2LayerFactory
Gets the helper object for integration of XMap2 layers and Feature Layers of XServer 2. The reference is only set when property XMapUrl is set with an XMap2 conform URL.
Public propertyXMapCopyright
Gets or sets the copyright text.
Public propertyXMapCredentials
Gets or sets the credentials for xMapServer basic HTTP authentication. The format of the credential string is "<user>:<password>".
Public propertyXMapStyle
Gets or sets the style profile of the xMapServer base map.
Public propertyXMapUrl
Gets or sets the url pointing to where the xMapServer is located (e.g. http://127.0.0.1:50010/xmap/ws/XMap).
Public propertyZoomLevel
Gets or sets the zoom level of the map.
Top
Methods
  NameDescription
Protected methodDispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Overrides ContainerControlDispose(Boolean).)
Public methodGeoAsRelToMapView(Point)
Converts a geographic point to a point in WPF units.
Public methodGeoAsRelToMapView(Point, String)
Converts a geographic point to a point in WPF units.
Public methodGetCurrentEnvelope
Gets the bounding box of the visible map section while the map is in animation mode.
Public methodGetCurrentEnvelope(String)
Gets the bounding box of the visible map section while the map is in animation mode.
Public methodGetEnvelope
Gets the anticipated bounding box of the visible map section after the map was in animation mode / the current box while the map is in animation mode.
Public methodGetEnvelope(String)
Gets the anticipated bounding box of the visible map section after the map was in animation mode / the current box while the map is in animation mode. The bounding box coordinates are specified in a coordinate format according the parameter value of spatialReferenceId.
Public methodMouseToGeo(MouseEventArgs)
Converts the click point of the mouse event to a geographic point in WGS84 units. The click point of the mouse is determined relative to the map.
Public methodMouseToGeo(MouseEventArgs, String)
Converts the click point of the mouse event to a geographic point corresponding to the given spatial reference id. The click point of the mouse is determined relative to the map.
Protected methodOnEnabledChanged
Contains a bug fix resolving an issue, when this control is not enabled correctly in ElementHost.
(Overrides ControlOnEnabledChanged(EventArgs).)
Public methodPrintMap
Prints the currently displayed map.
Public methodRelToMapViewAsGeo(Point)
Converts a point from WPF coordinates to a geographic point.
Public methodRelToMapViewAsGeo(Point, String)
Converts a point from WPF coordinates to a geographic point.
Public methodSetEnvelope(MapRectangle)
Centers the map resulting in all elements within the specified rectangle are visible.
Public methodSetEnvelope(MapRectangle, String)
Centers the map, so all elements within the specified rectangle are visible.
Public methodSetMapLocation(Point, Double)
Sets the center (specified in WGS84 units) and zoom level of the map.
Public methodSetMapLocation(Point, Double, String)
Sets the center (coordinate format specified in parameter spatialReferenceId) and zoom level of the map.
Public methodSetThemeFromXaml
Sets the current theme from a XAML file provided by the stream. The XAML file must contain a ResourceDictionary on the top level. See the attached XAML files in the demo project.
Top
Events
  NameDescription
Public eventViewportBeginChanged
Event indicating the beginning of a change of the visible map section. This event is intended for more longtime actions (for example reading DB-objects), when the map section will change.
Public eventViewportEndChanged
Event indicating the ending of a change of the visible map section. It is the counterpart of the event.
Public eventViewportWhileChanged
Event indicating an intermediate view, when animation mode is active. It can be used to adapt the size of WPF objects, or other actions, which are not time-consuming. This event may called multiple times, when animation mode is active.
Top
Extension Methods
  NameDescription
Public Extension MethodToJson
Converts an object to a JSON string representation.
(Defined by JSONWriter.)
Top
See Also