Try OpenEdge Now
skip to main content
ABL Reference
Handle-based Object Events Reference : High-level widget events
 

High-level widget events

The following table lists high-level widget events. These are events generated by mouse or keyboard actions that perform high-level operations on a widget, such as entering a fill-in, choosing a button, or displaying a menu. Unless noted in the AVM Action column, triggers on these events execute before the AVM applies the event. If the trigger returns NO-APPLY, the AVM does not apply the event. If the trigger executes after the event takes place, NO-APPLY has no effect.
Note: If a CHOOSE, DEFAULT-ACTION, or VALUE-CHANGED event executes a trigger as a result of a mouse click that changes input focus, NO-APPLY will return focus to the widget that had focus prior to the event.
Table 123. High-level widget events
Event
User action
Affected widgets
AVM action
CHOOSE
A keyboard or mouse action that chooses a widget.
Button, non-toggle-box menu item
Trigger executes after choose takes place
DEFAULT-ACTION
A native keyboard or mouse event that confirms the selection of a value in a selection list or browse. In Windows applications, double-click a list item. In character applications, press RETURN or DELETE-LINE.
Selection list, Browse
Trigger dependent
DROP-FILE-NOTIFY1, 2
A mouse action that completes a drag-and-drop operation on a widget.
Browse, Button, Combo-box, Dialog-box, Editor, Fill-in, Frame, Radio-set, Selection-list, Slider, Toggle, Window
Trigger executes after drag-and-drop operation concludes
Note: The trigger should call the END-FILE-DROP() method when it has finished processing all the files.
END
Occurs when the user repositions the browse to the end of the query's result set by pressing the END key.
Browse
Trigger dependent
END-SEARCH3
Occurs when an updateable browse ends a user-initiated search when a user either selects a row marker or clicks in a cell.
Browse
Trigger dependent
ENTRY
A keyboard or mouse action that gives focus to the widget.
Browse, browse cell, button, combo box, control container, dialog box, editor, fill-in, frame, radio set, selection list, slider, toggle box, window
Trigger dependent
Note: For a browse widget, ON ENTRY OF browse-name specifies a trigger for the browse widget and ON ENTRY OF column-name IN BROWSE browse-name specifies a trigger for a browse cell. The browse cell is the intersection of the named column and the currently focused row.
HOME
Occurs when the user repositions the browse to the beginning of the query's result set by pressing the HOME key.
Browse
Trigger dependent
ITERATION-CHANGED
A keyboard or mouse action that changes the current iteration of a browse. This event is obsolete; see the VALUE-CHANGED Event reference entry.
Browse
Trigger dependent
LEAVE
A keyboard or mouse action that takes focus from the widget.
Browse, browse cell, button, combo box, control container, dialog box, editor, fill-in, frame, radio set, selection list, slider, toggle box, window
Trigger dependent
Note: For a browse widget, ON LEAVE OF browse-name specifies a trigger for the browse widget and ON LEAVE OF column-name IN BROWSE browse-name specifies a trigger for a browse cell. The browse cell is the intersection of the named column and the currently focused row.
MENU-DROP
A keyboard or mouse action that displays a menu.
Menu4, submenu
Trigger dependent
OFF-END5
A keyboard or mouse action that tries to move after the last row of a browse.
Browse
Trigger dependent
OFF-HOME
A keyboard or mouse action that tries to move before the first row of a browse.
Browse
Trigger dependent
PARENT-WINDOW-CLOSE
An event that each descendant window receives when the common ancestor window in that family receives a WINDOW-CLOSE event.
Window
Trigger dependent
ROW-DISPLAY
Any browse action that results in a row being displayed in the browse.
Browse
Trigger dependent
Note: The use of triggers for this event is restricted to special cases. When a row is displayed, use a trigger to modify attributes of individual cells in the column. It should be restricted to the following uses: changing cell colors, changing the cell font, referencing the cell in an expression, and (in Windows) changing the cell format.
ROW-ENTRY
A keyboard or mouse action that gives an updateable cell focus in a browse row.
Browse
Trigger dependent
ROW-LEAVE
A keyboard or mouse action that takes focus from the browse row where an updateable cell has focus.
Browse
Trigger dependent
SCROLL-HORIZONTAL6
A keyboard or mouse action that causes a horizontal scroll in a browse.
Browse
Trigger dependent
Note: This event fires when a mouse or keyboard action scrolls a browse horizontally.7
SCROLL-NOTIFY8
A mouse action in the scrollbar area of a browse.
Browse
Trigger dependent
Note: This event allows the developer to track physical movement of the focused row in the browse viewport.
This event is supported only for backward compatibility. Use SCROLL-HORIZONTAL and SCROLL-VERTICAL instead.
SCROLL-VERTICAL9
A keyboard or mouse action that causes a vertical scroll in a browse.
Browse
Trigger dependent
Note: This event fires when a mouse or keyboard action scrolls a browse vertically.10
START-SEARCH11
A keyboard or mouse action that places an updateable browse into search mode.
Browse
Trigger dependent
VALUE-CHANGED
A keyboard or mouse action that changes the value of a widget. For the browse, any action that selects a row.
Browse, combo-box, editor (Windows GUI only), fill-in, radio set, selection list, slider, toggle box, toggle box menu item
Trigger executes after value changes
WINDOW-CLOSE
A keyboard or mouse action that causes the native window manager to close the affected window or dialog box.
Dialog box, window
Trigger dependent
WINDOW-MAXIMIZED12
A keyboard or mouse action that causes the native window system to resize the window to its maximum size.
Window
Trigger executes after event takes place. However since the native system has control, a NO-APPLY does not stop the event from occurring.
Note: This event occurs only in Windows.
WINDOW-MINIMIZED
A keyboard or mouse action that causes the native window system to minimize (iconify) a window and hide all of its descendant windows.
Window
Trigger executes after event takes place. However, since the native system has control, a NO-APPLY does not stop the event from occurring.
WINDOW-RESIZED
A keyboard or mouse action that causes the native window system to resize the window to any extent vertically or horizontally.
Window
Trigger executes after event takes place. However, since the native system has control, a NO-APPLY does not stop the event from occurring.
WINDOW-RESTORED
A keyboard or mouse action that causes the native window system to restore a window and any descendant windows to the state they were in before a prior maximize or minimize event.
Window
Trigger executes after event takes place. However since the native system has control, a NO-APPLY does not stop the event from occurring.

1 Windows only.

2 Graphical interfaces only.

3 Windows only.

4 Supported only if the Menu POPUP-ONLY attribute is set to TRUE and the menu is set as a popup for some other widget.

5 The OFF-END event can also occur when there are more rows to retrieve in the query on a ProDataSet temp-table buffer. For more information, see the ProDataSet events.

6 Graphical interfaces only.

7 Only one SCROLL-VERTICAL or SCROLL-HORIZONTAL event will be generated each time the user scrolls the browse using the scroll bar, regardless of how many rows or columns the user scrolls through. However, each click of the mouse wheel counts as an independent scrolling event, so multiple events will be generated if the user rotates the wheel through multiple clicks. When scrolling is caused by keyboard actions, a SCROLL-VERTICAL or SCROLL-HORIZONTAL event will be generated after each key press, as long as the key press actually causes the browse to scroll. Holding a key down is equivalent to multiple key presses and will generate multiple events.

8 Graphical interfaces only.

9 Graphical interfaces only.

10 Only one SCROLL-VERTICAL or SCROLL-HORIZONTAL event will be generated each time the user scrolls the browse using the scroll bar, regardless of how many rows or columns the user scrolls through. However, each click of the mouse wheel counts as an independent scrolling event, so multiple events will be generated if the user rotates the wheel through multiple clicks. When scrolling is caused by keyboard actions, a SCROLL-VERTICAL or SCROLL-HORIZONTAL event will be generated after each key press, as long as the key press actually causes the browse to scroll. Holding a key down is equivalent to multiple key presses and will generate multiple events.

11 Windows only.

12 Windows only.