ArcGIS Engine Developer Guide

More documents

Recommendations

Info

VISUAL C++ #import "C:\Program Files\ArcGIS\com\esriSystem.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids, exclude("OLE_COLOR", "OLE_HANDLE", "VARTYPE") #import "C:\Program Files\ArcGIS\com\esriSystemUI.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriGeometry.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriDisplay.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriOutput.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriGeoDatabase.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriCarto.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids // Some of the Engine controls #import "C:\Program Files\ArcGIS\bin\TOCControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\bin\ToolbarControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\bin\MapControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\bin\PageLayoutControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids // Additionally for 3D controls #import "C:\Program Files\ArcGIS\com\esri3DAnalyst.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\com\esriGlobeCore.olb" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\bin\SceneControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids #import "C:\Program Files\ArcGIS\bin\GlobeControl.ocx" raw_interfaces_only, raw_native_types, no_namespace, named_guids #pragma warning (pop) A similar issue arises when writing IDL that contains definitions from other type libraries. In this situation, use importlib just after the library definition. For example, writing an external command for ArcMap would require you to create a COM object implementing ICommand. This definition is in esriSystemUI and is imported into the IDL as follows: library WALKTHROUGH1CPPLib { importlib("stdole32.tlb"); importlib("stdole2.tlb"); importlib("C:\Program Files\ArcGIS\com\esriSystemUI.olb"); coclass ZoomIn { [default] interface IUnknown; 122 • ArcGIS Engine Developer Guide
VISUAL C++ For a general discussion of ATL, see the earlier section ‘ATL in brief’. interface ICommand; } }; ATL AND THE ACTIVEX CONTROLS This section covers how to use ATL to add controls to a dialog box. Although ATL is focused on providing COM support, it also supplies some useful Windows programming wrapper classes. One of the most useful is CWindow, a wrapper around a window handle (HWND). The method names on CWindow correspond to the Win32 API functions. For example: HWND buttonHWnd = GetDlgItem( IDC_BUTTON1 ); // Get window handle of button. CWindow myButtonWindow( buttonHWnd ); // Attach window handle to CWindow class. myButtonWindow.SetWindowText(_T("Button Title")); // Win32 function to change button caption CWindow is a generic wrapper for all window handles, so for specific Windows messages to window common controls, such as buttons, tree views, or edit boxes, one approach is to send window messages directly to the window, for example: // Set button to be checked (pushed in or checkmarked, depending on button style) myButtonWindow.SendMessage(BM_SETCHECK, BST_CHECKED); However, there are some wrapper classes for these standard window common controls in a header file atlcontrols.h. This is available as part of an ATL sample ATLCON supplied in MSDN. See the article “HOWTO: Using Class Wrappers to Access Windows Common Controls in ATL”, available for download from Microsoft. This header file is an early version of Windows Template Libraries. Visual Studio Resource Editor can be used to design and position Windows common controls and ActiveX controls on a dialog box. To create and manipulate the dialog box, a C++ class is typically created that inherits from CAxDialogImpl. This class provides the plumbing to create and manage the ActiveX control on a window. The ATL wizard can be used to supply the majority of the boilerplate code. The steps to create a dialog box and add an ActiveX control in an ATL project are discussed below. 1. Click the menu command Insert/New ATL Object. 2. Click the Miscellaneous category, then click the Dialog object. 3. A dialog box resource and a class inheriting from CAxDialogImpl will be added to your project. 4. Right-click the dialog box in Resource view and click Insert ActiveX Control. This will display a list of available ActiveX controls. 5. Double-click a control in the list to add that control to the dialog box. 6. Right-click the control and click Properties to set the control’s design-time properties. Chapter 4 • Developer environments • 123
Page 1 and 2:
ArcGIS ® Engine Developer Guide Ar
Page 3 and 4:
Contents CHAPTER 1: INTRODUCING ARC
Page 5 and 6:
1 Introducing ArcGIS Engine ESRI ®
Page 7 and 8:
ARCGIS 9 OVERVIEW ArcGIS Server Arc
Page 9 and 10:
ARCGIS 9 OVERVIEW ArcGIS Engine and
Page 11 and 12:
OVERVIEW OF ARCGIS ENGINE Chapter 3
Page 13 and 14:
OVERVIEW OF A RCGIS ENGINE The Stre
Page 15 and 16:
WHO CAN USE ARCGIS ENGINE? authored
Page 17 and 18:
ARCGIS ENGINE CAPABILITIES SPATIAL
Page 19 and 20:
ARCGIS ENGINE CAPABILITIES NETWORK
Page 21 and 22:
GETTING STARTED Throughout most of
Page 23 and 24:
USING THIS BOOK This book, ArcGIS E
Page 25:
DEVELOPER RESOURCES ESRI DEVELOPER
Page 28 and 29:
ARCGIS SOFTWARE ARCHITECTURE For a
Page 30 and 31:
ARCGIS SOFTWARE ARCHITECTURE ESRI h
Page 32 and 33:
ARCGIS SOFTWARE ARCHITECTURE Althou
Page 34 and 35:
ARCGIS APPLICATION PROGRAMMING INTE
Page 36 and 37:
ARCGIS ENGINE LIBRARIES Carto Conta
Page 38 and 39:
ARCGIS ENGINE LIBRARIES cluded in t
Page 40 and 41:
ARCGIS ENGINE LIBRARIES 22 Spatial-
Page 42 and 43:
ARCGIS ENGINE LIBRARIES NETWORKANAL
Page 45 and 46:
3 Developing with ArcGIS controls A
Page 47 and 48:
WORKING WITH THE ARCGIS CONTROLS me
Page 49 and 50:
WORKING WITH THE ARCGIS CONTROLS Ar
Page 51 and 52:
WORKING WITH THE ARCGIS CONTROLS If
Page 53 and 54:
WORKING WITH THE ARCGIS CONTROLS Li
Page 55 and 56:
BUILDING APPLICATIONS WITH THE ARCG
Page 57 and 58:
Page 59:
Page 62 and 63:
THE MICROSOFT COMPONENT OBJECT MODE
Page 64 and 65:
Page 66 and 67:
Page 68 and 69:
Page 70 and 71:
Page 72 and 73:
Page 74 and 75:
DEVELOPING WITH ARCOBJECTS ArcGIS a
Page 76 and 77: DEVELOPING WITH A RCOBJECTS Accessi
Page 78 and 79: DEVELOPING WITH A RCOBJECTS As an e
Page 80 and 81: DEVELOPING WITH A RCOBJECTS COM App
Page 82 and 83: DEVELOPING WITH A RCOBJECTS The Cus
Page 84 and 85: THE V ISUAL BASIC 6 ENVIRONMENT Use
Page 86 and 87: THE V ISUAL BASIC 6 ENVIRONMENT Whi
Page 88 and 89: THE V ISUAL BASIC 6 ENVIRONMENT Pri
Page 90 and 91: THE V ISUAL BASIC 6 ENVIRONMENT Tha
Page 92 and 93: THE V ISUAL BASIC 6 ENVIRONMENT per
Page 94 and 95: THE V ISUAL BASIC 6 ENVIRONMENT If
Page 96 and 97: THE V ISUAL BASIC 6 DEVELOPMENT ENV
Page 104 and 105: VISUAL C++ IXxxImpl CComXxxThreadMo
Page 106 and 107: VISUAL C++ Linking ATL code One of
Page 108 and 109: VISUAL C++ removal would result in
Page 110 and 111: VISUAL C++ switches are used to cha
Page 112 and 113: VISUAL C++ 4. To create the noncrea
Page 114 and 115: VISUAL C++ Grimes, Richard, Reilly
Page 116 and 117: VISUAL C++ IFooPtr ipFoo; HRESULT h
Page 118 and 119: VISUAL C++ expected. It is better t
Page 120 and 121: VISUAL C++ Here are some suggestion
Page 122 and 123: VISUAL C++ Symbol d, i Format signe
Page 124 and 125: VISUAL C++ Loading the following sh
Page 128 and 129: VISUAL C++ Make sure dialog boxes t
Page 130 and 131: VISUAL C++ Creating an MFC dialog b
Page 132 and 133: VISUAL C++ This environment does no
Page 134 and 135: VISUAL C++ Connection point mechani
Page 136 and 137: VISUAL C++ The following issues wit
Page 138 and 139: VISUAL C++ { } DECLARE_REGISTRY_RES
Page 140 and 141: VISUAL C++ 5. Clicking OK will modi
Page 142 and 143: VISUAL C++ delete[] pvars; // Clean
Page 144 and 145: VISUAL C++ // Create dialog class o
Page 146 and 147: .NET APPLICATION PROGRAMMING INTERF
Page 176 and 177:
.NET APPLICATION PROGRAMMING INTERF
Page 178 and 179:
Page 180 and 181:
Page 182 and 183:
Page 184 and 185:
Page 186 and 187:
JAVA APPLICATION PROGRAMMING INTERF
Page 188 and 189:
Page 190 and 191:
Page 192 and 193:
Page 194 and 195:
Page 196 and 197:
Page 198 and 199:
Page 200 and 201:
Page 202 and 203:
C++ APPLICATION PROGRAMMING INTERFA
Page 204 and 205:
Page 206 and 207:
Page 208 and 209:
Page 210 and 211:
Page 212 and 213:
Page 214 and 215:
Page 216 and 217:
Page 218 and 219:
Page 220 and 221:
Page 222 and 223:
Page 224 and 225:
Page 226 and 227:
Page 228 and 229:
Page 230 and 231:
Page 232 and 233:
Page 234 and 235:
Page 236 and 237:
Page 238 and 239:
Page 240 and 241:
Page 242 and 243:
Page 244 and 245:
Page 246 and 247:
Page 248 and 249:
Page 250 and 251:
Page 252 and 253:
Page 254 and 255:
Page 257 and 258:
5 Licensing and deployment Developm
Page 259 and 260:
ARCGIS LICENSING OPTIONS PRODUCT LI
Page 261 and 262:
ARCGIS LICENSING OPTIONS ArcGIS Eng
Page 263 and 264:
ARCGIS ENGINE DEVELOPER KIT At the
Page 265 and 266:
APPLICATION DEVELOPMENT AND LICENSE
Page 267 and 268:
Page 269 and 270:
Page 271 and 272:
Page 273 and 274:
Page 275 and 276:
Page 277 and 278:
Page 279 and 280:
TESTING WITH ARCGIS ENGINE RUNTIME
Page 281 and 282:
DEPLOYMENT To successfully deploy c
Page 283 and 284:
DEPLOYMENT 3. You or your client in
Page 285 and 286:
6 Developer scenarios Throughout th
Page 287 and 288:
BUILDING APPLICATIONS WITH ACTIVEX
Page 289 and 290:
Page 291 and 292:
Page 293 and 294:
Page 295 and 296:
Page 297 and 298:
Page 299 and 300:
Page 301 and 302:
Page 303 and 304:
Page 305 and 306:
Page 307 and 308:
Page 309 and 310:
BUILDING APPLICATIONS WITH VISUAL J
Page 311 and 312:
Page 313 and 314:
Page 315 and 316:
Page 317 and 318:
Page 319 and 320:
Page 321 and 322:
Page 323 and 324:
Page 325 and 326:
Page 327 and 328:
Page 329 and 330:
Page 331 and 332:
Page 333 and 334:
Page 335 and 336:
BUILDING APPLICATIONS WITH WINDOWS
Page 337 and 338:
Page 339 and 340:
Page 341 and 342:
Page 343 and 344:
Page 345 and 346:
Page 347 and 348:
Page 349 and 350:
Page 351 and 352:
Page 353 and 354:
Page 355 and 356:
Page 357 and 358:
Page 359 and 360:
Page 361 and 362:
BUILDING APPLICATIONS WITH C++ AND
Page 363 and 364:
Page 365 and 366:
Page 367 and 368:
Page 369 and 370:
Page 371 and 372:
Page 373 and 374:
Page 375 and 376:
Page 377 and 378:
Page 379 and 380:
Page 381 and 382:
Page 383 and 384:
Page 385 and 386:
Page 387 and 388:
Page 389 and 390:
Page 391 and 392:
Page 393 and 394:
Page 395 and 396:
Page 397 and 398:
Page 399 and 400:
Page 401 and 402:
Page 403 and 404:
Page 405 and 406:
Page 407 and 408:
Page 409 and 410:
Page 411 and 412:
Page 413 and 414:
BUILDING A COMMAND-LINE JAVA APPLIC
Page 415 and 416:
Page 417 and 418:
Page 419 and 420:
Page 421 and 422:
Page 423 and 424:
Page 425 and 426:
Page 427 and 428:
Page 429 and 430:
Page 431 and 432:
BUILDING A COMMAND-LINE C++ APPLICA
Page 433 and 434:
Page 435 and 436:
Page 437 and 438:
Page 439 and 440:
Page 441 and 442:
Page 443 and 444:
Page 445 and 446:
A Reading the object model diagrams
Page 447 and 448:
CLASSES AND RELATIONSHIPS There are
Page 449 and 450:
CLASSES AND RELATIONSHIPS N-ary ass
Page 451 and 452:
INTERFACES AND MEMBERS error messag
Page 453:
PUTTING IT TOGETHER—AN EXAMPLE IW
Page 456 and 457:
ARCGIS SOFTWARE DEVELOPER KIT The A
Page 458 and 459:
ARCGIS SOFTWARE DEVELOPER KIT • E
Page 461 and 462:
C Conver erting personal geodatabas
Page 463 and 464:
CONVERTING DATA FOR USE WITH THE GI
Page 465 and 466:
CONVERTING DATA FOR USE WITH THE GI
Page 467 and 468:
D Installing ArcGIS Engine Runtime
Page 469 and 470:
INSTALLING ARCGIS ENGINE RUNTIME ON
Page 471 and 472:
Page 473 and 474:
Page 475 and 476:
Page 477 and 478:
Page 479 and 480:
Page 481 and 482:
Page 483 and 484:
Page 485 and 486:
Page 487 and 488:
Page 489 and 490:
Page 491 and 492:
Page 493 and 494:
Page 495 and 496:
E Glossary The following is a gloss
Page 497 and 498:
GLOSSARY ASP.NET assembly associati
Page 499 and 500:
GLOSSARY composition computer-aided
Page 501 and 502:
GLOSSARY FGDC framework GDB GDI Geo
Page 503 and 504:
GLOSSARY JSF JSP JSTL late binding
Page 505 and 506:
GLOSSARY the EXE in which they are
Page 507 and 508:
GLOSSARY server account server cont
Page 509 and 510:
GLOSSARY URL usage time utility COM
Page 511 and 512:
A Index Abstract class 61 defined 4
Page 513 and 514:
Building applications with ActiveX
Page 515 and 516:
debugging defined 495 Deeply statef
Page 517 and 518:
IIS 143 ILineSymbol interface 292,
Page 519 and 520:
OLE automation. See Microsoft Compo
Page 521 and 522:
SXD defined 504 Synchronization def
Page 523:
XSLT defined 506 Index • 519
show all

ArcGIS Engine Developer Guide

Create successful ePaper yourself

Delete template?

Save as template?