ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH VISUAL JAVABEANS
Rather than walk through this scenario, you can
get the completed application from the samples
installation location. The sample is installed as
part of the ArcGIS developer samples.
The ArcGIS developer samples are not included
in the typical installation of the ArcGIS Engine
Developer Kit. If you don’t have them installed,
rerun the Developer Kit Install wizard, click
Custom or Modify, and click the samples feature
under Software developer kit.
This walkthrough is for developers who want to build and deploy an application
using visual Java components. It describes the process of building and deploying
an application using the visual JavaBeans available in the ArcGIS Engine Developer
Kit.
On Windows you can find this sample in:
\DeveloperKit\samples\Developer_Guide_Scenarios\
Building_an_ArcGIS_Controls_Map_Viewer_ApplicationJava.zip
On Solaris and Linux you can find the sample in:
/developerkit/samples/Developer_Guide_Scenarios/
Building_an_ArcGIS_Controls_Map_Viewer_ApplicationJava.zip
PROJECT DESCRIPTION
This scenario demonstrates the steps required to create a GIS application for
viewing preauthored ESRI map documents, or MXDs. The scenario covers the
following techniques:
• Setting up the development environment
• Building a GUI using the visual components
• Loading map documents
• Adding commands to the toolbar
• “Buddying up” the ToolbarBean and TOCBean
• Adding toolbar items to the ToolbarBean
• Creating a popup menu using ToolbarMenu
• Controlling Label Editing in the TOCBean component
• Drawing an overview rectangle on the MapBean
• Creating a custom tool
• Customizing the ToolbarBean
• Deploying using an executable JAR
CONCEPTS
The ArcGIS Engine Developer Kit provides reusable visual Java components
corresponding to each ArcGIS Control. This developer scenario will show how
these components can be embedded in a Java GUI to build a map viewer application.
The visual components provided by the ArcGIS Engine Developer Kit are heavyweight
AWT components that conform to the JavaBeans component architecture,
allowing them to be used as drag-and-drop components for designing Java GUIs
in JavaBeans-compatible IDEs. Each component has certain properties and
methods and is capable of firing events. Internally, the Java components use JNI
to host the ArcGIS controls, thereby providing nearly the same speed of execution
as any native application built using the controls. By assembling the ArcGIS
Engine visual components in a Java application and ‘wiring them up’ with each
other and with other ArcObjects components, custom GIS applications can be
rapidly built and deployed on supported ArcGIS Engine platforms.
304 • ArcGIS Engine Developer Guide