Autodesk 15606-011408-9300 Developer Guide - Page 50

Overview, Working with Map Layers, Counting Map Layers

Page 50 highlights

Overview Throughout this chapter you will find simple JavaScript code samples that show you how to perform basic Autodesk MapGuide Viewer tasks in your application. You will learn how to work with map layers, features, and how to customize map printouts. Note that we refer to JavaScript code modules as functions, reserving the term method for the Autodesk MapGuide Viewer API. Also note that although spatial data on the map consists of map features, the methods and properties in the Autodesk MapGuide Viewer API that work with map features use the term object instead of feature. This difference in terminology exists because map features were called map objects in previous releases of Autodesk MapGuide. Be careful not confuse the term object in these API names with the object-oriented programming concept of objects. For example, the addObject method adds a map feature to the selection. Likewise, the MGMapObject object represents map features. Working with Map Layers This section describes common tasks your application can perform with Autodesk MapGuide map layers. Counting Map Layers The countLayers function counts the layers in a map and displays the count in a dialog box: function countLayers() { var map = getMap(); var layers = map.getMapLayersEx(); var cnt = layers.size(); alert("This map has " + cnt + " layer(s)."); } The function starts by calling the getMap function and assigning its return value to a variable called map: var map = getMap(); Remember that getMap is a custom function that detects the user's browser type and returns an MGMap object using the syntax required by that browser (see page "Map Access for ActiveX Control and Plug-In" on page 32). 50 | Chapter 4 Working with Map Layers, Map Features, and Printing

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208

50
|
Chapter 4
Working with Map Layers, Map Features, and Printing
Overview
Throughout this chapter you will find simple JavaScript code samples that
show you how to perform basic Autodesk MapGuide Viewer tasks in your
application. You will learn how to work with map layers, features, and how
to customize map printouts.
Note that we refer to JavaScript code modules as
functions
, reserving the term
method
for the Autodesk MapGuide Viewer API. Also note that although
spatial data on the map consists of
map features
, the methods and properties
in the Autodesk MapGuide Viewer API that work with map features use the
term
object
instead of feature. This difference in terminology exists because
map features were called map objects in previous releases of Autodesk
MapGuide. Be careful not confuse the term
object
in these API names with the
object-oriented programming concept of objects. For example, the
addObject
method adds a map
feature
to the selection. Likewise, the
MGMapObject
object represents map features.
Working with Map Layers
This section describes common tasks your application can perform with
Autodesk MapGuide map layers.
Counting Map Layers
The
countLayers
function counts the layers in a map and displays the
count in a dialog box:
function countLayers()
{
var map = getMap();
var layers = map.getMapLayersEx();
var cnt = layers.size();
alert("This map has " + cnt + " layer(s).");
}
The function starts by calling the
getMap
function and assigning its return
value to a variable called
map
:
var map = getMap();
Remember that
getMap
is a custom function that detects the user
s browser
type and returns an
MGMap
object using the syntax required by that browser
(see page
Map Access for ActiveX Control and Plug-In
on page 32).