Definitions in Tix.hs

The Tix environment

struct TixEnv < TkEnv =
  tixWindow  :: [WindowOpt]     -> Request TixWindow
  fileDialog :: [FileDialogOpt] -> Request FileDialog
  popupMenu  :: [PopupMenuOpt]  -> Request PopupMenu

TixWindows

struct TixWindow < TixBasicWindow WindowOpt, ManagedWindow, Window

struct TixBasicWindow a < BasicWindow a =
  toolTip            :: [FrameOpt]         -> Request ToolTip
  comboBox           :: Bool -> [ComboOpt] -> Request ComboBox
  spinBox            :: [SpinBoxOpt]       -> Request SpinBox
  hList              :: [HListOpt]         -> Request HList
  noteBook           :: [NoteBookOpt]      -> Request NoteBook
  panedWindow        :: [PanedWindowOpt]   -> Request PanedWindow
  optionMenu         :: [String] -> [OptionMenuOpt] -> Request OptionMenu
  scrolledHList      :: [ScrHListOpt]      -> Request ScrolledHList
  scrolledListBox    :: [ScrListBoxOpt]    -> Request ScrolledListBox
  scrolledTextEditor :: [ScrTextEditorOpt] -> Request ScrolledTextEditor
  scrolledTree       :: [ScrTreeOpt]       -> Request ScrolledTree
  scrolledBasicWindow:: [ScrWindowOpt]     -> Request ScrolledBasicWindow

struct FileDialog < ConfWidget FileDialogOpt, PopupWidget =
  subOK, subFilter, subCancel, subHelp :: Button

struct PopupWidget =
   popup   :: Action
   popdown :: Action

data FileDialogOpt  > StdOpt, CmdString

data CmdString = CmdString (String -> Cmd ())

Popup menus

type PopupMenuOpt = Title

struct PopupMenu < Configurable PopupMenuOpt, HasMenu, HasMenuButton =
  popupIn       :: Widget -> Action

struct HasMenu =
  subMenu :: Menu

struct HasMenuButton =
  subMenuButton :: MenuButton

TixWindow widgets

struct ToolTip < WWidget FrameOpt, HasLabel = 
   attachTo     :: Widget -> String -> Action

struct ComboBox < WWidget ComboOpt, LineEditable, 
                  Cell Int, HasLabel, HasListBox, HasEntry

struct SpinBox < WWidget SpinBoxOpt, Cell Int, HasLabel, HasEntry

struct OptionMenu < WWidget OptionMenuOpt, Cell Int

struct HList < WWidget HListOpt, Cell [String] =
  addEntry :: [HListEntryOpt] -> Request HListEntry
  childAt  :: HListPath -> Request HListEntry

struct PanedWindow < WWidget PanedWindowOpt =
  pane :: [PaneOpt] -> Request (TixBasicWindow PaneOpt)
  
struct NoteBook < WWidget FrameOpt =
  page   :: [PageOpt] -> Request (TixBasicWindow PageOpt)
  raised :: Request (Maybe(TixBasicWindow PageOpt))

struct ScrolledTree < WWidget ScrTreeOpt, HasHList = 
  decorate :: Action

struct ScrolledListBox < WWidget ScrListBoxOpt, HasListBox 
   
struct ScrolledWindow < WWidget ScrWindowOpt, HasBasicWindow 
   
struct ScrolledTextEditor < WWidget ScrTextEditorOpt, HasTextEditor

struct ScrolledHList < WWidget ScrHListOpt, HasHList

type PopupMenuOpt = Title
data PanedWindowOpt > StdOpt, Orientation
data PaneOpt        > Min, Max, ExpandRate
data PageOpt        > CLabel, Img, Btmp, Enabled, Underline, Justify, RaiseCmd
data FileDialogOpt  > StdOpt, CmdString
data ComboOpt       > StdOpt, CmdString, CLabel, Dropdown
data SpinBoxOpt     > StdOpt, CmdInt, CLabel, Min, Max, Step
type NoteBookOpt = StdOpt
data HListOpt         > StdOpt, Font, Foreground, 
                        SelectMode, CmdString, DrawBranch
data HListEntryOpt    > Btmp, Img, Text
data ScrWidgetOpt     > StdOpt, ScrollPolicy
type ScrTextEditorOpt = ScrWidgetOpt
type ScrHListOpt      = ScrWidgetOpt
type ScrTreeOpt       = ScrWidgetOpt
type ScrWindowOpt     = ScrWidgetOpt
data ScrListBoxOpt    > ScrWidgetOpt, Command, Anchor
data OptionMenuOpt    > StdOpt, CmdString, Enabled, CLabel

A brief description of these widgets are:

• A ToolTip is a widget that can one can attachTo another widget wid together with a string, usually with some explanatory text. When the mouse cursor is positioned over wid for a short (presently non-configurable) time, a window with the string pops up.
• A ComboBox has a Label, an Entry and a ListBox as subwidgets. The user can provide input either by typing in the entry or selecting from the listbox. A callback procedure that is applied to the user input can be installed using the CmdString option. The Boolean argument decides whether the text entry field is user editable (this is not configurable, hence not suitable as an option). A ComboBox is a Cell Int, with the index in the listbox as value.
• A SpinBox is a widget for rapid selection of an integer value. It has an Entry as a subwidget, but provides also added behavior in the form of two arrow buttons. Pressing these causes the value in the entry to spin upwards or downwards. Maximum and minimum values and spin step can be configured through options. The user can also edit the entry as usual, but the widget prevents entry of numbers outside the interval specified.
• A NoteBook consists of a number of pages, each consisting of a TixBasicWindow. Pages can be added to the notebook; these are displayed one at a time, with tabs allowing selection of different pages. The text on the tab is set using the page's CLabel option. With each page can be associated a RaiseCmd option, indicated a command to be executed when the page beomes visible.
• An OptionMenu is a widget for selection among a fixed number of alternatives. The list of string alternatives is given at creation time and cannot be changed. The current selection is shown as a button; when pressing left button on it a menu with all alternatives pops up and the new selection is indicated by releasing the button over an alternative. User selection can be observed using the CmdInt option, whose callback procedure will be called with the index of the selection as argument (first alternative has index 0). Setting and reading the selection also uses this integer index; hence an OptionMenu is a Cell Int.
• A HList is a widget for displaying tree-like structures (or, rather, forests of trees). New trees can be added to the forest and new (last) children to any node. A node is an element of the structure

  struct HListEntry < Configurable HListEntryOpt, Cell String = 
    addChild  :: [HListEntryOpt] -> Request HListEntry
    hide, unhide :: Action
    see       :: Action
    delete    :: Action
    depth     :: Int
    getParent :: Request(Maybe HListEntry)
  

  Whole (sub)trees, can be hidden from display using hide; when the whole forest is not visible in the window, scrolling can be forced so hat the node is seen.

  The widget can work in single or multiple selection mode; in the latter, multiple selections are achieved either by dragging (to select a contiguous sequence) or using Ctrl-Button1. Double-clicking on a node invokes it; the callback procedure specified by the CmdString option is invoked with the path to he node as argument. (A path is a string such as "0.1.2", indicating the third child of the second child of the first tree).

• A PanedWindow is a widget composed of several panes, displayed side by side with vertical (default) or horisontal Orientation. The panes can be resized by dragging the border between panes. Maximum and minimum sizes (in pixels) can be set on panes and the relative ExpandRate governing how sizes to the whole PanedWindow (e.g. by the user resizing the window) is distributed among panes.
• The widgets ScrolledListBox, ScrolledHList, ScrolledTextEditor and ScrolledBasicWindow are all just the corresponding widget without the Scrolled prefix. The widgets has a ScrollPolicy option allowing adding scrollbars by need.
• Finally, the ScrolledTree is similar to ScrolledHList but with one extra feature; the tree can be decorated, with the effect that a small square containing a "-" appears in front of each non-leaf node. Clicking on thissquare hides the node's children and changes the square'scontent to a +. Clicking again unhides the subtree. After ading nodes to the tree, it has to be decorated again.