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 1. 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-NOTIFY#rfi1424919717506__Windows-only-fn, #rfi1424919717506__GUI-only-fn 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-SEARCH#rfi1424919717506__Windows-only-fn 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. Menu#rfi1424919717506__popup-fn, submenu Trigger dependent
OFF-END#rfi1424919717506__off-end-fn 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-HORIZONTAL#rfi1424919717506__GUI-only-fn 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.#rfi1424919717506__only-on-fn
SCROLL-NOTIFY#rfi1424919717506__GUI-only-fn 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-VERTICAL#rfi1424919717506__GUI-only-fn 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.#rfi1424919717506__only-on-fn
START-SEARCH#rfi1424919717506__Windows-only-fn 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-MAXIMIZED#rfi1424919717506__Windows-only-fn 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 Supported only if the Menu POPUP-ONLY attribute is set to TRUE and the menu is set as a popup for some other widget.
4 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.
5 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.