SaSetFocus(TCL_ADM)

Syntax

Description

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.

Notes