ChkList man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



     tixCheckList(n)		 Tix (4.0)	       tixCheckList(n)

     _________________________________________________________________

     NAME
	  tixCheckList - Create and manipulate tixCheckList widgets

     SYNOPSIS
	  tixCheckList pathName ?options?

     SUPER-CLASS
	  The TixCheckList class is derived from the TixTree class and
	  inherits  all	 the  commands,	 options and subwidgets of its
	  super-class.

     STANDARD OPTIONS
	  TixCheckList supports all the standard options  of  a	 frame
	  widget.  See	the options(n) manual entry for details on the
	  standard options.

     WIDGET-SPECIFIC OPTIONS
	  Name:		 browseCmd
	  Class:	 BrowseCmd
	  Switch:	 -browsecmd

	       Specifies a command to call whenever the	 user  browses
	       on  an entry (usually by single-clicking on the entry).
	       The command is called with one argument,	 the  pathname
	       of the entry.

	  Name:		 command
	  Class:	 Command
	  Switch:	 -command

	       Specifies a command to call whenever the user activates
	       an entry (usually by double-clicking on the entry). The
	       command is called with one argument,  the  pathname  of
	       the entry.

	  Name:		 radio
	  Class:	 Radio
	  Switch:	 -radio

	       A Boolean value. If set to true, the user can select at
	       most  one item at a time; if set to false, the user can
	       select as many items as possible.

     SUBWIDGETS
	  Name:		 hlist
	  Class:	 TixHList

	       The hierarchical listbox that displays the CheckList.

	  Name:		 hsb

     Page 1					    (printed 12/22/98)

     tixCheckList(n)		 Tix (4.0)	       tixCheckList(n)

	  Class:	 Scrollbar

	       The horizontal scrollbar subwidget.

	  Name:		 vsb
	  Class:	 Scrollbar

	       The vertical scrollbar subwidget.
     _________________________________________________________________

     DESCRIPTION
	  The tixCheckList command creates a new window (given by  the
	  pathName  argument)  and  makes  it into a CheckList widget.
	  Additional options, described above, may be specified on the
	  command  line or in the option database to configure aspects
	  of the CheckList widget such as its cursor and relief.

	  The CheckList widget displays a list of items to be selected
	  by  the user. CheckList acts similarly to the Tk checkbutton
	  or radiobutton widgets, except it  is	 capable  of  handling
	  many more items than checkbuttons or radiobuttons.

	  The items are contained in the hlist subwidget.   Each  item
	  may  be  in  one of the following status: on (indicated by a
	  check bitmap), off (indicated by  a  cross  bitmap)  default
	  (indicated  by a gray box bitmap) or none, in which case the
	  item will not be accompanied by a bitmap.  The  items	 whose
	  status is on, off or default are called the selectable items
	  and can be checked or crossed by the	user.  All  selectable
	  entries must be of the type imagetext.

	  The items whose status is none cannot be checked or  crossed
	  by  the  user;  usually  they	 are  included	in  the	 hlist
	  subwidget only for explanation purposes or as separators.

	  Initially, all the items have a none status. To make an item
	  selectable, you can call the setstatus command to change its
	  status (see below).

	  Notice that CheckList is a subclass of  the  TixTree	widget
	  and	thus  is  is  capable  of  displaying  a  hierachy  of
	  selectable entries. When necessary, you can call the setmode
	  method  (see TixTree(n)) to define the hierachical structure
	  of the selectable entries.

     WIDGET COMMANDS
	  The tixCheckList command creates a  new  Tcl	command	 whose
	  name is the same as the path name of the CheckList's window.
	  This command may be used to invoke various operations on the
	  widget. It has the following general form:

	       pathName option ?arg arg ...?

     Page 2					    (printed 12/22/98)

     tixCheckList(n)		 Tix (4.0)	       tixCheckList(n)

	  PathName is the name of the command, which is	 the  same  as
	  the  CheckList  widget's  path  name.	 Option	 and  the args
	  determine the exact behavior of the command.	The  following
	  commands are possible for CheckList widgets:

	  pathName getselection ?status?
	       Returns a list of items whose status matches status. If
	       status  is not specified, the list of items in the "on"
	       status will be returned.

	  pathName getstatus entryPath
	       Returns the current status of entryPath.

	  pathName setstatus entryPath status
	       Sets the status of entryPath to	be  status.  A	bitmap
	       will  be	 displayed next to the entry its status is on,
	       off or default.

	  pathName subwidget  name ?args?
	       When no options are given,  this	 command  returns  the
	       pathname of the subwidget of the specified name.

	       When options are	 given,	 the  widget  command  of  the
	       specified subwidget will be called with these options.

     EXAMPLE
	  This example creates several choices for the user to select.

	   tixCheckList .c
	   .c subwidget hlist add choice1 -itemtype imagetext -text "Choice 1"
	   .c subwidget hlist add choice2 -itemtype imagetext -text "Choice 2"
	   .c subwidget hlist add choice3 -itemtype imagetext -text "Choice 3"
	   .c setstatus choice1 on
	   .c setstatus choice2 off
	   .c setstatus choice3 off
	   pack .c

     BINDINGS
	  The basic mouse  and	keyboard  bindings  of	the  CheckList
	  widget are the same as the bindings of the TixTree widget.

	  In addition, the status of the entries in the CheckList  are
	  toggled under the following conditions:

	  [1]  When the user press the mouse button over an entry.

	  [2]  When the user press the <space> key over an entry.

	  [3]  When the user press the <Return> key over an entry.

     KEYWORDS

     Page 3					    (printed 12/22/98)

     tixCheckList(n)		 Tix (4.0)	       tixCheckList(n)

	  Tix(n), tixHList(n), tixTree(n)

     Page 4					    (printed 12/22/98)

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net