Events

In this section:

WebFOCUS Maintain includes the following events:

Blur

Occurs when an end user leaves a control that was in focus. The following controls can use this event: button, check box, combo box, edit box, image, list box, multi-edit box, radio button.

Note: If a control has focus and an end user clicks anywhere else (even on a button) the Blur event on the first control is executed first, before the Click event on the next control.

Check

Occurs when an end user selects a check box.

Change

Occurs when an end user changes a value. The following controls can use this event: combo box, edit box, image, list box, multi-edit box, radio button.

Click

Occurs when an end user clicks a form or control. The following controls can use this event: button, edit box, form, group box, HTML Object, HTML Table, image, line, multi-edit box, text list box, and combo box.

ClickArea

Occurs when an end user clicks an image with an image map, where Area is the name of the area in the image map. You will see a ClickArea event for each area in your image map.

For example, if your image control uses a map with two areas, named Fish and Boat, you will see the events ClickFish and ClickBoat for your image.

ClickLink

Occurs when an end user clicks an HTML Table. This is a special event that enables you to use syntax to determine which row, column, or cell the end user clicked.

ClickMenuItem

Occurs when an end user clicks on an item in a menu, where MenuItem is the name of the menu item. You will see a ClickMenuItem event for each item in your menu.

For example, if your menu has the items Open and Exit, you will see the events ClickOpen and ClickExit for your image.

Close

Occurs when a form is closed.

DoubleClick

Occurs when an end user double-clicks a form or control. The following controls can use this event: button, edit box, form, group box, HTML Object, HTML Table, image, line, list box, multi-edit box, and text.

Focus

Occurs when control gets focus, for example, when an end user selects or tabs to a control. The following controls can use this event: button, check box, combo box, edit box, image, list box, multi-edit box, and radio button.

KeyPress

Occurs when an end user presses a key while an edit box, form, or multi-edit box is in focus.

MouseDown

Occurs when an end user places the mouse pointer on a control or form and presses the mouse button. All controls can use this event.

MouseMove

Occurs when an end user moves the mouse while in a control. All controls can use this event.

Note: The event handler for this event can only be a JavaScript or VBScript.

MouseOut

Occurs when an end user moves the mouse pointer off a control. All controls can use this event.

MouseOver

Occurs when an end user moves the mouse pointer onto a control. All controls can use this event.

MouseUp

Occurs when an end user releases the mouse button. All controls can use this event.

OnCanViewMove, OnCBDClicked, OnCBLClicked, OnCBRClicked, OnCellChange, OnCellChanged, OnCharDown, OnColChange, OnColSized, OnEditFinish, OnEditStart, OnHitBottom, OnKeyDown, OnLClicked, OnRClicked, OnRowChange, OnRowSized, OnRowSizing, OnSHDClicked, OnSHLClicked, OnSHRClicked, OnTHDClicked, OnTHLClicked, OnTHRClicked

These events occur only in the Grid control. For more information, see Events Available in a Read/Write Grid.

Open

Occurs when a form is opened or shown.

Note: You can only use a Maintain function as an event handler for this event. You cannot use JavaScript functions, VBScript functions, or web links (due to unpredictable behavior). To execute a JavaScript or VBScript function or display a web link when a form opens, use an HTML Object.

UnCheck

Occurs when an end user deselects a check box.


Top of page

x
Common Combinations of Events and Controls

The following are some common combinations of events and controls. Your application will probably include many of these, but it is not limited to them.


WebFOCUS