SCO Visual Tcl Programmer's Guide and Reference
Table of Contents
SCO Visual Tcl Programmer's Guide and Reference
SCO Visual Tcl Programmer's Guide and Reference
Table of Contents
About this book
How this book is organized
Related documentation
Typographical conventions
How can we improve this book?
Chapter 1: Introducing SCO Visual Tcl
Basic components of SCO Visual Tcl
How SCO Visual Tcl works
Widgets
The Application widget and widget tree
Widget naming
Widget layout
Dialog widgets
Widget focus
Additional widget support
Events and callbacks
Commands
Command and option structure and validation
Developing for the character environment
Some useful features of SCO Visual Tcl
Other SCO Visual Tcl Resources
Chapter 2: Creating an SCO Visual Tcl program -- an overview
The kill program example
Defining the callbacks
Coding the supporting routines
Outline of kill program procedures
Coding the Main routine
Establishing a connection to the server (VtOpen)
Creating the main form (VtFormDialog)
Defining the menu tree
Creating the menu bar (VtMenuBar)
Creating menu buttons (VtPushButton)
Creating the process list (VtList, VxSetVar)
Attaching variables to a form (VxSetVar)
Retrieving attached variables (VxGetVar)
VxSetVar example
Reviewing the Main routine
Getting the process ID (MenuKillCB)
About keyed lists and the callback structure (cbs)
Getting the process ID (PID)
About question dialogs
Creating the question dialog (VtQuestionDialog)
Specifying an action when user clicks OK (KillFormOkCB)
Updating process list in response to user (MenuRefreshCB)
Exiting the program (MenuExitCB)
Updating the process list (DoRefresh)
Displaying the process list (GetPsList)
Completed kill program
Chapter 3: The SCO Visual Tcl environment
vtcl environment variables
*_vtcld environment variables
Character mode environment variables
Character server command flags (cm_vtcld)
Interpreter command flags (vtcl)
Chapter 4: Using callbacks and procedures
Callback data structure (cbs) and keyed lists
Other defined callbacks
defaultCallback
dialogCallback
errorCallback
helpKeyCallback
itemSelectCallback
losingFocusCallback
shortHelpCallback
valueChangedCallback
Chapter 5: Adding online help
About short help
Creating short help
About context-sensitive help
Creating context-sensitive help
Dumping the widget sums
Template widget sums for main window: appGUI (partial list)
Creating a help book
Creating the hook file
Adding a help book to the system
Testing your help book
Displaying manual pages with VtDisplayHelp
Appendix A: Command options by class
Geometry class options
Object class options
Button class options
Dialog class options
Form class options
Label class options
List class options
RowColumn class options
Appendix B: Command options alphabetical list
Appendix C: SCO Visual Tcl interpreter errors
Examples of error generation
Tcl widget creation errors
Tcl communication errors
Tcl miscellaneous errors
Tcl list addition, deletion, selection, and deselection errors
Appendix D: User interface style conventions
Industry guidelines
What makes a good user interface?
GUI design methodology
GUI design elements
Action message
Cascade menu
Checkbox
Close
Default action
Default button
Default value
Dialog box
Error dialog
Feedback
Highlighting
Information message
Labels
List box
Menu bar
Message
Push button
Progress indicator
Radio button
Refresh
Shortcut Keys
Tool bar
View
Warning message
CHARM interface guidelines
Navigation
Selection
Window components
Appendix E: (TCL) commands by type
Environment commands
Flow of control commands
Information commands
File input and output commands
List handling commands
Regular expression commands
TCL interpreter
Variable and array commands
Basic commands
Debugging and development commands
UNIX System access commands
TCP/IP server access
File scanning commands
Math commands
Keyed lists
String and character manipulation commands
XPG/3 message catalog commands
Help commands
Loadable libraries and packages
Package library management commands
Appendix F: (VTCL) commands by type
Connection oriented commands
Widget creation commands
Dialogs
Generic layout widgets
Specialized layout widgets
Menu creation widgets
Compound widgets
Simple widgets
Widget manipulation commands
List manipulation commands
Other commands
Interpreter-only commands
Appendix G: (TCL) commands
alarm(TCL)
append(TCL)
apropos(TCL)
array(TCL)
auto_commands(TCL)
auto_load(TCL)
auto_load_file(TCL)
auto_packages(TCL)
break(TCL)
bsearch(TCL)
buildpackageindex(TCL)
case(TCL)
catch(TCL)
catclose(TCL)
catgets(TCL)
catopen(TCL)
cd(TCL)
cequal(TCL)
cexpand(TCL)
chgrp(TCL)
chmod(TCL)
chown(TCL)
chroot(TCL)
cindex(TCL)
clength(TCL)
close(TCL)
cmdtrace(TCL)
commandloop(TCL)
concat(TCL)
continue(TCL)
convert_lib(TCL)
convertclock(TCL)
copyfile(TCL)
crange(TCL)
csubstr(TCL)
ctoken(TCL)
ctype(TCL)
dirs(TCL)
dup(TCL)
echo(TCL)
edprocs(TCL)
eof(TCL)
error(TCL)
eval(TCL)
exec(TCL)
execl(TCL)
exit(TCL)
expr(TCL)
fcntl(TCL)
file(TCL)
flock(TCL)
flush(TCL)
fmtclock(TCL)
for(TCL)
for_array_keys(TCL)
for_file(TCL)
for_recursive_glob(TCL)
foreach(TCL)
fork(TCL)
format(TCL)
frename(TCL)
fstat(TCL)
getclock(TCL)
gets(TCL)
glob(TCL)
global(TCL)
help(TCL)
helpcd(TCL)
helppwd(TCL)
history(TCL)
id(TCL)
if(TCL)
incr(TCL)
info(TCL)
infox(TCL)
intersect(TCL)
intersect3(TCL)
join(TCL)
keyldel(TCL)
keylget(TCL)
keylkeys(TCL)
keylset(TCL)
kill(TCL)
lappend(TCL)
lassign(TCL)
lempty(TCL)
lgets(TCL)
library(TCL)
lindex(TCL)
link(TCL)
linsert(TCL)
list(TCL)
llength(TCL)
lmatch(TCL)
loadlibindex(TCL)
loop(TCL)
lrange(TCL)
lreplace(TCL)
lrmdups(TCL)
lsearch(TCL)
lsort(TCL)
lvarcat(TCL)
lvarpop(TCL)
lvarpush(TCL)
max(TCL)
min(TCL)
mkdir(TCL)
nice(TCL)
open(TCL)
pid(TCL)
pipe(TCL)
popd(TCL)
proc(TCL)
profile(TCL)
profrep(TCL)
pushd(TCL)
puts(TCL)
pwd(TCL)
random(TCL)
read(TCL)
read_file(TCL)
readdir(TCL)
recursive_glob(TCL)
regexp(TCL)
regsub(TCL)
rename(TCL)
replicate(TCL)
return(TCL)
rmdir(TCL)
saveprocs(TCL)
scan(TCL)
scancontext(TCL)
scanfile(TCL)
scanmatch(TCL)
searchpath(TCL)
seek(TCL)
select(TCL)
server_info(TCL)
server_open(TCL)
set(TCL)
showproc(TCL)
signal(TCL)
sleep(TCL)
source(TCL)
split(TCL)
string(TCL)
switch(TCL)
sync(TCL)
system(TCL)
tclsh(TCL)
tclvars(TCL)
tell(TCL)
time(TCL)
times(TCL)
trace(TCL)
translit(TCL)
umask(TCL)
union(TCL)
unknown(TCL)
unlink(TCL)
unset(TCL)
uplevel(TCL)
upvar(TCL)
wait(TCL)
while(TCL)
write_file(TCL)
Appendix H: (VTCL) commands
VtAddInput(VTCL)
VtAddTabGroup(VTCL)
VtAddTimeOut(VTCL)
VtAddWorkProc(VTCL)
VtBeep(VTCL)
VtCheckBox(VTCL)
VtClose(VTCL)
VtComboBox(VTCL)
VtControl(VTCL)
VtDestroy(VTCL)
VtDisplayHelp(VTCL)
VtDrawnList(VTCL)
VtDrawnListAddItem(VTCL)
VtDrawnListDeleteItem(VTCL)
VtDrawnListDeselectItem(VTCL)
VtDrawnListGetItem(VTCL)
VtDrawnListGetSelectedItem(VTCL)
VtDrawnListSelectItem(VTCL)
VtDrawnListSetItem(VTCL)
VtDrawnListSetItemValues(VTCL)
VtErrorDialog(VTCL)
VtFileSelectionDialog(VTCL)
VtForm(VTCL)
VtFormDialog(VTCL)
VtFrame(VTCL)
VtGet(VTCL)
VtHide(VTCL)
VtInfo(VTCL)
VtInformationDialog(VTCL)
VtLabel(VTCL)
VtList(VTCL)
VtListAddItem(VTCL)
VtListDeleteItem(VTCL)
VtListDeselectItem(VTCL)
VtListGetItem(VTCL)
VtListGetSelectedItem(VTCL)
VtListSelectItem(VTCL)
VtListSetItem(VTCL)
VtLock(VTCL)
VtMainLoop(VTCL)
VtMenuBar(VTCL)
VtMessageDialog(VTCL)
VtOpen(VTCL)
VtOptionMenu(VTCL)
VtPulldown(VTCL)
VtPushButton(VTCL)
VtQuestionDialog(VTCL)
VtQuitServer(VTCL)
VtRadioBox(VTCL)
VtRaise(VTCL)
VtRemoveAllTabGroups(VTCL)
VtRemoveInput(VTCL)
VtRemoveTabGroup(VTCL)
VtRemoveTimeOut(VTCL)
VtRemoveWorkProc(VTCL)
VtRowColumn(VTCL)
VtScale(VTCL)
VtSelectionDialog(VTCL)
VtSeparator(VTCL)
VtSet(VTCL)
VtSetAppValues(VTCL)
VtShow(VTCL)
VtText(VTCL)
VtToggleButton(VTCL)
VtUnLock(VTCL)
VtWarningDialog(VTCL)
VtWorkingDialog(VTCL)
VxAlignBaseLines(VTCL)
VxAlignedForm(VTCL)
VxCenterVertically(VTCL)
VxCheckBox(VTCL)
VxComboBox(VTCL)
VxEndFormCB(VTCL)
VxGetShortName(VTCL)
VxGetVar(VTCL)
VxList(VTCL)
VxMenu(VTCL)
VxMenuGetButton(VTCL)
VxOptionMenu(VTCL)
VxOptionMenuGetSelected(VTCL)
VxOptionMenuReplaceOptions(VTCL)
VxOptionMenuSetSelected(VTCL)
VxRadioBox(VTCL)
VxRowColumn(VTCL)
VxSetLeftOffsets(VTCL)
VxSetVar(VTCL)
VxSpinButton(VTCL)
VxSpinButtonSetMaxValue(VTCL)
VxSpinButtonSetMinValue(VTCL)
VxText(VTCL)
VxWidgetVarRef(VTCL)