Navigating Map Content

Purpose

This topic provides conceptual information about navigating map content in the XamGeographicMap™ control as well as all supported navigation features of the control.

Required background

The following table lists the topics required as a prerequisite to understanding this topic.

Topic	Purpose
Visual Elements of XamGeographicMap	This topic provides information about layout of map elements in the XamGeographicMap control.

In This Topic

This topic contains the following sections:

Map Navigation
Map Navigation Window
Map Navigation Features
Related Content

Map Navigation

Overview

The XamGeographicMap control inherits navigation functionalities from SeriesViewer control which is also used in the XamDataChart control.

Navigation in the XamGeographicMap control is enabled by default and it allows zooming and panning of the map content. However, this behavior can be changed using the Zoomable property. It is important to know that the XamGeographicMap control allows only synchronized zooming - scaling the map content with preserved aspect ratio. As result, it is not possible to scale the map content vertically without scaling it also horizontally and vice versa.

Map Navigation Window

In the XamGeographicMap control, navigation window represents currently viewable area of the map content. The ActualWindowRect property tracks position and size of the navigation window. Each time panning or zooming operation is performed in the XamGeographicMap control, the navigation window changes and the ActualWindowRect property is updated with new values.

The following table summarizes properties used to track navigation window in the XamGeographicMap control:

Property	Type	Description	Default Value
ActualWindowRect	Rect	Indicates position and size of the navigation window which indicates currently viewable area of the map content in the XamGeographicMap control.	0, 0, 1, 1 Displays the entire map content in the navigation window.
ActualWindowPositionHorizontal	double	Indicates horizontal position of the navigation window’s anchor point from the left edge of the XamGeographicMap control. It is equivalent to value stored in the Left of the ActualWindowRect property.	0 Displays the left portion of the map content in the navigation window.
ActualWindowPositionVertical	double	Indicates vertical position of the navigation window’s anchor point from the top edge of the XamGeographicMap control. It is equivalent to value stored in the Top of the ActualWindowRect property.	0 Displays the top portion of the map content in the navigation window.
ActualWindowScale	double	Indicates size of the navigation window in of the XamGeographicMap control. It is equivalent to value stored in the ActualWindowRect property.	1 Displays the entire horizontal map content in the navigation window.

The following image is a preview of XamGeographicMap control with position and size of the navigation window highlighted when the control was zoomed to some region of the map content (for example, Africa continent).

GeographicMap Navigating Map Content 1.png

Map Navigation Features

The following table summarizes navigation features supported in the XamGeographicMap control.

Navigation Feature	Description
Panning in all map directions	Allows users basic panning of the map content in all directions using combination of mouse and keyboard inputs. Functionality of this feature is described in the following topics: Navigating Map Content Using a Mouse Navigating Map Content Using Keyboard
Fit the map content to viewable area of the map.	Allows users to scale the map content to fit viewable area of the XamGeographicMap control using keyboard inputs or in code-behind. Functionality of this feature is described in the following topics: Navigating Map Content Using Code Navigating Map Content Using Keyboard
Zooming in and out	Allows users basic zooming in and out of the map content using combination of mouse and keyboard inputs. Functionality of this feature is described in the following topics: Navigating Map Content Using Code Navigating Map Content Using Keyboard Navigating Map Content Using a Mouse
Zooming to map area	Allows users to zoom the map content to an area of the map using combination of mouse and keyboard inputs. Functionality of this feature is described in the following topics: Navigating Map Content Using Code Navigating Map Content Using a Mouse
Zooming to geographic regions	Allows you to implement custom navigation actions to zoom the map content to geographic regions of the map in code-behind. Functionality of this feature is described in the following topics: Navigating Map Content Using Code
Bound the map content geographic regions	Allows you to bound and limit navigation of the map content to geographic regions of the map in code-behind. Functionality of this feature is described in the following topics: Navigating Map Content Using Code

Topic	Purpose
Visual Elements of XamGeographicMap	This topic provides information about layout of map elements in the XamGeographicMap control.
Navigating Map Content Using Keyboard	This topic provides information about navigating the map content in the XamGeographicMap control using inputs from a keyboard.
Navigating Map Content Using a Mouse	This topic provides information about navigating the map content in the XamGeographicMap control using inputs from a mouse.
Navigating Map Content Using Code	This topic provides information about navigating the map content in the XamGeographicMap control using code.
Navigating Map Content Using Overview Plus Detail Pane	This topic provides information how to use the xamOverviewPlusDetailPane™ control to navigate map content in the XamGeographicMap control.

WPF | Help Topics