ESRI.ArcGIS.Mobile.Client
MapPage Class
Members  See Also  Send Feedback
ESRI.ArcGIS.Mobile.Client.Map Namespace : MapPage Class

This class shows a MapPage.

Object Model






Syntax

Visual Basic (Declaration) 
Public Class MapPage 
   Implements IPageIPage2 
C# 
public class MapPage : IPageIPage2  

Remarks

MapPage is a page that embeds a map component for visualizing geospatial information. It's also used as the main real estate for user to interact with the map in various tasks. Technically you can create your own form with a map component embedded. However, that would prove to be very expensive due to the limited resources available from a mobile device (especially the memory). Therefore, we recommend you to use MapPage provided by the application framework where there is a need to show a page with map component. The MapPage has been designed in such a way that all instances of MapPage shares a same map component, which greatly saves resources on the device.

To make MapPage work for different user scenarios, application framework exposes a set of properties off of MapPage that allows you to customize the UI. You can freely customize Title, SmallIcon, RightSoftMenu, and so on. The application framework provides a set of built-in menu items that you can use easily with a MapPage. The default menus are split into MapPage.DefaultUpperMenuItems and MapPage.DefaultLowerMenuItems. The DefaultUpperMenuItems contains navigation items (pan, zoom, etc.) and the Gps menu items from which you can access Gps settings and status page. The DefaultLowerMenuItems has the layer visibility and help tip menu items. Once you change either DefaultUpperMenuItems or DefaultLowerMenuItems, the changes will be effective for any MapPage instances that have been created or will be created.

To customize your MapPage without affecting any other MapPage instances, you can create an instance of MapPage, and customize the RightMenuItems collection by a mixture of DefaultUpperItems/DefaultLowerItems with your own menu items. As a guideline, we recommend you to add your own menu items in between the default upper and lower menu items. This guideline has been followed by the mobile application on various MapPages.

For more details, see the MapPage section in Extending Mobile Application By Function Area document.

If you need to create a MapPage so that user can browse a collection of features, use BrowseMapPage. BrowseMapPage is designed specifically for browsing Features or ILocations on a MapPage. It provides default BrowseMapAction that allows user to easily browse thorugh a set of Features or ILocations using rocker and/or arrow keys.

Inheritance Hierarchy

Requirements

Namespace: ESRI.ArcGIS.Mobile.Client.Map

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

Assembly: ESRI.ArcGIS.Mobile.Client (in ESRI.ArcGIS.Mobile.Client.dll)

See Also