Perforce JViews TGO Sample: Tree Component - Custom Classes

Description

This sample shows how to create custom business classes and use them with the tree component.

How to Use the Sample

The sample shows a simple tree with a few nodes representing network domains and the computer equipment they contain.

The tree supports standard interaction for expanding and collapsing nodes, as well as multiple selection. Click a node to select it. Use the Shift key to select several adjacent nodes or Ctrl to select individual nodes.

How to Run the Sample as an Application

This sample can be run as an application. The installation directory contains an executable JAR file, tree-customClasses.jar, that allows you to execute the sample 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 sample 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 sample and type:

ant run

Topics Covered

• Basic initialization
  See the tree/basic sample for details
  
• Creating custom business classes
• Mapping attributes of custom classes to graphic properties using a style sheet
• Creating composite graphics to represent custom business objects in the tree

Detailed Description

This sample differs from the basic sample in that it shows instances of custom business classes. These classes are declared in customClasses and are instantiated in treenodes.

The attributes of the custom classes are mapped to the graphic attributes of the tree nodes by a set of CSS rules declared in tree.

Installation Directory

The Tree Component - Custom Classes sample is installed here.

Classes Involved

• ilog.tgo.IltSystem

  The class that initializes a JViews TGO application.

• ilog.tgo.datasource.IltDefaultDataSource

  The default datasource implementation.

• ilog.cpl.IlpTree

  The tree component.

• ilog.views.graphic.composite.IlvCompositeGraphic

  The composite graphic implementation to represent custom nodes.

• ilog.views.graphic.composite.layout.IlvAttachmentLayout

  The composite graphic layout implementation.

• ilog.views.graphic.composite.layout.IlvAttachmentConstraint

  The composite graphic attachment definition.

Source Files

• customClasses.Main

  The entry point of the sample.