Writing a SCOadmin manager

Autonavigation

When the user has finished entering data in one widget, the focus can be automatically moved to the next widget. This is called ``autonavigation''. The triggering of the callback for a widget is an indication to the application that the user has finished with that widget. In each widget callback, focus should be moved to the next widget. There are a set of standard SCOadmin procedures to implement this:

SaSetFocusList(3tlib) defines the order the widgets should be traversed.
SaSetFocus(3tlib) moves focus to the next widget in the focus list (or a specific widget).

When you create the form, use SaSetFocusList to define the order of widgets and add SaSetFocus next to the end of each widget callback. If a widget has no specific callback defined, use SaSetFocus next directly. When the last widget is reached, focus should move to the OK button. To add the OK button to the focus list use:

   [VtGetValues $form -ok]

to determine the widget name. In addition, focus should be set to the first widget. For example:

   set focusList [list $widget1 $widget2 $widget3 $widget4]
   SaSetTabGroups $form $focusList
   lappend focusList [VtGetValues $form -ok]
   SaSetFocusList $form $focusList
   VtShowForm
   VtSetFocus [lindex $focusList 0]