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