DuplicateMap()
Summary
Creates a copy of a map.
Changes
Added to Version 6.0/2012.
Syntax
map_name = DuplicateMap(string mapname, array options)
| Argument | Contents |
|---|---|
| mapname | The name of the map to copy |
| Option | Type | Contents |
|---|---|---|
| Activate Macro | String | The name of a macro called whenever the map window is activated |
| Auto Project | Boolean | If "True" the map projection is chosen automatically based on the current scope and scale; if "False" projections are not automatically changed |
| Close Macro | String | The name of a macro called when the user closes the map from the system menu |
| Done Macro | String | The name of a macro that is called after the window is closed |
| Locked | Boolean | If "True" the Close option does not appear in the system menu; if "False" the Close option does appear |
| Menu | String | The menu associated with the map window |
| Position | 2 integers | The screen location of the window (x, y) |
| Scale Change Macro | String | The name of a macro function called whenever the scale or scope of the map changes |
| Scope | Scope | The initial (default) scope of the map |
| Size | 2 integers | The screen size of the window (x, y) |
| Toolbar | String | The toolbar associated with the map window |
Returns
A string indicating the name of the new map.
Notes
-
The scale change macro runs whenever the map scale changes. This occurs when functions such as SetMapScope() or SetScale()) are called, or when the user resizes or reshapes the map window.
-
The position and size of the map window are expressed as percentages of the Maptitude frame.
-
The attached menu and toolbar are automatically displayed whenever the map is activated.
-
If the menu, toolbar, activate macro, close macro, or scale change macro is not specified, DuplicateMap() uses the default specified with SetDefaults(). If a map specific default was not specified with SetDefaults() then DuplicateMap() uses the generic default.
-
For a full list of GISDK functions for annotations, see Freehand Items (Annotations).
Error Codes
| Error Type | Meaning |
|---|---|
| Error | The map window could not be created |
| NotFound | The specified map does not exist |
See Also
| Function | Summary |
|---|---|
| CloseMap() | Closes a map window |
| OpenMapFromAnnotation() | Creates a new map window from a map that appears in a layout |
| OpenMap() | Opens a map file and displays it in a map window |
| CreateMap() | Creates a new, empty map window. |
| SaveMap() | Saves settings for a map window to a file on disk |