SCO Visual Tcl Programmer's Guide and Reference

About this book
        How this book is organized
        Related documentation
        How can we improve this book?

Introducing SCO Visual Tcl
        Basic components of SCO Visual Tcl
        How SCO Visual Tcl works
        Widgets
                The Application widget and widget tree
                        Parents and children
                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

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)
                        About the widget tree
                        Specifying the command to execute
                Creating the main form (VtFormDialog)
                        Widget naming guidelines
                        Returning handle references
                        The empty form
        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

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)

Using callbacks and procedures
        Callback data structure (cbs) and keyed lists
        Other defined callbacks
                defaultCallback
                dialogCallback
                errorCallback
                helpKeyCallback
                itemSelectCallback
                losingFocusCallback
                shortHelpCallback
                valueChangedCallback

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

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

Command options alphabetical list

SCO Visual Tcl interpreter errors
        Examples of error generation
                        Example 1 -- entering a command-line argument
                        Example 2 -- pressing err1
                        Example 3 -- pressing err2
                        Example 4 -- pressing noCallBack
        Tcl widget creation errors
        Tcl communication errors
        Tcl miscellaneous errors
        Tcl list addition, deletion, selection, and deselection errors

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

(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

(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

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

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