NAME

       TixIntro - Introduction to the Tix library

DESCRIPTION

       Tix,  which  stands  for  Tk  Interface  Extension, is an extension library for Tcl/Tk. Tix adds many new
       widgets, image  types  and  other  commands  that  allows  you  to  create  compelling  Tcl/Tk-based  GUI
       applications.

       One  advantage  of Tix over other Tk widget libraries is many of the Tix standard widgets are implemented
       in native code. This enhances performance and provides native look-and-feel for your applications.

       This version of Tix works with Tcl/Tk version 8.0 or above.  If Tix has been installed properly  on  your
       system,  you  can  load  the package into any Tk script by invoking the command package require Tix After
       this command has successfully returned, you can start using the functionalities of the Tix  library.  See
       the EXAMPLES section below for example scripts that use Tix.

       If  the  "package  require  Tix"  command  fails,  you probably need to install a new copy of Tix on your
       system. You can download the latest version of Tix from the web site http://tix.sourceforge.net/.

STANDARD WIDGETS

       Tix includes the following standard widgets which, like their counterparts  in  Tk,  are  implemented  in
       native code to achieve high performance and native look-and-feel.

       tixGrid
              The tixGrid widget displays items in a spread-sheet format.

       tixHList
              Hierarchical listbox widget. This widget display entries in a tree-like format.

       tixInputOnly
              A transparent window that can be used to cover another widget so as to disable mouse input.

       tixNBFrame
              The  tixNBFrame widget is used internally by the tixNoteBook widget to display choices among a set
              of overlapping pages.

       tixTList
              Tabular listbox widget. This widget is similar to the built-in Tk listbox widget but provides more
              flexibility in displaying the list entries.

MEGA WIDGETS

       Tix  provides  many new types of mega widgets: these are widgets that are composed of built-in Tk widgets
       and the Tix standard widgets mentioned above.

       tixBalloon
              The tixBalloon widget provides context-sensitive on-screen help.

       tixButtonBox
              A convenience class for creating a box of button widgets.

       tixCheckList
              A subclass of tixTree that presents single- or multiple choices to the user in a tree-like format.

       tixComboBox
              A combination of the listbox and entry widgets that allows the user to input an item by typing  or
              by selecting from a list of items.

       tixControl
              The tixControl widget allows the user to adjust a value using arrow buttons.

       tixDirList
              A directory selection widget that displays the file system as a cascading list.

       tixDirSelectDialog
              A dialog for selecting a directory. This widget is deprecated. Use tk_chooseDirectory instead.

       tixDirTree
              A directory selection widget that displays the file system in a tree format.

       tixExFileSelectBox
              A widget for selecting a file. This widget is deprecated. Use tk_getOpenFile instead.

       tixExFileSelectDialog
              A dialog for selecting a file. This widget is deprecated. Use tk_getOpenFile instead.

       tixFileEntry
              A special entry widget that allows the user to choose a file by typing in its name or by selecting
              from a file dialog.

       tixFileSelectBox
              A widget for selecting a file. This widget is deprecated. Use tk_getOpenFile instead.

       tixFileSelectDialog
              A dialog for selecting a file. This widget is deprecated. Use tk_getOpenFile instead.

       tixLabelEntry
              A convenience class for creating an entry with an associated label widget.

       tixLabelFrame
              A labelled frame widget for grouping together a set of related widgets.

       tixListNoteBook
              The tixListNoteBook widget allows the user to choose from a set of over-lapping pages by selecting
              from a list box.

       tixMeter
              The tixMeter widget displays a bar graph to indicate progress.

       tixNoteBook
              The  tixNoteBook  widget  allows the user to choose from a set of over-lapping pages with a tabbed
              notebook metaphore.

       tixOptionMenu
              The tixOptionMenu widget allows the user to choose a value from a pop-up menu.

       tixPanedWindow
              The tixPanedWindow widgets allows the user to adjust the visible size  of  several  frame  widgets
              with handle bars.

       tixPopupMenu
              The tixPopupMenu widget can be used to implement context-sensitive pop-up menu.

       tixScrolledHList
              A  tixHList  widget with smart scrollbars. Like other Tix scrolled widgets, the scroll bars can be
              displayed on an as-needed basis.

       tixScrolledListBox
              A Tk listbox widget with smart scrollbars.

       tixScrolledText
              A Tk text widget with smart scrollbars.

       tixScrolledWindow
              A Tk frame widget with smart scrollbars.

       tixSelect
              The tixSelect widget uses a set of buttons to present single- or multiple selection options to the
              user.

       tixStdButtonBox
              A  subclass  of  tixButtonBox  that  provides  four  standard buttons (OK, Apply, Cancel Help) for
              Motif(TM)-like dialog boxes.

       tixTree
              A subclass of tixScrolledHList that supports expanding and collapsing of entries in a hierarchical
              list.

DISPLAY ITEMS

       Three  Tix  standard  widgets tixGrid, tixHList and tixTList support the Display Items mechanism. Display
       items are created by the widget command of these standard widgets. You  can  customize  the  items  using
       styles objects.

       tixDisplayStyle
              Create style objects to customize display items.

IMAGE TYPES

       Tix provides two additional image types to the Tk image framework.

       compound
              The  compound  image type allows you to combine images, widgets, and text strings into a single Tk
              image object.

       pixmap The pixmap image type supports the XPM format.

OTHER COMMANDS

       The following Tcl command are also included in the Tix library to perform various functions.

       tixDestroy
              Destroy Tix objects instances of classes defined by tixClass construct.

       tixForm
              A geometry manager based on attachment rules. This geometry manager is deprecated. Use the Tk grid
              geometry manager instead.

       tixMwm A command to communicate with the Mwm, the Motif(TM) Window Manager. Works on Unix only.

       tix    The tix command controls the Tix application context.

       tixGetBoolean
              The tixGetBoolean command converts a string to a boolean value.

       tixGetInt
              The tixGetInt command converts a string to a integer value.

       tixUtils
              The tixUtils manual page describes some utility Tix commands.

EXECUTABLE PROGRAM

       tixwish
              The  tixwish  program  can  be  used to execute Tix-based applications. tixwish is deprecated. You
              shuld use the standard wish program from Tk and access Tix via the "package require Tix" command.

EXAMPLES

       The following is an example script that uses a tixTree widget.

       set tree [tixTree .t] pack $tree -expand yes -fill both for {set i 0} {$i < 2} {incr i} {
           $tree subwidget hlist add $i -itemtype imagetext \
               -text "Folder $i" -image [tix getimage folder]
           for {set j 0} {$j < 5} {incr j} {
               $tree subwidget hlist add $i.$j -itemtype imagetext \
                   -text "File $i.$j" -image [tix getimage textfile]
           } } $tree autosetmode

KEYWORDS

       Tix, mega widgets