Active Selections

A map may have an active selection, which is a list of features on the map that have been selected and highlighted in the Viewer. The active selection is part of the run-time map state, and is not stored with the map resource in the repository.

The most direct method for creating an active selection is to use the interactive selection tools in the Viewer. Applications can also create selections using the Web API and apply them to a user’s view of the map.

NoteThere is a fundamental difference in how the two Viewers manage selections. In the DWF Viewer, selection is handled entirely by the Viewer. This means that the Web server must request the selection information before it can use it.

In the AJAX Viewer, any changes to the active selection require re-generation of the map image. Because of this, the Web server keeps information about the selection.

#### Topics in this section

- Selecting with the Viewer
- Passing Viewer Information to the Web Server
- Working With the Active Selection
- Setting the Active Selection With the Web API
- Example: Setting the Active Selection