1ttk::panedwindow(n)            Tk Themed Widget            ttk::panedwindow(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       ttk::panedwindow - Multi-pane container window
9

SYNOPSIS

11       ttk::panedwindow pathname ?options?
12       pathname add window ?options...?
13       pathname insert index window ?options...?
14______________________________________________________________________________
15

DESCRIPTION

17       A  ttk::panedwindow  widget  displays  a  number of subwindows, stacked
18       either vertically or horizontally.  The user may  adjust  the  relative
19       sizes of the subwindows by dragging the sash between panes.
20

STANDARD OPTIONS

22       -class                -cursor              -takefocus
23       -style
24
25       See the ttk_widget manual entry for details on the standard options.
26

WIDGET-SPECIFIC OPTIONS

28       Command-Line Name:-orient
29       Database Name:  orient
30       Database Class: Orient
31
32              Specifies  the orientation of the window.  If vertical, subpanes
33              are stacked top-to-bottom; if horizontal, subpanes  are  stacked
34              left-to-right.
35
36       Command-Line Name:-width
37       Database Name:  width
38       Database Class: Width
39
40              If present and greater than zero, specifies the desired width of
41              the widget in pixels.  Otherwise, the requested width is  deter‐
42              mined by the width of the managed windows.
43
44       Command-Line Name:-height
45       Database Name:  height
46       Database Class: Height
47
48              If  present  and greater than zero, specifies the desired height
49              of the widget in pixels.  Otherwise,  the  requested  height  is
50              determined by the height of the managed windows.
51

PANE OPTIONS

53       The following options may be specified for each pane:
54
55       Command-Line Name:-weight
56       Database Name:  weight
57       Database Class: Weight
58
59              An  integer  specifying the relative stretchability of the pane.
60              When the paned window is resized, the extra space  is  added  or
61              subtracted to each pane proportionally to its -weight.
62

WIDGET COMMAND

64       Supports the standard configure, cget, state, and instate commands; see
65       ttk::widget(n) for details.  Additional commands:
66
67       pathname add subwindow options...
68              Adds a new pane to the window.  See PANE OPTIONS for the list of
69              available options.
70
71       pathname forget pane
72              Removes  the  specified subpane from the widget.  pane is either
73              an integer index or the name of a managed subwindow.
74
75       pathname identify component x y
76              Returns the name of the element under the point given by  x  and
77              y,  or the empty string if no component is present at that loca‐
78              tion.  If component is omitted, it defaults to sash.   The  fol‐
79              lowing subcommands are supported:
80
81              pathname identify element x y
82                     Returns  the  name  of the element at the specified loca‐
83                     tion.
84
85              pathname identify sash x y
86                     Returns the index of the sash at the specified location.
87
88       pathname insert pos subwindow options...
89              Inserts a pane at the specified position.   pos  is  either  the
90              string  end,  an integer index, or the name of a managed subwin‐
91              dow.  If subwindow is already managed by the paned window, moves
92              it  to the specified position.  See PANE OPTIONS for the list of
93              available options.
94
95       pathname pane pane -option ?value ?-option value...
96              Query or modify the options of the specified pane, where pane is
97              either  an integer index or the name of a managed subwindow.  If
98              no -option is specified, returns a dictionary of the pane option
99              values.   If one -option is specified, returns the value of that
100              option.  Otherwise, sets the -options to the corresponding  val‐
101              ues.
102
103       pathname panes
104              Returns  the  list  of all windows managed by the widget, in the
105              index order of their associated panes.
106
107       pathname sashpos index ?newpos?
108              If newpos is specified, sets the position of sash number  index.
109              May adjust the positions of adjacent sashes to ensure that posi‐
110              tions are monotonically increasing.  Sash positions are  further
111              constrained  to  be  between 0 and the total size of the widget.
112              Returns the new position of sash number index.
113
114       The panedwindow widget also supports the following generic  ttk::widget
115       widget subcommands (see ttk::widget(n) for details):
116
117              cget                  configure
118              instate               state
119
120

VIRTUAL EVENTS

122       The  panedwindow  widget generates an <<EnteredChild>> virtual event on
123       LeaveNotify/NotifyInferior events, because Tk does not execute  binding
124       scripts  for <Leave> events when the pointer crosses from a parent to a
125       child. The panedwindow widget needs to know when that happens.
126

STYLING OPTIONS

128       The class name for a ttk::panedwindow is TPanedwindow.  The sash has  a
129       class name of Sash.
130
131       TPanedwindow styling options configurable with ttk::style are:
132
133       -background color
134
135       Sash styling options configurable with ttk::style are:
136
137       -background color
138       -bordercolor color
139       -gripcount count
140       -handlepad amount
141       -handlesize amount
142       -lightcolor color
143       -sashpad amount
144       -sashrelief relief
145       -sashthickness amount
146
147       Some options are only available for specific themes.
148
149       See  the ttk::style manual page for information on how to configure ttk
150       styles.
151

SEE ALSO

153       ttk::widget(n), ttk::notebook(n), panedwindow(n)
154
155
156
157Tk                                    8.5                  ttk::panedwindow(n)
Impressum