Controls

• Engine

• Common themes and concepts
• MapBean
• PageLayoutBean
• GlobeBean
• SceneBean
• TOCBean
• ToolbarBean
• SymbologyBean

• Embeddable components
• Property pages
• Encapsulated ArcObjects
• Events
• Buddy controls
• Map authoring
• Products
• Extensions
• Shutdown

Embeddable components

Property pages

Encapsulated ArcObjects

Events

Buddy controls

try{
    TOCBean.setBuddyControl(aMapBean);
}

catch (IOException e){
    e.printStackTrace();
}

Map authoring

Products

try{
    AoInitialize ao = new AoInitialize();
    if (ao.isProductCodeAvailable
        (esriLicenseProductCode.esriLicenseProductCodeEngine) ==
        esriLicenseStatus.esriLicenseAvailable)
        ao.initialize(esriLicenseProductCode.esriLicenseProductCodeEngine);
    else if (ao.isProductCodeAvailable
        (esriLicenseProductCode.esriLicenseProductCodeArcView) ==
        esriLicenseStatus.esriLicenseAvailable)
        ao.initialize(esriLicenseProductCode.esriLicenseProductCodeArcView);
}

catch (Exception e){
    e.printStackTrace();
}

Extensions

Shutdown

private static void shutdownArcObjects(){
    try{
        aoInit.shutdown();
    }
    catch (Exception ex){
        ex.printStackTrace();
        System.exit(0);
    }
}

Loading map documents

 

String filePath = "C:\\Temp\\myDocument.mxd";
try{
    if (mapBean.checkMxFile(filePath) == true){
        mapBean.loadMxFile(filePath, null, null);
    }
}

catch (AutomationException e){
    e.printStackTrace();
}

catch (IOException e){
    e.printStackTrace();
}

Saving map documents

Layers

Display

public void onMouseDown(com.esri.arcgis.controls.IMapControlEvents2OnMouseDownEvent
    e){

    try{
        mapBean.setExtent(mapBean.trackRectangle());
    }
    catch (AutomationException e){
        e.printStackTrace();
    }
    catch (IOException e){
        e.printStackTrace();
    }

}

Loading map documents

Saving map documents

try{
    mapDocument = new MapDocument();
    mapDocument.esri_new("C:\\Temp\\myDocument.mxd");
    mapDocument.replaceContents((IMxdContents)pagelayoutbean.getObject());
    mapDocument.setActiveView(pagelayoutbean.getActiveView());
    mapDocument.save(true, true);
}

catch (UnknownHostException e){
    e.printStackTrace();
}

catch (IOException e){
    e.printStackTrace();
}

Elements

Printing

 

Globe objects

Loading globe documents

String filePath = "C:\\Temp\\MyGlobeDocument.3dd";
try{
    if (globeBean.check3dFile(filePath) == true){
        globeBean.load3dFile(filePath);
    }
}

catch (AutomationException e){
    e.printStackTrace();
}

catch (IOException e){
    e.printStackTrace();
}

Navigation

Scene objects

Loading scene documents

String filePath = "C:\\Temp\\MySceneDocument.sxd";
try{
    if (sceneBean.checkSxFile(filePath) == true){
        sceneBean.loadSxFile(filePath);
    }
}

catch (AutomationException e){
    e.printStackTrace();
}

catch (IOException e){
    e.printStackTrace();
}

Navigation

try{
    TOCBean.setBuddyControl(aMapBean);
}

catch (Exception e){
    e.printStackTrace();
}

Layer drag and drop

• In a map
• To and from group layers
• Between maps
• Between maps in different TOCBeans

Selected item

try{
    IBasicMap basicmap[] = {
        null
    };
    ILayer layer[] = {
        null
    };
    Object other[] = {
        null
    };
    int itemType[] = {
        0
    };
    Object pIndex[] = {
        null
    };
    toc.hitTest(e.getX(), e.getY(), itemType, basicmap, layer, pIndex, other);

    System.out.println("Item Type: " + itemType[0]);
}

catch (Exception ex){
    ex.printStackTrace();
}

toolbarBean.setBuddyControl(aMapBean);

Commands

• A command item implementing the ICommand interface that responds to a single click. A click results in a call to the ICommand.OnClick method and some action is performed. By changing the ICommand.IsChecked value, simple command items can behave like a toggle.
• A command item or tool implementing the ICommand and ITool interfaces that requires user interaction with the display of the buddy control. The ToolbarBean maintains one CurrentTool. When the user clicks the tool on the ToolbarBean, it becomes the CurrentTool and the previous tool is deactivated. The ToolbarBean sets the CurrentTool of the buddy control. While the tool is the CurrentTool, it receives mouse and key events from the buddy control.
• A command item or tool control implementing the ICommand and IToolControl interfaces. This is typically a UI component, such as a Listbox or ComboBox hosted on the ToolbarBean. The ToolbarBean hosts a small window supplied by a window handle from the IToolControl.GetHWnd property. Only a single instance of a particular tool control can be added to the ToolbarBean.

 

toolbarBean1.setBuddyControl(mapBean1);
toolbarBean1.addItem(new ControlsMapFullExtentCommand(), 0, 0, false, 0,
    esriCommandStyles.esriCommandStyleIconAndText);
toolbarBean1.addItem(new ControlsMapZoomOutTool(), 0, 0, false, 0,
    esriCommandStyles.esriCommandStyleIconAndText);
toolbarBean1.addItem(new ControlsMapZoomInTool(), 0, 0, true, 0,
    esriCommandStyles.esriCommandStyleIconAndText);
toolbarBean1.addItem(new ControlsOpenDocCommand(), 0, 0, false, 0,
    esriCommandStyles.esriCommandStyleIconAndText);

ToolbarItem

Updating commands

ToolbarMenu

toolbarBean1.addItem(new ControlsMapViewMenu(), 0, 0, false, 0,
    esriCommandStyles.esriCommandStyleIconAndText);

ToolbarPalette

toolbarPalette1 = new ToolbarPalette();
toolbarPalette1.addItem(new ControlsSelectTool(), 0,  - 1);
toolbarPalette1.addItem(new ControlsNewCircleTool(), 0,  - 1);
toolbarPalette1.addItem(new ControlsNewCurveTool(), 0,  - 1);
toolbarBean1.addItem(toolbarPalette1, 0,  - 1, true,  - 1,
    esriCommandStyles.esriCommandStyleIconOnly);

CommandPool

Customization

• Click to select an item on the ToolbarBean, drag the selected item to a new position or drag-and-drop the item off the ToolbarBean to remove it.
• Right-click to select an item and display a customize menu. The Customize menu can be used to remove the item or change the style (bitmap, caption, or both) and group properties of the ToolbarItem.

Operation stack

Appearance

Control commands

Control commands with the ToolbarBean

• In a design-time environment of the Eclipse IDE—On the design-time canvas, right-click the ToolbarBean and click Customize Java Bean. This opens a dialog box that allows interactive placement, repositioning, and removal of items on the toolbar. It also allows for the UI of the toolbar and toolbar items to be modified.
• Programmatically using the AddItem, AddMenuItem, and AddToolbarDef methods—The commands can be added to a ToolbarMenu using the AddItem and AddSubMenu methods, and the commands can be added to a ToolbarPalette using the AddItem method.
• By the end user if the ToolbarBean is in customize mode.

Control commands without the ToolbarBean

• A new instance of a command is created programmatically and the individual ArcGIS control is passed to the OnCreate event. For example, if the Zoom FullExtent command is to work with the MapBean, pass the MapBean as the hook to the OnCreate method.
• A developer can use the CommandPool object without the ToolbarBean to manage the commands used by an application. The CommandPool provides support for calling the OnCreate method of each command based on its hook property.
• If the command only implements the ICommand interface, call the OnClick method at the appropriate time to perform the specific action. If the command is a tool that implements the ICommand and ITool interfaces, set the tool to be the CurrentTool in the ArcGIS control. The ArcGIS control sends any keyboard and mouse events to the tool.
• A command's Enabled, Caption, and Bitmap properties can be read and set into the properties of a command button supplied by the development environment to build up the UI of the application.
  

ControlsSelectFeaturesTool command = new ControlsSelectFeaturesTool();
command.OnCreate(aMapBean);
aMapBean.setCurrentToolByRef(command);

Creating custom commands

• The HookHelper object is used to hold onto the hook and the IHookHelper interface it implements can return the ActiveView, PageLayout, and Map regardless of the type of hook that is passed.
• The GlobeHookHelper object is used to hold onto the hook and the IGlobeHookHelper interface it implements can return the Camera, Globe, GlobeDisplay, and ActiveViewer regardless of the type of hook that is passed.
• The SceneHookHelper object is used to hold onto the hook and the ISceneHookHelper interface it implements can return the SceneViewer, Scene, SceneGraph, and Camera regardless of the type of hook that is passed.
  

public void onCreate(Object obj){

    try{
        hookHelper = new HookHelper();
        hookHelper.setHookByRef(obj);
    }
    catch (IOException ex){
        System.out.println("Exception");
        throw new RuntimeException(ex);
    }
}

public void onClick(){
    try{
        Array myArray = new Array();
        MapSelection selection = new MapSelection(hookHelper.getFocusMap()
            .getFeatureSelection());
        IEnumFeature enumFeature = (IEnumFeature)selection;
        IFeature feature = null;

        // Add the selected features geometry to the array.
        enumFeature.reset();
        feature = enumFeature.next();
        while (feature != null){
            myArray.add(feature.getShape());
            feature = enumFeature.next();
        }

        // If zooming is supported, zoom to the selected features.
        if (hookHelper.isActionSupportedOnMultiple(myArray,
            esriHookActions.esriHookActionsZoom)){
            hookHelper.doActionOnMultiple(myArray,
                esriHookActions.esriHookActionsZoom);
        }

    }
    catch (Exception e){
        e.printStackTrace();
    }
}

Singleton objects

• The CommandEnvironment object implements the IGraphicProperties and ILayerEffectProperties interfaces. The members of IGraphicProperties manage the default MarkerSymbol, LineSymbol, and FillSymbol used by the Control commands.
• The EngineEditor object implements the IEngineEditProperties, IEngineEditProperties2, and IEngineSnapEnvironment interfaces. The members of these interfaces manage the properties of edit sessions and snap agents.
• The EngineInkEnvironment object implements the IEngineInkEnvironment and IEngineInkEnvironmentEvents interfaces. The members of these interfaces manage the ink collection and manage tablet properties.
• The EngineNetworkAnalystEnvironment object implements the IEngineNetworkAnalystEnvironment, IEngineNetworkAnalystEnvironmentEvents, and IEngineNetworkAnalystHelper interfaces. The members of these interfaces manage the collection of network layers, the current network layer, solving and getting directions.
• The MyPlaceCollection object implements the IEnumPlace and IPlaceCollection interfaces. The members of these interfaces manage the addition and removal of Place objects to the place collection.

 

Loading server style files

aSymbologyBean.loadStyleFile( / apps / ArcGIS / Styles / ESRI.ServerStyle ");

SymbologyStyleClass

IStyleGalleryItem serverStyleGalleryItem = aSymbologyBean.getStyleClass2
    (aSymbologyBean.getStyleClass()).getSelectedItem();
System.out.println(serverStyleGalleryItem.getName());