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:

"Required keys/values:"

parent
SCO Visual Tcl widget string of parent form

instance
unique name for this instance of a Select Host widget

labeltext
text string that labels the text widget.

buttonText
text string for the "Select" button that launches the host name browser form.
"Optional keys/values:"

labeltype
"label" or "title" indicating the placement of the descriptive string relative to the text widget. Default is "title" versus "label" which appears to the left of the text widget.

userproc
application callback invoked after user selection is complete. userproc must accept a cbs and may be specified with additional arguments.

textcols
width of the text widget. Defaults to 30.

title
title for the select host dialog window. Defaults to ``Select Host''.

show
specifies the format of the host list. Values are:

ipaddr:
IP address

name:
host name (usually fully qualified domain)

both:
both IP and host name (defaults to ``name'')

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).