MOVE-BEFORE-TAB-ITEM( ) method

Assigns the method widget to the tab position before a specified widget. Both the method widget and the specified widget must be in the same field group.

Return type: LOGICAL

Applies to: BROWSE widget, BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, EDITOR widget, FILL-IN widget, FRAME widget, RADIO-SET widget, SELECTION-LIST widget, SLIDER widget, TOGGLE-BOX widget

Syntax

MOVE-BEFORE[-TAB-ITEM] ( handle )

handle: A handle to the widget before whose tab position you want to move the method widget.

If the operation is successful, the method returns TRUE. To set the first or last tab position, set the FIRST-TAB-ITEM or LAST-TAB-ITEM attribute (respectively) for the field group.

If handle specifies a frame, the tab order of the method widget is positioned so that it precedes the first widget parented by the frame in that frames own tab order. For more information on how frames owned by a field group participate in the tab order of that field group, see the FRAME widget reference entry.

Note: Any tab reordering that you do with this method can be reset by a subsequent ENABLE statement unless you define the frame that owns the field group with the KEEP-TAB-ORDER option. For more information, see the ENABLE statement and Frame phrase reference entries.