Progress
Programming
Handbook


User-interface Events

Progress supports the following types of events:

Each type of widget supports a set of user-interface events. You can define triggers only on those events supported by the widget.

Keystrokes

You can set up triggers for raw keystrokes or for key functions. Raw keystroke events include all the characters in the character set, including control sequences such as CTRL–X and key labels such as F1 and DEL–CHAR. Key functions include GO, HELP, END–ERROR, and DELETE, among others.

For more information on Progress key labels, key functions, and key codes, see Handling User Input." In the same chapter, see the the section on monitoring keystrokes during data entry for examples of triggers on specific keystrokes.

Mouse Events

Progress supports a conceptual portable mouse model (that is, SELECT, MENU, and EXTEND buttons) and a physical two-button mouse model (that is, LEFT, and RIGHT buttons). The portable model provides better portability. However, using any mouse events may cause problems when porting to a system that does not have a mouse. Consider using functional events such as CHOOSE, ENTRY, and MENU–DROP instead.

To map the portable model to a two-button mouse, a physical button may have two meanings, or a modifier key, such as CTRL, may be used with a physical button. For example, with a two-button mouse on Windows, the LEFT button maps to the SELECT and MOVE buttons, the RIGHT button maps to the MENU button, and the RIGHT button with CTRL maps to the EXTEND button.

Table 16–4 lists the portable and two-button mouse events supported by Progress.

Table 16–4: Mouse Events 
Portable Mouse Events
Two-button Mouse Events
MOUSE–SELECT–UP
LEFT–MOUSE–UP
MOUSE–SELECT–DOWN
LEFT–MOUSE–DOWN
MOUSE–SELECT–CLICK
LEFT–MOUSE–CLICK
MOUSE–SELECT–DBLCLICK
LEFT–MOUSE–DBLCLICK
MOUSE–MENU–UP
RIGHT–MOUSE–UP
MOUSE–MENU–DOWN
RIGHT–MOUSE–DOWN
MOUSE–MENU–CLICK
RIGHT–MOUSE–CLICK
MOUSE–MENU–DBLCLICK
RIGHT–MOUSE–DBLCLICK
MOUSE–MOVE–UP
N/A
MOUSE–MOVE–DOWN
N/A
MOUSE–MOVE–CLICK
N/A
MOUSE–MOVE–DBLCLICK
N/A
MOUSE–EXTEND–UP
N/A
MOUSE–EXTEND–DOWN
N/A
MOUSE–EXTEND–CLICK
N/A
MOUSE–EXTEND–DBLCLICK
N/A

Direct Manipulation Events

Progress supports events related to marking, moving, and resizing widgets on the screen. For more information on these events, see Direct Manipulation."

Other Events

In addition to normal keystrokes, mouse events, and direct manipulation events, Progress supports the additional events listed in Table 16–5.

Table 16–5: Other Progress Events 
Event
Description
CHOOSE
Occurs when the user chooses a widget, such as a button or most menu items.
ENTRY
Occurs when the user moves focus into a frame or field-level widget.
DEFAULT–ACTION
Occurs when the user executes the environment-specific action for completing a selection list.
ITERATION–CHANGED
Occurs when the user changes the current iteration of a browse widget.
LEAVE
Occurs when the user moves focus out of a frame or field-level widget.
MENU–DROP
Occurs when the user selects a pull-down menu from a menu bar.
VALUE–CHANGED
Occurs when the user changes the value of a combo box, toggle box, selection list, radio set, or toggle box menu item.
WINDOW–CLOSE
Occurs when the user closes a window.
WINDOW–MAXIMIZED
Occurs when the user maximizes a window.
WINDOW–MINIMIZED
Occurs when the user minimizes a window.
WINDOW–RESTORED
Occurs when the user restores the size of a window.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095