All user-interface components use the IView interface, but different types of interface elements have different sets of properties and provide listeners for different events. This topic lists the different types of interface elements and the properties and listeners that each must support.
There is inheritance of interface component properties and listeners. For each interface element listed here, an Inherited Requirements item lists the requirements for the interface element preceding it in the inheritance hierarchy. For example, the ComboBoxes element lists PopLists’ properties and listeners as Inherited Requirements. ComboBoxes must, therefore, also include PopLists’ Inherited Requirements (which are the Common Properties and Listeners). Note that all components require the Common Properties and Listeners.
The properties listed include the name, type, and requirements for each interface
element. Each property must be handled in the getProperty()
and/or
setProperty()
methods of the IView
interface as appropriate
to the requirements of the property. The gettable requirement corresponds to
getProperty()
and the settable requirement corresponds to setProperty()
.
Examples: The BACKGROUND property (in Common Properties) is
both gettable and settable, so BACKGROUND should be handled in both the getProperty()
and setProperty()
methods. The UI_PARENT property (in Common Properties)
is only gettable, so UI_PARENT should be handled in the getProperty()
method only.
Unless otherwise specified, listeners are part of Javasoft's abstract windowing toolkit (AWT). Documentation is available from Javasoft. The names use standard Java terminology.
The same class is used to represent text buttons and iconic buttons.
Properties |
Type |
Requirements |
---|---|---|
BACKGROUND |
Color |
Gettable, Settable |
BGPATTERN |
Image |
Gettable, Settable |
BOUNDS |
Rectangle |
Gettable, Settable |
ENABLED |
Boolean |
Gettable, Settable |
FOCUS |
Boolean |
Gettable, Settable |
FONT |
Font |
Gettable, Settable |
FOREGROUND |
Color |
Gettable, Settable |
LANGUAGE_DIRECTION |
LanguageDirection (static instances are LEFT_TO_RIGHT, RIGHT_TO_LEFT, or DEFAULT) |
Gettable, Settable |
LOCATION |
Point |
Gettable, Settable |
MNEMONIC |
Character |
Gettable, Settable |
SIZE |
Point |
Gettable, Settable |
UI_PARENT |
Container |
Gettable |
VISIBLE |
Boolean |
Gettable, Settable |
|
|
|
Listeners |
|
|
FocusListener |
|
|
KeyListener |
|
|
MouseListener |
|
|
MouseMotionListener |
|
|
|
|
|
Inherited Requirements |
|
|
None |
|
Properties |
Type |
Requirements |
BORDER_BEVEL |
BorderBevel (static instances are PLAIN, RAISED, LOWERED, or NONE) |
Gettable, Settable |
|
| |
Listener |
|
|
CustomListener |
|
|
|
|
|
Properties |
Type |
Requirements |
---|---|---|
IMAGE |
Image |
Gettable, Settable |
IS_DEFAULT |
Boolean |
Gettable, Settable |
LABEL |
String |
|
|
|
|
Listeners |
|
|
ActionListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
LABEL |
String |
Gettable, Settable |
VALUE |
Boolean |
Gettable, Settable |
|
|
|
Listeners |
|
|
ItemListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
CASE_FOLD |
CaseRestriction |
Gettable, Settable |
MAX_LENGTH |
Integer |
Gettable, Settable |
SELECT |
Integer |
Settable |
USERTEXT |
String |
Gettable |
|
|
|
Listeners |
|
|
SelectionListener |
|
|
TextListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all PopList properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
BORDER_BEVEL |
BorderBevel (static instances are PLAIN, RAISED, LOWERED, or NONE) |
Gettable, Settable |
CANVAS_ORIGIN |
Point |
Gettable, Settable |
SCALE |
Integer |
Gettable, Settable |
SCROLL_POSITION |
Point |
Gettable |
SCROLL_STYLE |
ImageScrollPolicy (static instances are HORIZONTAL, VERTICAL, BOTH, or NONE) |
Gettable, Settable |
VALUE |
Image |
Gettable, Settable |
VIEWPORT_SIZE |
Dimension |
Gettable |
|
|
|
Listeners |
|
|
(no new listeners) |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
COUNT |
Integer |
Gettable |
SELECT |
Integer |
Settable |
SELECTEDINDEX |
Integer |
Gettable |
|
|
|
Listeners |
|
|
DropDownListener |
|
|
ItemListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
GROUPLEADER |
Boolean |
Gettable, Settable |
LABEL |
String |
Gettable, Settable |
LOCALSTATE |
Boolean |
Gettable |
RADIOGROUP |
Iview |
Gettable |
VALUE |
Boolean |
Gettable, Settable |
|
|
|
Listeners |
|
|
ItemListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
ALIGNMENT |
Alignment (static instances are START, RIGHT, LEFT, CENTER, or END) |
Gettable, Settable |
BORDER_BEVEL |
BorderBevel (static instances are PLAIN, RAISED, LOWERED, or NONE) |
Gettable, Settable |
CAN_TAKE_FOCUS |
Boolean |
Gettable, Settable |
CASE_FOLD |
CaseRestriction (static instances are UPPERCASE, LOWERCASE, or NONE) |
Gettable, Settable |
CURSOR_POSITION |
Integer |
Gettable, Settable |
EDITABLE |
Boolean |
Gettable, Settable |
MAX_LENGTH |
Integer |
Gettable, Settable |
SELECTION |
Point |
Gettable, Settable |
VALUE |
String |
Gettable, Settable |
|
|
|
Listeners |
|
|
TextListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
VSBARPOLICY |
Boolean |
Gettable, Settable |
WRAP_STYLE |
WrapStyle (static instances are CHARACTER, WORD, or NONE) |
Gettable, Settable |
|
|
|
Listeners |
|
|
(no new listeners) |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Text Component properties and listeners |
|
Properties |
Type |
Requirements |
---|---|---|
SECURE |
Boolean |
Gettable, Settable |
|
|
|
Listeners |
|
|
(no new listeners) |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Text Component properties and listeners |
Properties |
Type |
Requirements |
---|---|---|
COUNT |
Integer |
Gettable |
DESELECT |
Integer |
Settable |
MAKEVISIBLE |
Integer |
Settable |
SELECT |
Integer |
Settable |
SELECTEDINDEX |
Integer |
Gettable |
|
|
|
Listeners |
|
|
ActionListener |
|
|
ItemListener |
|
|
|
|
|
Inherited Requirements |
|
|
Include all Common properties and listeners |
|