---
name: "paned"
section: "3tcl"
platform: "linux"
package: "tk-tile"
version: "0.8.2-2.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/paned"
---

# paned(3tcl)

Multi-pane container window

## NAME

ttk::panedwindow - Multi-pane container window

## SYNOPSIS

```
ttk::panedwindow pathName ?options?
pathName add window ?options...?
pathName insert index window ?options...?
```

## DESCRIPTION

A panedwindow widget displays a number of subwindows, stacked either vertically or horizontally.   The user may adjust the relative sizes of the subwindows by dragging the sash between panes. -class	-cursor	-takefocus	-style

## WIDGET OPTIONS

\[**-orient** *orient Orient*\] Specifies the orientation of the window. If **vertical**, subpanes are stacked top-to-bottom; if **horizontal**, subpanes are stacked left-to-right. \[**-width** *width Width*\] If present and greater than zero,  specifies the desired width of the widget in pixels. Otherwise, the requested width is determined by the width of the managed windows. \[**-height** *height Height*\] If present and greater than zero,  specifies the desired height of the widget in pixels. Otherwise, the requested height is determined by the height of the managed windows.

## PANE OPTIONS

The following options may be specified for each pane: \[**-weight** *weight Weight*\] An integer specifying the relative stretchability of the pane. When the panedwindow is resized, the extra space is added or subtracted to each pane proportionally to its **-weight**.

## WIDGET COMMAND

Supports the standard **configure**, **cget**, **state**,  and **instate** commands; see *widget(n)* for details. Additional commands:

- *pathname* **add** *subwindow* *options...*

  Adds a new pane to the window. *subwindow* must be a direct child of the panedwindow *pathname*. See **PANE OPTIONS** for the list of available options.

- *pathname* **forget** *pane*

  Removes the specified subpane from the widget. *pane* is either an integer index or the name of a managed subwindow.

- *pathname* **insert** *pos* *subwindow* *options...*

  Inserts a pane at the specified position. *pos* is either the string **end**, an integer index,  or the name of a managed subwindow. If *subwindow* is already managed by the panedwindow,  moves it to the specified position. See **PANE OPTIONS** for the list of available options.

- *pathname* **pane** *pane -option* ?*value* ?*-option value...*

  Query or modify the options of the specified *pane*, where *pane* is either an integer index or the name of a managed subwindow. If no *-option* is specified, returns a dictionary of the pane  option values. If one *-option* is specified, returns the value of that *option*. Otherwise, sets the *-option*s to the corresponding *value*s.

- *pathname* **panes**

  Returns the list of all windows managed by the widget.

- *pathname* **sashpos** *index* ?*newpos*?

  If *newpos* is specified, sets the position  of sash number *index*. May adjust the positions of adjacent sashes to ensure that positions are monotonically increasing. Sash positions are further constrained to be between 0  and the total size of the widget. Returns the new position of sash number *index*.

- *pathname* **identify** *x y*

  Returns the index of the sash at point *x,y*, or the empty string if *x,y* is not over a sash.

## SEE ALSO

widget(n), [notebook(n)](/notebook/n.md)