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.
Errors
All errors are thrown with complete SCOadmin error stacks. All SaSelectHost
calls should eventually be caught using ErrorCatch.