SaSetFocus(3tlib)


SaSetFocus: SaSetTabGroups, SaSetFocusList, SaSetFocus -- control focus order of SCO Visual Tcl widgets during user traversal of a form

Synopsis

SaSetTabGroups form tabgroup
SaSetFocusList form list
SaSetFocus widget cbs

Description

SaSetTabGroups- configure tab group for a form

SaSetFocusList- establish sequence of widget focus used for navigation

SaSetFocus- advance focus to specified widget

The SaSetFocus interfaces enable SCO Visual Tcl applications to configure natural and highly usable form traversal in CHARM (character Motif). Focus lists and tab groups control the movement of widget focus after <Return> and <Tab> keystrokes, respectively. In some instances, widgets within embedded subforms will not be reachable via <Tab> unless they are explictly included by the application into a tab group.


SaSetTabGroups
configures the tab group for a form. Successive <Tab> keystrokes will visit the listed widgets in the specified order. Each form may have only one tab group. A form's tab group may contain any widgets that appear on the form, including those in embedded subforms.

SaSetFocusList
establishes the sequence of widget focus used when the user navigates the form with <Return>.

SaSetFocus
advances the focus to the specified widget. The special word next refers to the next widget in the focus list. SaSetFocus is designed to be used as a widget callback. When called manually, be sure to provide an empty cbs parameter.

Arguments


form
widget string of the form containing the widgets in the focus list.

list
list of ordered widget strings.

widget
the widget to receive focus. The special word next may be used to specify the next widget in the focus list established by a previous call to SaSetFocusList.

tabgroup
list of ordered widget strings.

cbs
SCO Visual Tcl callback structure. When SaSetFocus is used as a widget callback, vTcl will automatically generate and pass the cbs.

Notices

See Developing Visual Tcl applications for issues and concepts concerning tab groups.
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004