A script-enabled browser is required for this page to function properly.

Properties and Listeners Needed for User Interface Component Classes

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.

Common properties and listeners

Required properties and listeners for all interface elements:

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

 

Bean area properties and listeners

Required properties and listeners:

Properties

Type

Requirements

BORDER_BEVEL

BorderBevel (static instances are PLAIN, RAISED, LOWERED, or NONE)

Gettable, Settable

 

 

Listener

 

 

CustomListener

 

 

 

 

 

Inherited Requirements
Include all Common properties and listeners 

Buttons

Required properties and listeners:

Properties

Type

Requirements

IMAGE

Image

Gettable, Settable

IS_DEFAULT

Boolean

Gettable, Settable

LABEL

String

 

 

 

 

Listeners

 

 

ActionListener

 

 

 

 

 

Inherited Requirements

 

Include all Common properties and listeners

 

Inherited Requirements
Include all Common properties and listeners

Checkboxes

Required properties and listeners:

Properties

Type

Requirements

LABEL

String

Gettable, Settable

VALUE

Boolean

Gettable, Settable

 

 

 

Listeners

 

 

ItemListener

 

 

 

 

 

Inherited Requirements

 

Include all Common properties and listeners

 

ComboBoxes

Required 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 

 

Images

Required 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

 

PopLists

Required 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

 

RadioButtons

Required 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

 

Multi-Line and regular TEdits (Text Component) properties and listeners

Required 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

 

Multi-Line TEdits (TextArea) properties and listeners

Required 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

 

Non-Multi-Line TEdits (TextField)

Required properties and listeners:

Properties

Type

Requirements

SECURE

Boolean

Gettable, Settable

 

 

 

Listeners

 

 

(no new listeners)

 

 

 

 

 

Inherited Requirements

 

Include all Text Component properties and listeners

TLists

Required 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