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

FreeBSD Manual Pages

  
 
  

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

NAME
       tixScrolledWindow - Create and manipulate Tix ScrolledWindow widgets

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

WIDGET-SPECIFIC	OPTIONS
       [-height	height]	Specifies the desired height for the window,  in  pix-
       els.   [-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.
       [-xscrollincrement xScrollIncrement] Specifies by how much  the	window
       should  be  scrolled  in	the horizontal direction when the user presses
       the arrows in the horizontal  scrollbar.	 In  Pixels.   [-yscrollincre-
       ment yScrollIncrement]  Specifies  by  how  much	 the  window should be
       scrolled	in the vertical	direction when the user	presses	the arrows  in
       the horizontal scrollbar. In pixels.

SUBWIDGETS
       Name:	      hsb
       Class:	      Scrollbar

	      The horizontal scrollbar subwidget.

       Name:	      window
       Class:	      Frame

	      The frame	subwidget which	is scrolled by the ScrolledWindow wid-
	      get.

       Name:	      vsb
       Class:	      Scrollbar

	      The vertical scrollbar subwidget.

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

CREATING WIDGETS INSIDE	A SCROLLEDWINDOW WIDGET
       To create widgets inside	a ScrolledWindow widget, one must  create  the
       new widgets relative to the window subwidget and	manage them inside the
       window subwidget. An error will be generated if	one  tries  to	create
       widgets	as immediate children of the ScrolledWindow.  For example: the
       following is correct code, which	creates	new widgets inside the	window
       subwidget:

	   tixScrolledWindow .w; pack .w
	   set f [.w subwidget window]
	   button $f.b -text hi	-width 40 -height 40
	   pack	$f.b

       The  following example code is incorrect	because	it tries to create im-
       mediate children	of the ScrolledWindow .w:

	   tixScrolledWindow .w; pack .w
	   button .w.b -text hi	-width 40 -height 40
	   pack	.w.b

WIDGET COMMANDS
       The tixScrolledWindow command creates a new Tcl command whose  name  is
       the  same as the	path name of the ScrolledWindow	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 Scrolled-
       Window widget's path name.  Option and the args determine the exact be-
       havior  of  the	command.   The	following  commands  are  possible for
       ScrolledWindow 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
	      tixScrolledWindow	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 tixScrolledWindow 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.

KEYWORDS
       Tix(n)

Tix				      4.0		  tixScrolledWindow(n)

NAME | SYNOPSIS | WIDGET-SPECIFIC OPTIONS | SUBWIDGETS | DESCRIPTION | CREATING WIDGETS INSIDE A SCROLLEDWINDOW WIDGET | WIDGET COMMANDS | KEYWORDS

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

home | help