Version

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

This topic provides information about layout of map elements in the XamGeographicMap control.

In This Topic

This topic contains the following sections:

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:

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:

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:

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:

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:

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:

Related Content

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides information about layout of map elements in the XamGeographicMap control.

This topic provides information about navigating the map content in the XamGeographicMap control using inputs from a keyboard.

This topic provides information about navigating the map content in the XamGeographicMap control using inputs from a mouse.

This topic provides information about navigating the map content in the XamGeographicMap control using code.

This topic provides information how to use the xamOverviewPlusDetailPane™ control to navigate map content in the XamGeographicMap control.