Perforce JViews Diagrammer Code Example: Diagram Editor

---

Description

This sample shows the code needed to build a simple diagram editor using the Perforce JViews Diagrammer component.

How to Use the Code Example

• Click the last-but-one icon in the horizontal toolbar.
• Click in the Unnamed view to create a node.
• Repeat steps above to create another node.
• Click the last icon in the horizontal toolbar.
• Click the first node that you created, then the second node to create a link between these nodes.
• Repeat steps above to create other nodes and links.
• Select and move nodes (make sure the first icon in the horizontal toolbar is selected).
• Use the (vertical) control bar to zoom and pan the view.
• Click the Layout Nodes button to place the nodes automatically according to the link hierarchy.
• Save your diagram using the Save button or the File>Save menu item.
• Close the diagram and reopen it using the Open button or the File>Open menu item.
• You can create several diagrams by clicking the New icon several times.
• The horizontal toolbar provides the usual editing operations: cut, copy, paste, undo, redo, and so on.

How to Run the Code Example as an Application

This code example can be run as an application. The installation directory contains an executable JAR file, diagrammer-editor.jar, that allows you to execute the code example with a double click from a file browser. Note that if you are using Internet Explorer, you can open the installation directory and execute the JAR file from the browser. This technique may not work in other Web browsers.

Alternatively, you can run the code example application from the command line. First check that the Ant utility is properly configured. If not, see the instructions on how to configure Ant for Perforce JViews.

Then, go to the installation directory of the code example and type:

ant run

Topics Covered

• Create a simple multidocument diagram editor using a diagram component.
• Create a toolbar to edit the diagram.
• Create "palette" icons in a toolbar to create nodes and links in a diagram.
• Create a toolbar to control the diagram view.

Detailed Description

This sample shows the code needed to build a simple diagram editor using a Perforce JViews Diagrammer component.

An alternative way of creating an editor is to use the ready-to-use IlvDiagrammerApplication class. This sample shows how to build your own custom editor without using IlvDiagrammerApplication.

The sample uses some of the application components in the package ilog.views.diagrammer.application, such as the edit and palette toolbars. You can also build your own custom toolbars.

Installation Directory

The Diagram Editor code example is installed here.

Classes Involved

• ilog.views.diagrammer.IlvDiagrammer

  The main class of the diagram component.

• ilog.views.diagrammer.application.IlvDiagrammerViewBar

  The class used to create predefined toolbars to control the diagram component's view.

• ilog.views.diagrammer.application.IlvDiagrammerEditBar

  The class used to create predefined toolbars to edit the diagram component.

• ilog.views.diagrammer.application.IlvDiagrammerMenuBar

  The class used to create predefined menubars to control the diagram component.

• ilog.views.diagrammer.application.IlvDiagrammerAction

  The base class of Swing actions that act on a diagram component.

Source Files

• DiagramEditor

  The entry point of the sample.

Copyright © 2021 Rogue Wave Software, Inc., a Perforce company. All rights reserved. Legal terms.