TaskLauncherButton DTD and XML definitions

The TaskLauncherButton extends SpButton. It has the following entry in the DTD file:
Table 1. TaskLauncherButton definition
Line entry in the DTD file Description
<!ELEMENT TaskLauncherButton EMPTY> A TaskLauncherButton does not contain any sub-elements
<!ATTLIST TaskLauncherButton
    name CDATA #IMPLIED
    label CDATA #REQUIRED
    toolTipText CDATA #REQUIRED
    width CDATA "90"
    height CDATA "22"
    x CDATA #IMPLIED
    y CDATA #IMPLIED
    yNavigationArea CDATA #IMPLIED
    xNavigationArea CDATA #IMPLIED
    heightNavigationArea CDATA #IMPLIED
    widthNavigationArea CDATA #IMPLIED
    operation CDATA #IMPLIED
    process CDATA #IMPLIED
    application CDATA #IMPLIED
    operationPanel CDATA #IMPLIED
    code CDATA #IMPLIED
    parameters CDATA #IMPLIED
    shortDescription CDATA #IMPLIED
    longDescription CDATA #IMPLIED
    executeOperation CDATA #IMPLIED
    taskName CDATA #REQUIRED
    enabled (true|false) #IMPLIED
    errorMessageOnInstantiateOperation CDATA "OperationerrorMessage"
    hotKey CDATA #IMPLIED
    mnemonic CDATA #IMPLIED
    onClick CDATA #IMPLIED
    onMouseEntered CDATA #IMPLIED
    onMouseExited CDATA #IMPLIED
    onInitialize CDATA #IMPLIED>
Attribute list
Table 2. TaskLauncherButton 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.
label Label of the button (mandatory)
toolTipText Text that is shown when the mouse cursor is moved over the button (mandatory)
width Width of the button
height Height of the button
x Horizontal coordinate for the location of the button
y Vertical coordinate for the location of the button
xNavigationArea Default horizontal coordinate where the panel will be opened
yNavigationArea Default vertical coordinate where the panel will be opened
heightNavigationArea Default panel height when first opened
widthNavigationArea Default panel width when first opened
operation Name of the operation that launches when the button 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 button is clicked
application Name of the application that launches when the button 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.
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
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 given to the task. This attribute is mandatory, and can be used to refer to the TaskInfo defined by this TaskLauncher, by any other TaskLauncher, or by another Desktop process.
enabled Whether the button is enabled when it is created
errorMessageOn InstantiateOperation Text that is shown if an error occurs when launching the task
hotKey Combination of keys used as a hot key for the button. Pressing this combination of keys when the button is visible on the Desktop is equivalent to clicking the button.
mnemonic Letter used as a mnemonic in the button label. Pressing the combination Alt+mnemonic when the button is visible on the Desktop is equivalent to clicking the button.
onClick Java code to be executed when the button is clicked
onMouseEntered Java code to be executed when the mouse cursor is placed over the button
onMouseExited Java code to be executed when the mouse cursor is moved away from the button
onInitialize Java code to be executed when the component is initialized
The following is an example of an XML definition for a TaskLauncherButton:
<TaskLauncherButton name="WTHBUTTON" label="Cash Withdrawal" 
  mnemonic="W" taskName="TX01" 
  operation="withdrawalOperation" 
  operationPanel=" WithdrawalView" 
  shortDescription="Withdrawal" 
  longDescription="Cash Withdrawal Operation" 
  toolTipText="Cash Withdrawal" 
  onClick="EXITBUTTON.setEnabled(false)" 
  onMouseEntered="this.setForeground(new java.awt.Color(255,255,255));" 
  onMouseExited="this.setForeground(new java.awt.Color(255,0,0));" 
  hotKey="CTRL+ALT+W"/>