Pitney Bowes MapXtreme - Manual (Page 81)

Chapter 5: Web Applications, Controls, and Tools
MapXtreme Web Controls and Tools
MapXtreme v7.1 81 Developer Guide
These JavaScript-enabled tools do not trigger a full page postback with each use. Typically, only the
image of the map is refreshed after each tool use. See
Map Tools Architecture for an
understanding of this development model. See Managing Your Web Controls for information on
event handling, error management and state management.
Previous MapXtreme controls (pre-v6.5 releases) required a postback that called Page_Load and
Page_Unload every time a tool was used. These tools are provided for backward compatibility and
are not recommended for new development projects. See
Migrating Post-back Web Controls to
JavaScript Web Controls .
Customizable
If the provided tools do not offer you the functionality to meet your needs, consider modifying them.
This can be as simple as changing a built-in tool property or as complicated as writing your own
JavaScript and server-side class to extend its functionality. Source code for the web controls and
tools is provided in the Samples\MapXtremeWebControlsSourceCode folder. See
Creating a
Custom Tool .
MapXtreme provides an ASP.NET AJAX sample application that demonstrates how to use
Microsoft's ASP.NET AJAX controls in a MapXtreme web mapping application. See
ASP.NET AJAX
and MapXtreme Web Applications .
Description of Web Controls and Tools
The following are the available MapXtreme Web controls and tools.
Web Controls Description
MapControl Allows you to display an instance of a Map object. Each Map object is
referred to by a MapAlias, such as Map1.
At runtime, the MapControl displays the map which is obtained from a
MapFactory by using the map’s MapAlias property. The map is drawn
by exporting the map image, and referencing this image in the HTML
tag. If the MapAlias property is not specified or is invalid, the first
map from the MapFactory is chosen. Set the MapControl MapAlias
property at design time.
LayerControl Allows you to display map feature layers and label layers in a tree view
structure. This control can turn the visibility on or off for a particular layer
and displays a read-only current zoom value. The visibility changes are
persistent only for the active life of the application using the
LayerControl.