WpfMap Class |
The main WPF map control with pre-customized gadgets and themes.
WpfMap
Inheritance HierarchySystemObject
System.Windows.ThreadingDispatcherObject
System.WindowsDependencyObject
System.Windows.MediaVisual
System.WindowsUIElement
System.WindowsFrameworkElement
System.Windows.ControlsControl
System.Windows.ControlsContentControl
System.Windows.ControlsUserControl
Ptv.XServer.Controls.MapMap
Ptv.XServer.Controls.MapWpfMap
System.Windows.ThreadingDispatcherObject
System.WindowsDependencyObject
System.Windows.MediaVisual
System.WindowsUIElement
System.WindowsFrameworkElement
System.Windows.ControlsControl
System.Windows.ControlsContentControl
System.Windows.ControlsUserControl
Ptv.XServer.Controls.MapMap
Ptv.XServer.Controls.MapWpfMap
Namespace: Ptv.XServer.Controls.Map
Assembly: Ptv.XServer.Controls.Map (in Ptv.XServer.Controls.Map.dll) Version: 1.7.10.0
SyntaxThe WpfMap type exposes the following members.
ConstructorsProperties| Name | Description | |
|---|---|---|
 | Center | Gets or sets the center of the map in WGS84 coordinates. (Inherited from Map.) |
| CoordinateDiplayFormat | Gets or sets the display format for coordinates. (Inherited from Map.) |
| CurrentCenter | Gets the center of the map in WGS84 coordinates while it is in animation mode. (Inherited from Map.) |
| CurrentScale | Gets the current scale of the map in meters per pixel while it is in animation mode. (Inherited from Map.) |
| CurrentZoomLevel | Gets the current zoom level of the map while it is in animation mode. (Inherited from Map.) |
| DefaultThemeResources | Gets or sets the default theme. The default theme is initialized in the WpfMap.xaml file and used
by UseDefaultTheme. (Inherited from Map.) |
| FitInWindow | Gets or sets a value indicating whether the map should be fitted in the window or not. (Inherited from Map.) |
| InvertMouseWheel | 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. (Inherited from Map.) |
| IsAnimating | Gets a value indicating whether an animation is in progress. Returns true while the map performs
a transition to a new map section. (Inherited from Map.) |
| Layers | Gets the collection of map layers. (Inherited from Map.) |
| MaxPixelDistance |
Distance (specified in Pixels) between the current mouse position and a layer object, for which tooltip information should be shown.
Each layer has to interpolate to its own coordinate format, what is meant by the pixel sized distance.
(Inherited from Map.) |
| MaxZoom | 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. (Inherited from Map.) |
| MetersPerPixel | Gets the number of meters spanned by one pixel. (Inherited from Map.) |
| MinZoom | 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. (Inherited from Map.) |
| MouseDoubleClickZoom | 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. (Inherited from Map.) |
| MouseDragMode | Gets or sets the behavior when dragging the mouse while holding the left button. (Inherited from Map.) |
| MouseWheelSpeed | 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. (Inherited from Map.) |
| Scale | Gets the scale of the map in meters per pixel. (Inherited from Map.) |
| ShowCoordinates | Gets or sets a value indicating whether the coordinates gadget is shown or made invisible. |
| ShowLayers | Gets or sets a value indicating whether the layers gadget is shown or made invisible. |
| ShowMagnifier | Gets or sets a value indicating whether the magnifier gadget is shown or made invisible. |
| ShowNavigation | Gets or sets a value indicating whether the layers gadget is shown or made invisible. |
| ShowOverview | Gets or sets a value indicating whether the overview map is shown or made invisible. |
| ShowScale | Gets or sets a value indicating whether the scale gadget is shown or made invisible. |
| ShowZoomSlider | Gets or sets a value indicating whether the zoom slider gadget is shown or made invisible. |
| ToolTipDelay | Reads or writes the value (in [ms]) to delay tool tip display. (Inherited from Map.) |
| ToolTipManagement | Gets the object providing all functionality relevant for tool tip management. (Inherited from Map.) |
| UseAnimation | Gets or sets a value indicating whether the map uses transitions for panning, zooming and fade-in
of tiles. The default value is true. (Inherited from Map.) |
| UseDefaultTheme | 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. See the Theming Concept topic for an example. |
| UseMiles | Gets or sets a value indicating whether the scale is displayed in miles or it is displayed in km. (Inherited from Map.) |
| Xmap2LayerFactory | 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. (Inherited from Map.) |
| XMapCopyright | Gets or sets the copyright text. (Inherited from Map.) |
| XMapCredentials | Gets or sets the credentials for xMapServer basic HTTP authentication.
The format of the credential string is "<user>:<password>". (Inherited from Map.) |
| XMapStyle | Gets or sets the style profile of the xMapServer base map. (Inherited from Map.) |
| XMapUrl | Gets or sets the url pointing to where the xMapServer is located (e.g. http://127.0.0.1:50010/xmap/ws/XMap). (Inherited from Map.) |
| Zoom | Gets or sets the zoom level of the map. (Inherited from Map.) |
| ZoomLevel | Gets or sets the zoom level of the map. (Inherited from Map.) |
Methods| Name | Description | |
|---|---|---|
 | Dispose | Disposal of the map. All layers are disposed. (Inherited from Map.) |
| GeoAsRelToMapView(Point) | Converts a geographic point to a point in WPF units. (Inherited from Map.) |
| GeoAsRelToMapView(Point, String) | Converts a geographic point to a point in WPF units. (Inherited from Map.) |
| GetCurrentEnvelope | Gets the bounding box of the visible map section while the map is in animation mode. (Inherited from Map.) |
| GetCurrentEnvelope(String) | Gets the bounding box of the visible map section while the map is in animation mode. (Inherited from Map.) |
| GetEnvelope | 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. (Inherited from Map.) |
| GetEnvelope(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. (Inherited from Map.) |
| InitializeComponent |
InitializeComponent
|
| MouseToGeo(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. (Inherited from Map.) |
| MouseToGeo(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. (Inherited from Map.) |
| PrintMap | Prints the currently displayed map. (Inherited from Map.) |
| RelToMapViewAsGeo(Point) | Converts a point from WPF coordinates to a geographic point. (Inherited from Map.) |
| RelToMapViewAsGeo(Point, String) | Converts a point from WPF coordinates to a geographic point. (Inherited from Map.) |
| SetEnvelope(MapRectangle) | Centers the map resulting in all elements within the specified rectangle are visible. (Inherited from Map.) |
| SetEnvelope(MapRectangle, String) | Centers the map, so all elements within the specified rectangle are visible. (Inherited from Map.) |
| SetMapLocation(Point, Double) | Set the center and zooming level of the map. (Inherited from Map.) |
| SetMapLocation(Point, Double, String) | Set the center and zooming level of the map. (Inherited from Map.) |
| SetThemeFromXaml | 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. See the Theming Concept topic for an example. |
Events| Name | Description | |
|---|---|---|
 | UseMilesChanged | Event indicating a change of the UseMiles property. It can be used to update the scale gadget. (Inherited from Map.) |
| ViewportBeginChanged | 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. (Inherited from Map.) |
| ViewportEndChanged | Event indicating the ending of a change of the visible map section. It is the counterpart of the
event. (Inherited from Map.) |
| ViewportWhileChanged | 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. (Inherited from Map.) |
Fields| Name | Description | |
|---|---|---|
 | copyrightHintText | The text block which displays the hint for the missing xMap url. (Inherited from Map.) |
 | CopyrightImagePanel |
CopyrightImagePanel Name Field
|
| Gadgets | Dictionary holding all existing gadgets like Scale gadget, zoom slider etc. (Inherited from Map.) |
| mapView | MapView to be displayed in the map. (Inherited from Map.) |
 | ShowCoordinatesProperty | Property to show the coordinates gadget. |
| ShowLayersProperty | Property to show the layers gadget. |
| ShowMagnifierProperty | Property to show the magnifier gadget. |
| ShowNavigationProperty | Property to show the navigation gadget. |
| ShowOverviewProperty | Property to show the overview map. |
| ShowScaleProperty | Property to show the scale gadget. |
| ShowZoomSliderProperty | Property to show the zoom slider gadget. |
Extension Methods| Name | Description | |
|---|---|---|
 | AddBingLayer(String, Int32, String, BingImagerySet, BingMapVersion, Boolean, Double, BitmapImage) | Overloaded. Extension method which adds a Microsoft Bing layer to the map. (Defined by BingExtensions.) |
| AddBingLayer(String, Int32, String, BingImagerySet, BingMapVersion, Boolean, Double, BitmapImage, Panel) | Overloaded. Extension method which adds a Microsoft Bing layer to the map. (Defined by BingExtensions.) |
| FindRelativeT | Finds an object of type T for a framework element which is somewhere in the visual tree. (Defined by MapElementExtensions.) |
| RemoveBingLayer | Extension method which removes a Microsoft Bing layer from the map. (Defined by BingExtensions.) |
| ToJson | Converts an object to a JSON string representation. (Defined by JSONWriter.) |
See Also