IBM WebSphere Multichannel Bank Transformation Toolkit, Version 7.1

MessageArea DTD and XML definitions

The MessageArea extends javax.swing.JComboBox. It has the following entry in the DTD file:
Table 1. MessageArea definition
Line entry in the DTD file Description
<!ELEMENT MessageArea EMPTY> A MessageArea does not contain any sub-elements
<!ATTLIST MessageArea
    name CDATA #IMPLIED
    width CDATA "32"
    height CDATA "22"
    x CDATA #REQUIRED
    y CDATA #REQUIRED
    focusTraversable (true|false) #IMPLIED
    hotKey CDATA #IMPLIED
    onInitialize CDATA #IMPLIED
    text CDATA #IMPLIED
    intNumberOfTasks CDATA #IMPLIED
    showMessageArea (true|false) #IMPLIED
    informationLevel CDATA #IMPLIED>
Attribute list
Table 2. MessageArea 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. The Desktop provides methods to access components by name and show messages. For example,
getComponentByName(aName).showMessage("my Message"); 
There is a reserved name, "MessageText", for the text field to be used to show messages on the Desktop. For example,
Desktop.getDesktop().showMessage("my Message"); 
will display the message in the text field called MessageText.
width Width of the text field
height Height of the text field
x Horizontal coordinate for the location of the text field (mandatory)
y Vertical coordinate for the location of the text field (mandatory)
focus Traversable Whether the text field will be able to get focus
hotKey Combination of keys used as a hot key for the text field. Pressing this combination of keys when the text field is visible on the Desktop is equivalent to clicking on the text field (which causes it to get focus).
onInitialize Java code to be executed when the component is initialized
text String to be inserted in the text field
intNumberOfTasks Maximum number of messages to be shown in the MessageArea
showMessageArea Whether a PopupMessage will be shown with the data of the "text" attribute
informationLevel Level of the message shown in the pop-up message area. The following are the different levels:
  • ERROR_MESSAGE: when the value is 0
  • INFORMATION_MESSAGE: when the value is 1
  • WARNING_MESSAGE: when the value is 2
  • QUESTION_MESSAGE: when the value is 3
Note: If the value chosen is 0, the messages of all higher levels will be shown.
The following is an example of an XML definition for a MessageArea:
<MessageArea height="19"
    hotKey="CTRL+SHIFT+B"
    informationLevel="3"
    name="MessageText"
    showMessageArea="false"
    width="200" x="250" y="5"/>


Feedback