Progress
Language Reference
High-level Widget Events
Table 71 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 Progress Action column, triggers on these events execute before Progress applies the event. If the trigger returns NO-APPLY, Progress 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 71: High-level Widget Events
Event
User Action Affected Widgets Progress 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-SEARCH Occurs when an updateable browse ends a user-initiated search by either finding a record or when a user selects a row marker or clicks 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. 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,1 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 (on 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-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. 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 on 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.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |