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.

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`¹, ²	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`¹	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³, submenu	Trigger dependent
`OFF-END`⁴	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`²	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.⁵
`SCROLL-NOTIFY`²	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`²	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.⁵
`START-SEARCH`¹	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`¹	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.