Adding a Map Control Display

You can use Map Control in GraphWorX to create and configure an interactive map in a GraphWorX display. To create an interactive map, you create a new display in GraphWorX and insert a Map Control viewer from the Controls ribbon.

You can zoom in and out of the map and place interactive GraphWorX objects on it. Every object that you add to the display has a latitude and longitude on the map. You can connect dynamic tags to the longitude and latitude properties, and you can use GPS for Dynamics in Map Control.

Since some features are unique to Map Control, plan the assembly of your map to be constructed in accordance with the Map Control features and limitations.

You can only add a map to the primary (or root) layer of a display. Once Map Control is added to a GraphWorX display, the map becomes the primary focus; other GraphWorX objects cannot be added behind or on the periphery of the map. Any objects added to the map, such as shapes or pins, are added to the primary layer and interconnected with the map.

You can add extra layers containing shapes and controls. However, the shapes and controls are given a latitude and longitude in relation to the map, so that they become part of the map's surface, even if they are in a separate layer. All objects added to a GraphWorX display behave in relation to the map; there are no other objects outside of the map's confines.

For that reason, you cannot build a larger GraphWorX display around the map; however, you can save the map in its own GraphWorX (.gdfx) file and include that saved file in another GraphWorX display.

To create a new GraphWorX display with Map Control:

  1. Open GraphWorX in the configuration mode (default). On the Controls ribbon, select Map Control, and then drag the mouse diagonally across the canvas to make a rectangle for inserting the viewer.

  2. A warning message appears, informing you that the display is not using the standard Map Control size, and asking if you want to display the standard size.

    Do one of the following:

    • Click Yes to create a standard-size map (recommended). You cannot place any objects outside of the map's confines, and all objects that you add to the display will be placed in relation to the map's latitude and longitude.
    • Click No to create a space around the edge of the map where you can add objects that are independent on the map. Keep in mind that objects added outside the map become very large and unusable when you zoom in on the map, so we do not recommend this option. However, you can use it to add an object such as a trend or alarm viewer on a map that you do not zoom in on very often.

  3. On the Map Control Configuration ribbon, expand Setup Connection and select Add New Connection to open the Setup Map Connection dialog.

  4. In Map Type, select Esri, which is the default map system with preconfigured data, and then click OK. If you select any other available map type, you need to configure the required settings.

    You can add multiple connections to your Map Control.
  5. When finished, expand Setup Connection again and select Manage Connections to display the Map Provider Connections dialog. It displays the list of configured connections with the Available/Unavailable status and buttons for connecting, editing, or removing the connection. You can also add a new connection from here.

  6. Select the desired connection and click Connect. When the gray field below the list returns "Connected", click Close.

  7. On the Map Control Configuration ribbon in the Map information section, enter the zoom level by selecting a number from 1 to 16 in the Zoom Level drop-down list. In the Latitude and Logitude fields, enter the latitude and longitude of the center of the display, or use the display scroll bars to adjust the map to the desired area, and the values are entered automatically.

  8. Verify the Map Control settings in runtime. Use the options on the upper right of the GraphWorX screen to switch to the runtime mode or to open the display in a web browser .