Programming Panedwindow Widgets

Table 28-1 summarizes the operations for programming a panedwindow. In the table, $w is a panedwindow widget and win is a widget managed by the panedwindow.

Table 28-1. Panedwindow operations

$w add win ?win...? ?option value...?	Adds one or more widgets to the panedwindow, each in a separate pane, with options as described in Table 28-2.
$w cget option	Returns the value of the configuration option as described in Table 28-3.
$w configure ?option value...?	Queries or modifies the panedwindow configuration, with options as described in Table 28-3.
$w forget win ?win...?	Removes the pane(s) containing widget(s) from the panedwindow.
$w identify x y	Identifies the panedwindow component underneath the specified point.
$w panecget win option	Returns the value of the widget's configuration option as described in Table 28-2.
$w paneconfigure index ?option? ?value? ?...?	Queries or modifies the widget's configuration options as described in Table 28-2.
$w panes	Returns an ordered list of the widgets managed by the panedwindow.
$w proxy coord	Returns the current x and y coordinate pair for the sash proxy, used for rubberband-style pane resizing.
$w proxy forget	Removes the sash proxy from the display.
$w proxy place x y	Places the sash proxy at the given coordinates.
$w sash coord index	Returns the current x and y coordinate pair for the sash indicated by index.
$w sash dragto index x y	Moves the sash from the previous mark position.
$w sash mark index x y	Starts a sash movement operation. index is the sash to move, and x and y are widget-relative screen coordinates.
$w sash place index x y	Places the indicated sash at the given coordinates.

Table 28-2 summarizes the panedwindow options for managed widgets. These are set when adding a widget to the paned window with the add operation or afterwards with paneconfigure operation. The current settings are returned by the panecget operation.

Table 28-2. Panedwindow managed widget options

-after win	Inserts the widget after the specified win.
-before win	Inserts the widget before the specified win.
-height size	Height of the widget, including its border, in screen units. The actual widget height may vary based on -sticky settings, panedwindow resizing, and sash movement.
-minsize size	Minimum widget size of the widget in the paned dimension, specified in screen units.
-padx size	External widget padding in the X direction, in screen units.
-pady size	External widget padding in the Y direction, in screen units.
-sticky how	Positions the widget next to any combination of north (n), south (s), east (w), and west (e) sides of the pane. Use {} for center. If opposing directions are specified (e.g., ns), the widget stretches to fill in those directions. Default: nsew.
-width size	Width of the widget, including its border, in screen units. The actual widget width may vary based on -sticky settings, panedwindow resizing, and sash movement.