Tree, TreeNode, LeafTreeNode DTD and XML definitions

The Tree class extends EmbeddedPanel. It has the following entry in the DTD file:
Table 1. Tree definition
Line entry in the DTD file Description
<!ELEMENT Tree (TreeNode+)> A Tree has one or more TreeNodes
<!ATTLIST Tree
    name CDATA "Tree"
    width CDATA "307"
    height CDATA "457"
    backgroundNonSelectionColor CDATA #IMPLIED
    backgroundSelectionColor CDATA #IMPLIED
    foregroundNonSelectionColor CDATA #IMPLIED
    foregroundSelectionColor CDATA #IMPLIED
    iconName CDATA #IMPLIED
    hotKey CDATA #IMPLIED
    label CDATA #IMPLIED>
Attribute list
Table 2. Tree attributes
Attribute Description
name Name used by the Desktop to identify this component. Applications can have access to this object at runtime by requesting it by name from the Desktop.
width Width of the whole tree
height Height of the whole tree
backgroundNon SelectionColor Background color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
background SelectionColor Background color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
foregroundNon SelectionColor Foreground color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
foreground SelectionColor Foreground color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
iconName Name of the file containing the icon to be set in the Tree
hotKey Combination of keys used as a hot key for the Tree. Pressing this combination of keys when the Tree is visible on the Desktop is equivalent to clicking on the Tree.
label Label of the whole root tree

The TreeNode has the following entry in the DTD file:

Table 3. TreeNode definition
Line entry in the DTD file Description
<!ELEMENT TreeNode (TreeNode|LeafTreeNode)+> A TreeNode can contain zero or many TreeNodes and zero or many LeafTreeNodes
<!ATTLIST TreeNode
    backgroundNonSelectionColor CDATA #IMPLIED
    backgroundSelectionColor CDATA #IMPLIED
    foregroundNonSelectionColor CDATA #IMPLIED
    foregroundSelectionColor CDATA #IMPLIED
    iconName CDATA #IMPLIED
    name CDATA #IMPLIED
    label CDATA #IMPLIED
    toolTipText CDATA #IMPLIED>
Attribute list
Table 4. TreeNode attributes
Attribute Description
backgroundNon SelectionColor Background color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
background SelectionColor Background color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
foregroundNon SelectionColor Foreground color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
foreground SelectionColor Foreground color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
iconName Name of the file containing the icon to be set in the TreeNode
name Name used by the Desktop to identify this component
label Label of the TreeNode
toolTipText Text that is shown when the mouse cursor is moved over the TreeNode

The LeafTreeNode has the following entry in the DTD file:

Table 5. LeafTreeNode definition
Line entry in the DTD file Description
<!ELEMENT LeafTreeNode EMPTY> A LeafTreeNode does not contain any sub-elements
<!ATTLIST LeafTreeNode
    operation CDATA #IMPLIED
    process CDATA #IMPLIED
    application CDATA #IMPLIED
    operationPanel CDATA #IMPLIED
    code CDATA #IMPLIED
    parameters CDATA #IMPLIED
    shortDescription CDATA #IMPLIED
    yNavigationArea CDATA #IMPLIED
    xNavigationArea CDATA #IMPLIED
    heightNavigationArea CDATA #IMPLIED
    widthNavigationArea CDATA #IMPLIED
    longDescription CDATA #IMPLIED
    executeOperation CDATA #IMPLIED
    taskName CDATA #REQUIRED
    backgroundNonSelectionColor CDATA #IMPLIED
    backgroundSelectionColor CDATA #IMPLIED
    errorMessageOnInstantiateOperation CDATA "OperationerrorMessage"
    foregroundNonSelectionColor CDATA #IMPLIED
    foregroundSelectionColor CDATA #IMPLIED
    iconName CDATA #IMPLIED
    label CDATA #IMPLIED
    toolTipText CDATA #IMPLIED>
Attribute list
Table 6. LeafTreeNode attributes
Attribute Description
operation Name of the operation that launches when the LeafTreeNode is clicked. This name must match an operation name in any of the operation files handled by the toolkit. The operation is instantiated using the standard toolkit mechanism (DSEOperation.readObject(operation)).
process Name of the process to be instantiated by the Navigation Controller when the node is clicked
application Name of the application that launches when the node is clicked. The name must include the name of the package where the Java™ class is defined.
operationPanel Identifier (id) of the operation panel defined in the view definition file (view.xml) that is associated with the panel. If instantiation using the definition file fails, then the panel will be instantiated using this value directly as the classname for instantiation.
code Code by which the task will be identified by the system. Applications or operations can request a task with a specific code from the Desktop.
parameters String representing the list of parameters accepted by the operation. Any operation that accepts parameters must define a format named fastPathInputFormat that describes the format that the string should have. If the parameters attribute is specified, its value will be unformatted in the process context before launching the task.
shortDescription Text that is shown as the label of the launched task in the TaskArea
yNavigationArea Default vertical coordinate in the WorkingArea where the panel will be opened
xNavigationArea Default horizontal coordinate in the WorkingArea where the panel will be opened
heightNavigationArea Default height of the panel when it is first opened
widthNavigationArea Default width of the panel when it is first opened
longDescription Text that is shown when the mouse cursor is moved over the launched task in the TaskArea
executeOperation Whether the operation will be executed before displaying the operation panel
taskName Name of the task to launch (mandatory)
backgroundNon SelectionColor Background color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
background SelectionColor Background color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
errorMessageOn InstantiateOperation Text that is shown if an error occurs when launching the task
foregroundNon SelectionColor Foreground color when the element is not selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
foreground SelectionColor Foreground color when the element is selected. Possible values are the ones accepted by the class java.awt.Color: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow.
iconName Name of the file containing the icon to be set in the LeafTreeNode
label Label of the LeafTreeNode
toolTipText Text that is shown when the mouse cursor is moved over the LeafTreeNode
The following is an example of an XML definition for a Tree, TreeNode, and LeafTreeNode:
<Tree name="OperationsTree" width="237" 
    height="82" label="Operations" 
    backgroundSelectionColor="darkGray" hotKey="CTRL+O">
  <TreeNode label="Cash Operations" 
       backgroundSelectionColor="darkGray">
     <LeafTreeNode taskName="WITH" 
         label="Cash Withdrawal" 
         operation="withdrawalOperation" 
         operationPanel=".WithdrawalView"
         toolTipText="Withdrawal" 
         iconName=/images/Leaf_node.gif />
  </TreeNode>
  <TreeNode label="Non Cash Operations" 
       backgroundSelectionColor="darkGray">
     <LeafTreeNode taskName="DEPO" 
         label="Check Deposit" 
         operation="checkDeposit"
         operationPanel=" CheckDepositView" 
         toolTipText="Deposit"
         iconName=/images/Leaf_node.gif />
  </TreeNode>
</Tree>