Version

Adding UltraGeographicMap to a Page

Purpose

This topic provides information on how to add the UltraGeographicMap™ control to an application page.

Required Background

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

Topic Purpose

This topic provides an overview of key features in the UltraGeographicMap control.

In This Topic

This topic contains the following sections

Adding UltraGeographicMap to a Page

Introduction

The UltraGeographicMap control is designed to display geo-spatial data from shape files and geographic locations from view models on geographic imagery maps. However, this topic focuses on adding the UltraGeographicMap control with the minimum code and property settings required for display. By default the UltraGeographicMap control is displayed with geographic imagery tiles from Open Street Map service.

Preview

The following is a preview of the UltraGeographicMap control with geographic imagery tiles from Open Street Map service.

GeographicMap Adding GeographicMap to Page 1.png

Requirements

The following table summarizes the requirements for adding the UltraGeographicMap control.

Requirement Description

Prerequisites

To complete the procedure section of this topic, you need to create a Windows Forms project.

Data

The UltraGeographicMap control does not require any data for its rendering because it displays geographic imagery tiles from Open Street Map in its background content. However, the UltraGeographicMap control can also display geo-spatial data from shape files and geographic locations from view models. Refer to the following topics for more information on how this is accomplished and for data requirements:

Overview

The following is a conceptual overview of the process:

  1. Reference Infragistics assemblies in your project

  2. Add Infragistics namespaces to your application’s view

  3. Add the Geographic Map control to your application’s view

  4. Verify the results

Steps

The following procedure takes you step-by-step toward adding the UltraGeographicMap control to a page.

Reference Infragistics assemblies in your project.

  1. Right click on your project and select the Add References… menu item.

  2. In the Add References dialog, browse to and add the following Infragistics assemblies:

    • Infragistics.Win.DataVisualization.UltraGeographicMap.dll

    • Infragistics.Win.DataVisualization.UltraDataChart.dll

    • Infragistics.Win.DataVisualization.Shared.dll

    • Infragistics.Portable.Core.dll

Add Infragistics namespaces to your application’s view.

In the application page, add the following namespace declarations:

In Visual Basic:

Imports Infragistics.Win.DataVisualization

In C#:

using Infragistics.Win.DataVisualization;

Add the Geographic Map control to your application’s view.

The following code demonstrates adding the UltraGeographicMap control with the minimum code and property settings required for display:

In Visual Basic:

Dim geoMap As New UltraGeographicMap()
Me.Controls.Add(geoMap)

In C#:

var geoMap = new UltraGeographicMap();
this.Controls.Add(geoMap)

Verify the results.

Build and run your project to verify the result. If you have implemented the steps correctly, the displayed UltraGeographicMap should look like the one in the Preview section above.

Related Content

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides information on how to bind geographic imagery in the UltraGeographicMap control.

This topic provides information on how to bind shape files with geo-spatial data to the UltraGeographicMap control.

This topic provides information on how to bind a view model with geo-spatial data to the UltraGeographicMap control

This topic provides information on how to navigate the map content of the UltraGeographicMap control.

This topic provides an API overview of key classes and properties of the UltraGeographicMap control and its components.