ExternalApplicationButton DTD and XML Definitions

The ExternalApplicationButton has many of the same attributes as the IconButton, but also contains a "command" attribute for specifying a command in the XML file. The ExternalApplicationButton has the following entry in the DTD file:
Table 1. ExternalApplicationButton definition
Line entry in the DTD file Description
<!ELEMENT ExternalApplicationButton EMPTY> An ExternalApplicationButton does not contain any sub-elements
<!ATTLIST ExternalApplicationButton
    name CDATA #IMPLIED
    command CDATA #REQUIRED
    iconName CDATA #REQUIRED
    toolTipText CDATA #REQUIRED
    width CDATA "32"
    height CDATA "22"
    x CDATA #REQUIRED
    y CDATA #REQUIRED
    enabled (true|false) #IMPLIED
    hotKey CDATA #IMPLIED
    onClick CDATA #IMPLIED
    onMouseEntered CDATA #IMPLIED
    onMouseExited CDATA #IMPLIED
    onInitialize CDATA #IMPLIED>
Attribute list
Table 2. ExternalApplicationButton 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.
command Command line contents to be provided "as is" to the system in order to launch an application or batch command (mandatory)
iconName Name of the file containing an icon to be set into 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 (mandatory)
y Vertical coordinate for the location of the button (mandatory)
enabled Whether the button is enabled when it is created
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.
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 an ExternalApplicationButton:
<ExternalApplicationButton x="4" y="2" 
   iconName="/calculator.gif" command="calc" 
   toolTipText="Launch calculator" hotKey="CTRL+Q" />