SaSelectHost(3tlib)


SaSelectHost: SaSelectHostText, SaSelectHostDialog, SaSelectHostGetText, SaSelectHostGetSelection, SaSelectHostGetTextWidget, SaSelectHostGetButtonWidget -- SCO Visual Tcl interface for graphical host browsing and selection

Synopsis

SaSelectHostText parameters
SaSelectHostDialog parameters cbs

SaSelectHostGetText instance
SaSelectHostGetSelection instance
SaSelectHostGetTextWidget instance
SaSelectHostGetButtonWidget instance

Description

SaSelectHost is a flexible interface for application dialogs that include host names in the networked environment.

SaSelectHostText
returns a form containing a text widget, label and push button. The user may enter text directly or use the push button to launch a secondary form dialog for graphically browsing a list of valid host names. The secondary form includes options for sorting and filtering.

SaSelectHostDialog
directly launches the form dialog for graphically browsing a list of valid host names. Designed as a callback for selection widgets like menu options and push buttons.

SaSelectHostGetText

SaSelectHostGetSelection

SaSelectHostGetTextWidget

SaSelectHostGetButtonWidget
obtain the user's selection for use by the application. The application can also obtain the widget string for both the text and button widgets for instances created with SaSelectHostText. This can be useful for further customizations to these widgets.

Arguments


parameters
a Tcl keyed list of required and optional parameters:

instance
specifies which Select Host widget to use. Matches the ``instance'' value used in the parameter list during creation.

cbs
SCO Visual Tcl callback structure. Indicates that SaSelectHostDialog is designed to be used as the callback for an activate widget such as a pulldown menu option, pushbutton or toolbar button.

Diagnostics

All errors are thrown with complete SCOadmin error stacks. All SaSelectHost calls should eventually be caught using ErrorCatch.

References

SaHost(3tlib), SaOpenHost(3tlib).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004