Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for tixpanedwindow (redhat section n)

tixPanedWindow(n)		      Tix Built-In Commands			tixPanedWindow(n)

_________________________________________________________________________________________________

NAME
       tixPanedWindow - Create and manipulate tixPanedWindow widgets

SYNOPSIS
       tixPanedWindow pathName ?options?

STANDARD OPTIONS
       The  PanedWindow  widget  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:	      command
       Class:	      Command
       Switch:	      -command

	      Specifies the command to invoke when the panes change their sizes.  This command is
	      called with a list of integers that record the new sizes of the panes. The sizes of
	      the panes are listed in the order of the panes' creation.  [-dynamicgeometry dynam-
	      icGeometry]  If set to true, the size of the PanedWindow will dynamically change if
	      the size of any of its panes changes. Otherwise, the size of the	PanedWindow  will
	      only  increase  when  size  of  any of its panes changes and will not decrease. The
	      default value is true.  [-handleactivebg handleActiveBg] Specifies the active back-
	      ground  color  of the resize handles. When the mouse cursor enters a resize handle,
	      the resize handle will adopt the	active	background  color.   [-handlebg handleBg]
	      Specifies  the  normal  background  color  of the resize handles.  [-height height]
	      Specifies the desired height for the window.  [-orientation orientation]	Specifies
	      the orientation of the panes. Must be either vertical or horizontal.  [-paneborder-
	      width  or  -panebd paneBorderWidth]  Specifies  the  border  width  of  the  panes.
	      [-panerelief paneRelief]	Specifies the border relief of the panes.  [-separatorac-
	      tivebg separatorActiveBg] Specifies the active background color of the  separators.
	      When  the  user  grabs  a resize handle, the separators will adopt the active back-
	      ground color.  [-separatorbg separatorBg] Specifies the normal background color  of
	      the separators.  [-width width] Specifies the desired width for the window.

SUBWIDGETS
       All the pane subwidgets created as a result of the add command can be accessed by the sub-
       widget command. They are identified by the paneName parameter to the add command.
_________________________________________________________________

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

       The  PanedWindow  widget  allows the user to interactively manipulate the sizes of several
       panes. The panes can be arranged either vertically or horizontally. Each  individual  pane
       may  have  upper  and lower limits of its size. The user changes the sizes of the panes by
       dragging the resize handle between two panes.

WIDGET COMMAND
       The tixPanedWindow command creates a new Tcl command whose name is the same  as	the  path
       name of the PanedWindow widget's window.  This command may be used to invoke various oper-
       ations 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 frame  widget's  path  name.
       Option  and  the args determine the exact behavior of the command.  The following commands
       are possible for PanedWindow widgets:

       pathName add paneName ?option value ...?
	      Adds a new pane subwidget with the name paneName into the PanedWindow widget. Addi-
	      tional  configuration  options  can be given to configure the new button subwidget.
	      Three configuration options are supported:

	      -after pane
		     Specifies that the new pane should be placed after pane in the list of panes
		     in this PanedWindow widget.

	      -at integer
		     Specifies	the  position of the new pane in the list of panes in this Paned-
		     Window widget. 0 means the first position, 1 means the second, and so on. In
		     addition, end means the end of the list.

	      -before pane
		     Specifies	that  the  new	pane  should be placed before pane in the list of
		     panes in this PanedWindow widget.

	      -expand factor
		     Specifies the expand/shrink factor of this pane. Factor must be a	non-nega-
		     tive floating point number. The default value is 0.0. The expand/shrink fac-
		     tor is used to calculate how much each pane should grow or shrink	when  the
		     size  of  the  PanedWindow  main  window  is  changed.  When the main window
		     expands/shrinks by n pixels, then pane i will grow/shrink by about n *  fac-
		     tor(i)  / summation(factors), where factor(i) is the expand/shrink factor of
		     pane i and summation(factors) is the summation of the expand/shrink  factors
		     of all the panes. If summation(factors) is 0.0, however, only the last visi-
		     ble pane will be grown or shrunk.

	      -min integer
		     Specifies the minimum size, in pixels, of the new pane; the default is 0.

	      -max integer
		     Specifies the maximum size, in pixels, of	the  new  pane;  the  default  is
		     10000.

	      -size integer
		     Specifies	the  size, in pixels, of the new pane; if the -size option is not
		     given, or set to the empty string, the PanedWindow widget will use the natu-
		     ral size of the pane subwidget.

       pathName cget option
	      Returns  the  current value of the configuration option given by option. Option may
	      be -min, -max and/or -size, or any option accepted by the Tk frame widget.

       pathName configure ?option? ?value option value ...?
	      Query or modify the configuration options of the widget.	If no  option  is  speci-
	      fied,  returns  a  list  describing  all of the available options for pathName (see
	      Tk_ConfigureInfo for information on the format of this list).  If option is  speci-
	      fied 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 be any of the non-static
	      options of the PanedWindow widget.

       pathName delete paneName
	      Removes the pane given by paneName and deletes its contents.

       pathName forget paneName
	      Removes the pane given by paneName but does not delete its contents. This pane  can
	      be later added back to the PanedWindow widget by the manage method.

       pathName manage paneName ?option value ...?
	      Adds  the  pane given by paneName back to the PanedWindow widget.  PaneName must be
	      already forgotten by the forget method.  Additional  option-value  pairs,  same  as
	      those  accepted by the add method, can be given to control the appearance and posi-
	      tion of the pane.

       pathName panecget paneName option
	      Returns the current value of the configuration option given by option in	the  pane
	      given  by  paneName.  Option  may have any of the values accepted by the add widget
	      command.

       pathName paneconfigure paneName ?option? ?value ...?
	      When no option is given, prints out the values of all  options  of  this	pane.  If
	      option  is  specified  with no value, then the command returns the current value of
	      that option. If one or more option-value pairs are specified, then the command mod-
	      ifies  the given pane's option(s) to have the given value(s); in this case the com-
	      mand returns an empty string. Option may be -min, -max and/or -size, or any  option
	      accepted	by the Tk frame widget. The sizes of the panes may be changed as a result
	      of calling the paneconfigure command.

       pathName panes
	      Returns a list of the names of all panes.

       pathName setsize paneName newSize ?direction?
	      Sets the size of the pane specified by paneName to newSize. The direction parameter
	      specifies in which direction the pane should grow/shrink. Possible values are next:
	      the pane will grow or shrink by moving the boundary between itself and the pane  to
	      its  right  or  bottom;  prev:  the pane will grow or shrink by moving the boundary
	      between itself and the pane to its left or top.

       pathName subwidget name ?args?
	      When no options are given, 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.

BINDINGS
       The panes' sizes will be changed when the user drags the handles. The change in the panes'
       sizes may be subjected to the -min, -max and -size options of the panes.

KEYWORDS
       TIX, Container Widget

Tix					       4.0				tixPanedWindow(n)


All times are GMT -4. The time now is 06:02 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password