Autodesk 15606-011408-9300 Developer Guide - Page 48

Checking for Incorrect Argument Types, Debugging an Application

Get Autodesk 15606-011408-9300 - MAPGUIDE R6.3 UPG PDF manuals and user guides
UPC - 606121429548
View all Autodesk 15606-011408-9300 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 48 highlights

To get the most recently called method error code 1 Call the MGMap.getLastError method to get the MGError object. 2 Next call the MGError.getCode method to get the error code. For example: function checkErrorCode() { var map = getMap(); var code = map.getLastError().getCode(); alert("ERROR: " + code); } Checking for Incorrect Argument Types If you call an API method with incorrect argument types, by default, Autodesk MapGuide Viewer has the method do nothing and flags the error in MGError. You can see which argument was incorrect by calling the MGError.getArg method. To check for an incorrect argument type for the most recently called method 1 Call the MGMap.getLastError method to get the MGError object. 2 Next call the MGError.getArg method to get the number of the incorrect argument. For example: function checkArgType() { var map = getMap(); var arg = map.getLastError().getArg(); alert("ERROR: " + arg); } To see the argument types for any API method, locate that method's Help topic in the Autodesk MapGuide Viewer API Help. Debugging an Application In addition to checking MGError, you can call the MGMap.enableApiExceptions and MGMap.disableApiExceptions methods to throw or not throw exceptions. When exceptions are enabled and the MGError code is set to a non-zero value, Autodesk MapGuide throws an exception. Depending on your development environment, the exception will halt your code and send an error message containing the line number of the error to the screen. 48 | Chapter 3 Accessing Maps

  • 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
48
|
Chapter 3
Accessing Maps
To get the most recently called method error code
1
Call the
MGMap.getLastError
method to get the
MGError
object.
2
Next call the
MGError.getCode
method to get the error code. For
example:
function checkErrorCode()
{
var map = getMap();
var code = map.getLastError().getCode();
alert("ERROR: " + code);
}
Checking for Incorrect Argument Types
If you call an API method with incorrect argument types, by default,
Autodesk MapGuide Viewer has the method do nothing and flags the error
in
MGError
. You can see which argument was incorrect by calling the
MGError.getArg
method.
To check for an incorrect argument type for the most recently called method
1
Call the
MGMap.getLastError
method to get the
MGError
object.
2
Next call the
MGError.getArg
method to get the number of the incorrect
argument. For example:
function checkArgType()
{
var map = getMap();
var arg = map.getLastError().getArg();
alert("ERROR: " + arg);
}
To see the argument types for any API method, locate that method
’
s Help
topic in the
Autodesk MapGuide Viewer API Help
.
Debugging an Application
In addition to checking
MGError
, you can call the
MGMap.enableApiExceptions
and
MGMap.disableApiExceptions
methods to throw or not throw exceptions. When exceptions are enabled
and the
MGError
code is set to a non-zero value, Autodesk MapGuide throws
an exception. Depending on your development environment, the exception
will halt your code and send an error message containing the line number of
the error to the screen.