Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tixScrolledListBox(n)	     Tix Built-In Commands	 tixScrolledListBox(n)

NAME
       tixScrolledListBox - Create and manipulate Tix ScrolledListBox widgets

SYNOPSIS
       tixScrolledListBox pathName ?options?  -anchor	-background    -cursor
       -relief	 -borderWidth

WIDGET-SPECIFIC	OPTIONS
       [-anchor	anchor]	Specifies the alignment	of the items inside the	 list-
       box subwidget.  Only the	values w and e are allowed. When set to	w, the
       listbox is automatically	aligned	to the beginning of the	 items.	  When
       set to e, the listbox is	automatically aligned to the end of the	items.
       Automatically alignment only happens when  the  ScrolledListBox	widget
       changes	its  size.  [-browsecmd	browsecmd] Specifies the command to be
       called when the user browses the	elements inside	the listbox  subwidget
       (see  the  BINDINGS  section  below).  [-command	command] Specifies the
       command to be called when the user invokes the listbox  subwidget  (see
       the  BINDINGS  section  below).	[-height height] Specifies the desired
       height for the window, in pixels.  [-scrollbar scrollbar] Specifies the
       display policy of the scrollbars. The following values are recognized:

	      auto ?+x?	?-x? ?+y? ?-y?
		     When  -scrollbar  is  set	to  "auto", the	scrollbars are
		     shown only	when needed. Additional	modifiers can be  used
		     to	 force a scrollbar to be shown or hidden. For example,
		     "auto -y" means the horizontal scrollbar should be	 shown
		     when  needed  but the vertical scrollbar should always be
		     hidden; "auto +x" means the vertical scrollbar should  be
		     shown when	needed but the horizontal scrollbar should al-
		     ways be shown, and	so on.

	      both   Both scrollbars are shown

	      none   The scrollbars are	never shown.

	      x	     Only the horizontal scrollbar is shown;

	      y	     Only the vertical scrollbar is shown.
       [-width width] Specifies	the desired width for the window, in pixels.

SUBWIDGETS
       Name:	      hsb
       Class:	      Scrollbar

	      The horizontal scrollbar subwidget.

       Name:	      listbox
       Class:	      Listbox

	      The listbox subwidget inside the ScrolledListBox widget.

       Name:	      vsb
       Class:	      Scrollbar

	      The vertical scrollbar subwidget.

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

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

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

       pathName	cget option
	      Returns the current value	of the configuration option  given  by
	      option.  Option  may  have  any  of  the	values accepted	by the
	      tixScrolledListBox command.

       pathName	configure ?option? ?value option value ...?
	      Query or modify the configuration	options	of the widget.	If  no
	      option is	specified, returns a list describing all of the	avail-
	      able options for pathName	(see Tk_ConfigureInfo for  information
	      on  the  format  of  this	list).	If option is specified with no
	      value, then the command returns a	list describing	the one	 named
	      option (this list	will be	identical to the corresponding sublist
	      of the value returned if no option is  specified).   If  one  or
	      more option-value	pairs are specified, then the command modifies
	      the given	widget option(s) to have the given value(s);  in  this
	      case  the	 command returns an empty string.  Option may have any
	      of the values accepted by	the tixScrolledListBox command.

       pathName	subwidget  name	?args?
	      When no additional arguments are given, returns the pathname  of
	      the subwidget of the specified name.

	      When  no	additional  arguments are given, the widget command of
	      the specified subwidget will be called with these	parameters.

BINDINGS
       [1]    If the -browsecmd	option is set, the command which it referes to
	      is  called  whenever a <ButtonPress-1> or	a <Motion-1> event oc-
	      currs inside the listbox subwidget.

       [2]    The command specified by the -command option is invoked  when  a
	      <Double-1> event occurrs inside the listbox subwidget.

BUGS
       The  capitalization  of	some of	the commands names in Tix 3.x has been
       changed in Tix 4.0. All commands	that ended with	box have been  changed
       to  a capitalized Box. Hence, the command tixScrolledListbox in Tix 3.x
       has been	changed	to tixScrolledListBox in Tix 4.0

KEYWORDS
       Tix(n)

Tix				      4.0		 tixScrolledListBox(n)

NAME | SYNOPSIS | WIDGET-SPECIFIC OPTIONS | SUBWIDGETS | DESCRIPTION | WIDGET COMMANDS | BINDINGS | BUGS | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tixScrolledListBox&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help