Developing Web Applications with the Web ADF - Web controls  

Magnifier control



The Magnifier control provides a dynamic inset map: it allows the user to zoom in on a small area of the map. The user drags the magnifier window over the map, and the magnifier obtains a zoomed-in image centered at the middle of the magnifier window. The user can change the amount of magnification using the drop-down list in the magnifier window. The magnifier window extends the FloatingPanel control, and therefore automatically floats to allow the user to drag it over the map. The Magnifier is tied to the Map control via its Map property. Its source of data is specified with its MapResourceManager property, with the MagnifierMapResource property determining which resource from the MapResourceManager is used in the magnified map image. Only one map resource can be used in the Magnifier control.

Assembly: ESRI.ArcGIS.ADF.Web.UI.WebControls.dll
Class: ESRI.ArcGIS.ADF.Web.UI.WebControls.Magnifier
Using the Magnifier control
  1. Add the controls to the page

    Open or create a Web site within Visual Studio.NET.   Open a Web form in design mode, select the Toolbox, and expand the ArcGIS Web Controls tab.  Drag and drop a MapResourceManager, a Map control, and a Magnifier control onto the Web form.

    Add one or more resources to the MapResourceManager.  See the Add Resources section in the MapResourceManager control topic for information on how to do this. Also set the Map control's MapResourceManager property to Map1. See Map Control for information on setting this property. Your page should resemble the following in Visual Studio.NET:

    Visual Studio design form  
  2. Set Magnifier control properties

    Select the Magnifier control.  In the Properties page:
    1. Set the Map property to Map1, the map control added earlier.
    2. Set the MapResourceManager property to the name of the MapResourceManager created and configured in the previous steps. 
    3. Set the MagnifierMapResource property to a ResourceItem in the MapResourceManager.  The ResourceItem cannot be a Graphics Layer.  
    4. Additional properties can be configured to change how the map behaves at runtime. For example, MagnificationFactor sets the default zoom level of the magnifier window. Properties in the Floating Panel Appearance group determine how the magnifier appears, such as background colors and whether to provide collapse/expand and close buttons on the magnifier window.

 

Members

Properties

  The following table provides a list of properties of interest.  For complete reference information, see the Magnifier control in the library reference section.

Property Name  Type Description
AreaOfInterestLineColor bool The color of the extent rectangle on the Magnifier control.
MagnificationFactor int The default magnification factor in the Magnifier window.
MagnifierMapResource string Map resource to be used for magnifying
Map string The Map control to use in obtaining the extent used by the magnifier.
MapResourceManager string The map resources used to display the image for the given magnification.