Version

Navigating Map Content

Purpose

This topic provides conceptual information about navigating map content in the UltraGeographicMap™ 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 UltraGeographicMap control.

In This Topic

This topic contains the following sections:

Map Navigation

Overview

The UltraGeographicMap control inherits navigation functionalities from SeriesViewer control which is also used in the UltraDataChart control.

Navigation in the UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap control:

Property Type Description Default Value

ActualWindowRect

Rectangle

Indicates position and size of the navigation window which indicates currently viewable area of the map content in the UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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 UltraGeographicMap 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:

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

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 UltraGeographicMap control.

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

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

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