head	1.20;
access;
symbols
	core-8-5-9:1.15.2.2
	core-8-5-8:1.15.2.1
	macosx-cocoa-merge:1.19
	macosx-cocoa-premerge:1.19
	macosx-carbon-freeze:1.19
	core-8-5-7:1.15.2.1
	core-8-5-6:1.15.2.1
	core-8-6-b1:1.19
	core-8-6-a3:1.18
	core-8-5-5:1.15.2.1
	core-8-6-a2:1.17
	core-8-5-4:1.15.2.1
	core-8-5-3:1.15.2.1
	core-8-6-a1:1.16
	core-8-5-branch:1.15.0.2
	core-8-5-2:1.15
	core-8-5-1:1.15
	core-8-5-0:1.14
	core-8-5-b3:1.12
	core-8-5-b2:1.9
	core-8-5-b1:1.6
	core-stablilizer-merge:1.6
	core-stabilizer-branch:1.4.0.2
	core-stabilizer-merge:1.15.2.1
	core-8-5-a6:1.3;
locks; strict;
comment	@# @;


1.20
date	2009.11.01.18.12.44;	author jenglish;	state Exp;
branches;
next	1.19;

1.19
date	2008.11.19.20.17.34;	author jenglish;	state Exp;
branches;
next	1.18;

1.18
date	2008.09.23.13.36.57;	author dkf;	state Exp;
branches;
next	1.17;

1.17
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.16;

1.16
date	2008.05.09.18.35.00;	author patthoyts;	state Exp;
branches;
next	1.15;

1.15
date	2008.01.29.15.38.00;	author dkf;	state Exp;
branches
	1.15.2.1;
next	1.14;

1.14
date	2007.12.13.15.23.44;	author dgp;	state Exp;
branches;
next	1.13;

1.13
date	2007.12.12.15.51.22;	author jenglish;	state Exp;
branches;
next	1.12;

1.12
date	2007.11.01.10.59.43;	author dkf;	state Exp;
branches;
next	1.11;

1.11
date	2007.10.30.21.29.59;	author dkf;	state Exp;
branches;
next	1.10;

1.10
date	2007.10.29.16.04.14;	author dkf;	state Exp;
branches;
next	1.9;

1.9
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.8;

1.8
date	2007.10.23.15.44.36;	author dkf;	state Exp;
branches;
next	1.7;

1.7
date	2007.10.22.14.33.13;	author dkf;	state Exp;
branches;
next	1.6;

1.6
date	2007.06.10.03.25.32;	author jenglish;	state Exp;
branches;
next	1.5;

1.5
date	2007.06.09.21.45.44;	author jenglish;	state Exp;
branches;
next	1.4;

1.4
date	2007.05.03.23.55.30;	author dkf;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2006.12.13.23.04.33;	author hobbs;	state Exp;
branches;
next	1.2;

1.2
date	2006.11.15.13.29.17;	author dkf;	state Exp;
branches;
next	1.1;

1.1
date	2006.10.31.01.42.25;	author hobbs;	state Exp;
branches;
next	;

1.4.2.1
date	2007.06.12.16.22.40;	author dgp;	state Exp;
branches;
next	1.4.2.2;

1.4.2.2
date	2007.10.24.12.59.31;	author dgp;	state Exp;
branches;
next	1.4.2.3;

1.4.2.3
date	2007.10.27.04.23.14;	author dgp;	state Exp;
branches;
next	1.4.2.4;

1.4.2.4
date	2007.11.01.16.37.16;	author dgp;	state Exp;
branches;
next	1.4.2.5;

1.4.2.5
date	2007.12.13.06.28.47;	author dgp;	state Exp;
branches;
next	1.4.2.6;

1.4.2.6
date	2008.01.29.17.35.50;	author dgp;	state Exp;
branches;
next	1.4.2.7;

1.4.2.7
date	2008.06.25.16.46.02;	author dgp;	state Exp;
branches;
next	;

1.15.2.1
date	2008.05.11.00.31.03;	author patthoyts;	state Exp;
branches;
next	1.15.2.2;

1.15.2.2
date	2010.08.26.02.06.09;	author hobbs;	state Exp;
branches;
next	;


desc
@@


1.20
log
@Uniform, extensible syntax for [$w identify] methods:
[$w identify $component $x $y].
All ttk::* widgets support [$w identify element $x $y];
widgets with other identifiable parts may have additional subcommands.
Notebook widgets support [$nb identify tab],
Panedwindow widgets support [$w identify sash].
Older 2-argument form [$w identify $x $y] still supported,
though it does different things depending on the widget.
@
text
@'\"
'\" Copyright (c) 2005 Joe English
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.19 2008/11/19 20:17:34 jenglish Exp $
'\"
.so man.macros
.TH ttk::panedwindow n 8.5 Tk "Tk Themed Widget"
.BS
.SH NAME
ttk::panedwindow \- Multi-pane container window
.SH SYNOPSIS
.nf
\fBttk::panedwindow\fR \fIpathname \fR?\fIoptions\fR?
.br
\fIpathname \fBadd\fR \fIwindow\fR ?\fIoptions...\fR?
\fIpathname \fBinsert\fR \fIindex\fR \fIwindow\fR ?\fIoptions...\fR?
.fi
.BE
.SH DESCRIPTION
A \fBttk::panedwindow\fR 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.
.SO ttk_widget
\-class	\-cursor	\-takefocus
\-style
.SE
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-orient orient Orient
Specifies the orientation of the window.
If \fBvertical\fR, subpanes are stacked top-to-bottom;
if \fBhorizontal\fR, subpanes are stacked left-to-right.
.OP \-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.
.OP \-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.
.SH "PANE OPTIONS"
The following options may be specified for each pane:
.OP \-weight weight Weight
An integer specifying the relative stretchability of the pane.
When the paned window is resized, the extra space is added
or subtracted to each pane proportionally to its \fB\-weight\fR.
.SH "WIDGET COMMAND"
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR,
and \fBinstate\fR commands; see \fIttk::widget(n)\fR for details.
Additional commands:
.TP
\fIpathname\fR \fBadd\fR \fIsubwindow\fR \fIoptions...\fR
Adds a new pane to the window.
See \fBPANE OPTIONS\fR for the list of available options.
.TP
\fIpathname\fR \fBforget\fR \fIpane\fR
Removes the specified subpane from the widget.
\fIpane\fR is either an integer index or the name of a managed subwindow.
.TP
\fIpathname\fR \fBidentify\fR \fIcomponent\fR \fIx\fR \fIy\fR
Returns the name of the element under the point given by \fIx\fR and \fIy\fR,
or the empty string if no component is present at that location.
If \fIcomponent\fR is omitted, it defaults to \fBsash\fR.
The following subcommands are supported:
.RS
.TP
\fIpathname\fR \fBidentify\fR \fBelement\fR \fIx\fR \fIy\fR
Returns the name of the element at the specified location.
.TP
\fIpathname\fR \fBidentify\fR \fBsash\fR \fIx\fR \fIy\fR
Returns the index of the sash at the specified location.
.RE
.TP
\fIpathname\fR \fBinsert\fR \fIpos\fR \fIsubwindow\fR \fIoptions...\fR
Inserts a pane at the specified position.
\fIpos\fR is either the string \fBend\fR, an integer index,
or the name of a managed subwindow.
If \fIsubwindow\fR is already managed by the paned window,
moves it to the specified position.
See \fBPANE OPTIONS\fR for the list of available options.
.TP
\fIpathname\fR \fBpane\fR \fIpane \-option \fR?\fIvalue \fR?\fI\-option value...\fR
Query or modify the options of the specified \fIpane\fR,
where \fIpane\fR is either an integer index or the name of a managed subwindow.
If no \fI\-option\fR is specified, returns a dictionary of the pane
option values.
If one \fI\-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI\-option\fRs to the corresponding \fIvalue\fRs.
.TP
\fIpathname\fR \fBpanes\fR
Returns the list of all windows managed by the widget.
.TP
\fIpathname\fR \fBsashpos\fR \fIindex\fR ?\fInewpos\fR?
If \fInewpos\fR is specified, sets the position
of sash number \fIindex\fR.
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.
.\" Full story: "total size" is either the -height (resp -width),
.\" or the actual window height (resp actual window width),
.\" depending on which changed most recently.
Returns the new position of sash number \fIindex\fR.
.\" Full story: new position may be different than the requested position.
.SH "SEE ALSO"
ttk::widget(n), ttk::notebook(n), panedwindow(n)
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.19
log
@Remove inoperative text stating that slave windows must be
direct children of the master [Bug 1824996].
@
text
@d6 3
a8 3
'\" 
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.18 2008/09/23 13:36:57 dkf Exp $
'\" 
d16 1
a16 1
\fBttk::panedwindow\fR \fIpathName \fR?\fIoptions\fR?
d18 2
a19 2
\fIpathName \fBadd\fR \fIwindow\fR ?\fIoptions...\fR?
\fIpathName \fBinsert\fR \fIindex\fR \fIwindow\fR ?\fIoptions...\fR?
d23 4
a26 4
.PP
A \fBttk::panedwindow\fR 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.
d37 1
a37 1
If present and greater than zero, 
d42 1
a42 1
If present and greater than zero, 
a46 1
.PP
d53 1
a53 2
.PP
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, 
d57 1
a57 1
\fIpathname \fBadd\fR \fIsubwindow\fR \fIoptions...\fR
d61 1
a61 1
\fIpathname \fBforget\fR \fIpane\fR
d65 13
a77 3
\fIpathname\fR \fBidentify\fR \fIx y\fR
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
d79 1
a79 1
\fIpathname \fBinsert\fR \fIpos\fR \fIsubwindow\fR \fIoptions...\fR
d81 1
a81 1
\fIpos\fR is either the string \fBend\fR, an integer index, 
d83 1
a83 1
If \fIsubwindow\fR is already managed by the paned window, 
d87 1
a87 1
\fIpathname \fBpane\fR \fIpane \-option \fR?\fIvalue \fR?\fI\-option value...\fR
d90 1
a90 1
If no \fI\-option\fR is specified, returns a dictionary of the pane 
d95 3
d99 1
a99 1
If \fInewpos\fR is specified, sets the position 
d103 1
a103 1
Sash positions are further constrained to be between 0 
@


1.18
log
@Fix [Bug 2118116]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.17 2008/06/30 22:57:03 dkf Exp $
a60 1
\fIsubwindow\fR must be a direct child of the paned window \fIpathname\fR.
@


1.17
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.16 2008/05/09 18:35:00 patthoyts Exp $
d102 3
@


1.16
log
@Document the identify command as present on all ttk widgets
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.15 2008/01/29 15:38:00 dkf Exp $
d24 1
d48 1
d55 1
@


1.15
log
@Adjusted handling of the standard options part of the Ttk manual pages so
that they are documented in the correct location. [Bug 1876493]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.14 2007/12/13 15:23:44 dgp Exp $
d65 4
a96 4
.TP
\fIpathname\fR \fBidentify\fR \fIx y\fR
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
@


1.15.2.1
log
@Backported documentation fixes from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.16 2008/05/09 18:35:00 patthoyts Exp $
a64 4
\fIpathname\fR \fBidentify\fR \fIx y\fR
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
.TP
d93 4
@


1.15.2.2
log
@        Major backport of 8.6 Ttk for 8.5.9.  Most changes were only being
        committed to head (8.6), although they could apply for 8.5 as well.
        This re-sync makes future work easier to maintain and adds some
        useful work for 8.5 users. Notable changes:
        - Lots of code cleanup
        - Some bug fixes never backported
        - Addition of ttk::spinbox
        - minor color changes
        - Improved Vista/7 styling
        - Move to tile version 0.8.6 (pseudo-package)
        - ABI and API compatible (even $w identify)
        - minor new features (extended $w identify)
@
text
@d6 3
a8 3
'\"
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.20 2009/11/01 18:12:44 jenglish Exp $
'\"
d10 1
a10 1
.TH ttk::panedwindow n 8.5.9 Tk "Tk Themed Widget"
d16 1
a16 1
\fBttk::panedwindow\fR \fIpathname \fR?\fIoptions\fR?
d18 2
a19 2
\fIpathname \fBadd\fR \fIwindow\fR ?\fIoptions...\fR?
\fIpathname \fBinsert\fR \fIindex\fR \fIwindow\fR ?\fIoptions...\fR?
d23 3
a25 4
A \fBttk::panedwindow\fR 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.
d36 1
a36 1
If present and greater than zero,
d41 1
a41 1
If present and greater than zero,
d52 1
a52 1
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR,
d56 1
a56 1
\fIpathname\fR \fBadd\fR \fIsubwindow\fR \fIoptions...\fR
d58 1
d61 1
a61 1
\fIpathname\fR \fBforget\fR \fIpane\fR
d65 3
a67 13
\fIpathname\fR \fBidentify\fR \fIcomponent\fR \fIx\fR \fIy\fR
Returns the name of the element under the point given by \fIx\fR and \fIy\fR,
or the empty string if no component is present at that location.
If \fIcomponent\fR is omitted, it defaults to \fBsash\fR.
The following subcommands are supported:
.RS
.TP
\fIpathname\fR \fBidentify\fR \fBelement\fR \fIx\fR \fIy\fR
Returns the name of the element at the specified location.
.TP
\fIpathname\fR \fBidentify\fR \fBsash\fR \fIx\fR \fIy\fR
Returns the index of the sash at the specified location.
.RE
d69 1
a69 1
\fIpathname\fR \fBinsert\fR \fIpos\fR \fIsubwindow\fR \fIoptions...\fR
d71 1
a71 1
\fIpos\fR is either the string \fBend\fR, an integer index,
d73 1
a73 1
If \fIsubwindow\fR is already managed by the paned window,
d77 1
a77 1
\fIpathname\fR \fBpane\fR \fIpane \-option \fR?\fIvalue \fR?\fI\-option value...\fR
d80 1
a80 1
If no \fI\-option\fR is specified, returns a dictionary of the pane
a84 3
\fIpathname\fR \fBpanes\fR
Returns the list of all windows managed by the widget.
.TP
d86 1
a86 1
If \fInewpos\fR is specified, sets the position
d90 1
a90 1
Sash positions are further constrained to be between 0
a98 3
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.14
log
@merge stable branch onto HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4.2.5 2007/12/13 06:28:47 dgp Exp $
d26 3
a28 2
.SO
\-class	\-cursor	\-takefocus	\-style
@


1.13
log
@Various minor updates to ttk_* manpages.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.12 2007/11/01 10:59:43 dkf Exp $
@


1.12
log
@Make documentation use the name that scripts use as much as possible.
[Bug 1640073]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.11 2007/10/30 21:29:59 dkf Exp $
d18 2
a19 2
\fIpathName \fBadd\fR \fIpathName.subwindow\fR ?\fIoptions...\fR?
\fIpathName \fBinsert\fR \fIindex\fR \fIpathName.subwindow\fR ?\fIoptions...\fR?
@


1.11
log
@More documentation improvements
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.10 2007/10/29 16:04:14 dkf Exp $
d10 1
a10 1
.TH ttk_panedwindow n 8.5 Tk "Tk Themed Widget"
a11 1
.\" Use _ instead of :: as the name becomes a filename on install
d13 1
a13 1
ttk_panedwindow \- Multi-pane container window
d52 1
a52 1
and \fBinstate\fR commands; see \fIttk_widget(n)\fR for details.
d97 1
a97 1
ttk_widget(n), ttk_notebook(n), panedwindow(n)
@


1.10
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.9 2007/10/26 20:13:23 dgp Exp $
a22 1

a29 1

a44 1

a50 1

a96 1

@


1.9
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.6 2007/06/10 03:25:32 jenglish Exp $
d53 1
a53 1
or subtracted to each pane proportionally to its \fB-weight\fR.
d77 1
a77 1
\fIpathname \fBpane\fR \fIpane -option \fR?\fIvalue \fR?\fI-option value...\fR
d80 1
a80 1
If no \fI-option\fR is specified, returns a dictionary of the pane 
d82 2
a83 2
If one \fI-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI-option\fRs to the corresponding \fIvalue\fRs.
@


1.8
log
@Rendering-with-groff GOOBE.
@
text
@d6 3
a8 3
'\"
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.7 2007/10/22 14:33:13 dkf Exp $
'\"
d18 1
a18 1

d26 2
a27 2
either vertically or horizontally. The user may adjust the relative sizes of
the subwindows by dragging the sash between panes.
d29 1
a29 2
\-class	\-cursor	\-style
\-takefocus
d31 1
d34 3
a36 3
Specifies the orientation of the window. If \fBvertical\fR, subpanes are
stacked top-to-bottom; if \fBhorizontal\fR, subpanes are stacked
left-to-right.
d38 4
a41 3
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.
d43 5
a47 3
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.
d51 4
a54 3
An integer specifying the relative stretchability of the pane. When the paned
window is resized, the extra space is added or subtracted to each pane
proportionally to its \fB\-weight\fR.
d56 3
a58 3
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, and
\fBinstate\fR commands; see \fIttk_widget(n)\fR for details. Additional
commands:
d61 3
a63 4
.
Adds a new pane to the window. \fIsubwindow\fR must be a direct child of the
paned window \fIpathname\fR. See \fBPANE OPTIONS\fR for the list of available
options.
d66 2
a67 3
.
Removes the specified subpane from the widget. \fIpane\fR is either an integer
index or the name of a managed subwindow.
d70 6
a75 5
.
Inserts a pane at the specified position. \fIpos\fR is either the string
\fBend\fR, an integer index, or the name of a managed subwindow. If
\fIsubwindow\fR is already managed by the paned window, moves it to the
specified position. See \fBPANE OPTIONS\fR for the list of available options.
d78 6
a83 6
.
Query or modify the options of the specified \fIpane\fR, where \fIpane\fR is
either an integer index or the name of a managed subwindow. If no
\fI\-option\fR is specified, returns a dictionary of the pane option values.
If one \fI\-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI\-option\fRs to the corresponding \fIvalue\fRs.
d86 6
a91 8
.
If \fInewpos\fR is unspecified, returns the current position of sash number
\fIindex\fR. If \fInewpos\fR is specified, sets the position of sash number
\fIindex\fR, with the aim of making \fInewpos\fR its new position. 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; these may mean that the actual new sash position is
not what was requested.
d96 1
d99 3
a101 3
.
Returns the index of the sash at point \fIx,y\fR, or the empty string if
\fIx,y\fR is not over a sash.
@


1.7
log
@Documentation improvements, all minor.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.6 2007/06/10 03:25:32 jenglish Exp $
d18 1
a18 1
.br
d29 2
a30 1
\-class	\-cursor	\-takefocus	\-style
a31 1

a44 1

a50 1

a99 1

@


1.6
log
@Added -width and -height options.
Added 'panes' method, return list of managed windows.
'sashpos' method is now documented as part of the public interface,
and details clarified.
Should be easier to set initial sash positions now [Alleviates #1659067].
@
text
@d6 3
a8 3
'\" 
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.5 2007/06/09 21:45:44 jenglish Exp $
'\" 
d26 2
a27 2
either vertically or horizontally.  The user may adjust the relative sizes
of the subwindows by dragging the sash between panes.
d34 3
a36 3
Specifies the orientation of the window.
If \fBvertical\fR, subpanes are stacked top-to-bottom;
if \fBhorizontal\fR, subpanes are stacked left-to-right.
d38 3
a40 4
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.
d42 3
a44 4
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.
d49 3
a51 3
An integer specifying the relative stretchability of the pane.
When the paned window is resized, the extra space is added
or subtracted to each pane proportionally to its \fB-weight\fR.
d54 3
a56 3
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, 
and \fBinstate\fR commands; see \fIttk_widget(n)\fR for details.
Additional commands:
d59 4
a62 3
Adds a new pane to the window.
\fIsubwindow\fR must be a direct child of the paned window \fIpathname\fR.
See \fBPANE OPTIONS\fR for the list of available options.
d65 3
a67 2
Removes the specified subpane from the widget.
\fIpane\fR is either an integer index or the name of a managed subwindow.
d70 5
a74 6
Inserts a pane at the specified position.
\fIpos\fR is either the string \fBend\fR, an integer index, 
or the name of a managed subwindow.
If \fIsubwindow\fR is already managed by the paned window, 
moves it to the specified position.
See \fBPANE OPTIONS\fR for the list of available options.
d77 6
a82 6
Query or modify the options of the specified \fIpane\fR,
where \fIpane\fR is either an integer index or the name of a managed subwindow.
If no \fI-option\fR is specified, returns a dictionary of the pane 
option values.
If one \fI-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI-option\fRs to the corresponding \fIvalue\fRs.
d85 8
a92 6
If \fInewpos\fR is specified, sets the position 
of sash number \fIindex\fR.
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.
a96 1
.\" Full story: new position may be different than the requested position.
d99 3
a101 2
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
@


1.5
log
@Ttk_Manager API overhaul:
    + Ttk_Manager no longer responsible for managing slave records
    + Ttk_Manager structure now opaque
    + Ttk_Slave structure now private
    + Pass Ttk_Manager * to Tk_GeomMgr hooks instead of Ttk_Slave *
ttk::labelframe: Simplified -labelwidget management.
ttk::noteboook 'insert' command didn't correctly maintain current tab.
Changed documentation of ttk::panedwindow 'identify' command to
match implementation.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4 2007/05/03 23:55:30 dkf Exp $
d37 10
a83 4

.SH "INTERNAL ROUTINES"
The following routines are used internally by the \fBpaned\fR widget
binding code.
d86 11
a96 3
If \fInewpos\fR is specified, sets the sash position 
(subject to constraints).
Returns the position of sash number \fIindex\fR.
@


1.4
log
@Spelling fixes. [Bug 1686210]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
d85 2
a86 3
Returns a list consisting of the sash index at point \fIx,y\fR
and the name of the sash subelement at that point.
Returns the empty list if \fIx,y\fR is not over a sash.
@


1.4.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4 2007/05/03 23:55:30 dkf Exp $
a36 10
.OP \-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.
.OP \-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.
d74 4
d80 3
a82 11
If \fInewpos\fR is specified, sets the position 
of sash number \fIindex\fR.
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.
.\" Full story: "total size" is either the -height (resp -width),
.\" or the actual window height (resp actual window width),
.\" depending on which changed most recently.
Returns the new position of sash number \fIindex\fR.
.\" Full story: new position may be different than the requested position.
d85 3
a87 2
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
@


1.4.2.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4.2.1 2007/06/12 16:22:40 dgp Exp $
d18 1
a18 1

d26 2
a27 2
either vertically or horizontally. The user may adjust the relative sizes of
the subwindows by dragging the sash between panes.
d29 1
a29 2
\-class	\-cursor	\-style
\-takefocus
d31 1
d34 3
a36 3
Specifies the orientation of the window. If \fBvertical\fR, subpanes are
stacked top-to-bottom; if \fBhorizontal\fR, subpanes are stacked
left-to-right.
d38 4
a41 3
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.
d43 5
a47 3
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.
d51 4
a54 3
An integer specifying the relative stretchability of the pane. When the paned
window is resized, the extra space is added or subtracted to each pane
proportionally to its \fB\-weight\fR.
d56 3
a58 3
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, and
\fBinstate\fR commands; see \fIttk_widget(n)\fR for details. Additional
commands:
d61 3
a63 4
.
Adds a new pane to the window. \fIsubwindow\fR must be a direct child of the
paned window \fIpathname\fR. See \fBPANE OPTIONS\fR for the list of available
options.
d66 2
a67 3
.
Removes the specified subpane from the widget. \fIpane\fR is either an integer
index or the name of a managed subwindow.
d70 6
a75 5
.
Inserts a pane at the specified position. \fIpos\fR is either the string
\fBend\fR, an integer index, or the name of a managed subwindow. If
\fIsubwindow\fR is already managed by the paned window, moves it to the
specified position. See \fBPANE OPTIONS\fR for the list of available options.
d78 6
a83 6
.
Query or modify the options of the specified \fIpane\fR, where \fIpane\fR is
either an integer index or the name of a managed subwindow. If no
\fI\-option\fR is specified, returns a dictionary of the pane option values.
If one \fI\-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI\-option\fRs to the corresponding \fIvalue\fRs.
d86 6
a91 8
.
If \fInewpos\fR is unspecified, returns the current position of sash number
\fIindex\fR. If \fInewpos\fR is specified, sets the position of sash number
\fIindex\fR, with the aim of making \fInewpos\fR its new position. 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; these may mean that the actual new sash position is
not what was requested.
d96 1
d99 3
a101 3
.
Returns the index of the sash at point \fIx,y\fR, or the empty string if
\fIx,y\fR is not over a sash.
@


1.4.2.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4.2.2 2007/10/24 12:59:31 dgp Exp $
d18 1
a18 1
.br
d26 2
a27 2
either vertically or horizontally.  The user may adjust the relative sizes
of the subwindows by dragging the sash between panes.
d29 2
a30 1
\-class	\-cursor	\-takefocus	\-style
a31 1

d34 3
a36 3
Specifies the orientation of the window.
If \fBvertical\fR, subpanes are stacked top-to-bottom;
if \fBhorizontal\fR, subpanes are stacked left-to-right.
d38 3
a40 4
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.
d42 3
a44 5
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.

d48 3
a50 4
An integer specifying the relative stretchability of the pane.
When the paned window is resized, the extra space is added
or subtracted to each pane proportionally to its \fB-weight\fR.

d52 3
a54 3
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, 
and \fBinstate\fR commands; see \fIttk_widget(n)\fR for details.
Additional commands:
d57 4
a60 3
Adds a new pane to the window.
\fIsubwindow\fR must be a direct child of the paned window \fIpathname\fR.
See \fBPANE OPTIONS\fR for the list of available options.
d63 3
a65 2
Removes the specified subpane from the widget.
\fIpane\fR is either an integer index or the name of a managed subwindow.
d68 5
a72 6
Inserts a pane at the specified position.
\fIpos\fR is either the string \fBend\fR, an integer index, 
or the name of a managed subwindow.
If \fIsubwindow\fR is already managed by the paned window, 
moves it to the specified position.
See \fBPANE OPTIONS\fR for the list of available options.
d75 6
a80 6
Query or modify the options of the specified \fIpane\fR,
where \fIpane\fR is either an integer index or the name of a managed subwindow.
If no \fI-option\fR is specified, returns a dictionary of the pane 
option values.
If one \fI-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI-option\fRs to the corresponding \fIvalue\fRs.
d83 8
a90 6
If \fInewpos\fR is specified, sets the position 
of sash number \fIindex\fR.
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.
a94 1
.\" Full story: new position may be different than the requested position.
d97 3
a99 3
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.

@


1.4.2.4
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d10 1
a10 1
.TH ttk::panedwindow n 8.5 Tk "Tk Themed Widget"
d12 1
d14 1
a14 1
ttk::panedwindow \- Multi-pane container window
d23 1
d31 1
d47 1
d53 2
a54 1
or subtracted to each pane proportionally to its \fB\-weight\fR.
d57 1
a57 1
and \fBinstate\fR commands; see \fIttk::widget(n)\fR for details.
d77 1
a77 1
\fIpathname \fBpane\fR \fIpane \-option \fR?\fIvalue \fR?\fI\-option value...\fR
d80 1
a80 1
If no \fI\-option\fR is specified, returns a dictionary of the pane 
d82 2
a83 2
If one \fI\-option\fR is specified, returns the value of that \fIoption\fR.
Otherwise, sets the \fI\-option\fRs to the corresponding \fIvalue\fRs.
d101 1
d103 1
a103 1
ttk::widget(n), ttk::notebook(n), panedwindow(n)
@


1.4.2.5
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4.2.4 2007/11/01 16:37:16 dgp Exp $
d18 2
a19 2
\fIpathName \fBadd\fR \fIwindow\fR ?\fIoptions...\fR?
\fIpathName \fBinsert\fR \fIindex\fR \fIwindow\fR ?\fIoptions...\fR?
@


1.4.2.6
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.14 2007/12/13 15:23:44 dgp Exp $
d26 2
a27 3
.SO ttk_widget
\-class	\-cursor	\-takefocus
\-style
@


1.4.2.7
log
@merge updates from 8.5 branch
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_panedwindow.n,v 1.4.2.6 2008/01/29 17:35:50 dgp Exp $
a64 4
\fIpathname\fR \fBidentify\fR \fIx y\fR
Returns the index of the sash at point \fIx,y\fR,
or the empty string if \fIx,y\fR is not over a sash.
.TP
d93 4
@


1.3
log
@	* unix/Makefile.in (install-doc): intentionally skip ttk_dialog.n
	installation (not for public consumption)

	* doc/scrollbar.n, doc/button.n, doc/checkbutton.n:
	* doc/entry.n, doc/frame.n, doc/label.n, doc/labelframe.n:
	* doc/menu.n, doc/menubutton.n, doc/panedwindow.n:
	* doc/radiobutton.n, doc/scrollbar.n, doc/ttk_*: revamp ttk docs
	to use consist nroff format (not 100% consistent with classic
	widget docs).  Add more man page cross-linking "SEE ALSO".
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: popup.n,v 1.4 2004/06/21 20:59:29 dkf Exp $
d43 1
a43 1
or subracted to each pane proportionally to its \fB-weight\fR.
@


1.2
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d1 1
a1 1
'\" $Id: ttk_panedwindow.n,v 1.1 2006/10/31 01:42:25 hobbs Exp $
d3 6
d12 3
a14 2
.SH "NAME"
ttk::panedwindow \- Multi-pane container window
d23 5
a27 5
.SH "DESCRIPTION"
A paned 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.
d31 2
a32 1
.SH "WIDGET OPTIONS"
d37 1
d44 1
d47 1
a47 1
and \fBinstate\fR commands; see \fIwidget(n)\fR for details.
d74 1
d88 1
d90 1
a90 1
\fIwidget(n)\fR, \fInotebook(n)\fR.
@


1.1
log
@	* doc/ttk_Geometry.3, doc/ttk_Theme.3, doc/ttk_button.n:
	* doc/ttk_checkbutton.n, doc/ttk_combobox.n, doc/ttk_dialog.n:
	* doc/ttk_entry.n, doc/ttk_frame.n, doc/ttk_image.n:
	* doc/ttk_intro.n, doc/ttk_label.n, doc/ttk_labelframe.n:
	* doc/ttk_menubutton.n, doc/ttk_notebook.n, doc/ttk_panedwindow.n:
	* doc/ttk_progressbar.n, doc/ttk_radiobutton.n, doc/ttk_scrollbar.n:
	* doc/ttk_separator.n, doc/ttk_sizegrip.n, doc/ttk_style.n:
	* doc/ttk_treeview.n, doc/ttk_widget.n,:
	* generic/ttk/ttk.decls, generic/ttk/ttkBlink.c:
	* generic/ttk/ttkButton.c, generic/ttk/ttkCache.c:
	* generic/ttk/ttkClamTheme.c, generic/ttk/ttkClassicTheme.c:
	* generic/ttk/ttkDecls.h, generic/ttk/ttkDefaultTheme.c:
	* generic/ttk/ttkElements.c, generic/ttk/ttkEntry.c:
	* generic/ttk/ttkFrame.c, generic/ttk/ttkImage.c:
	* generic/ttk/ttkInit.c, generic/ttk/ttkLabel.c:
	* generic/ttk/ttkLayout.c, generic/ttk/ttkManager.c:
	* generic/ttk/ttkManager.h, generic/ttk/ttkNotebook.c:
	* generic/ttk/ttkPanedwindow.c, generic/ttk/ttkProgress.c:
	* generic/ttk/ttkScale.c, generic/ttk/ttkScroll.c:
	* generic/ttk/ttkScrollbar.c, generic/ttk/ttkSeparator.c:
	* generic/ttk/ttkSquare.c, generic/ttk/ttkState.c:
	* generic/ttk/ttkStubInit.c, generic/ttk/ttkStubLib.c:
	* generic/ttk/ttkTagSet.c, generic/ttk/ttkTheme.c:
	* generic/ttk/ttkTheme.h, generic/ttk/ttkThemeInt.h:
	* generic/ttk/ttkTrace.c, generic/ttk/ttkTrack.c:
	* generic/ttk/ttkTreeview.c, generic/ttk/ttkWidget.c:
	* generic/ttk/ttkWidget.h:
	* library/demos/ttk_demo.tcl, library/demos/ttk_iconlib.tcl:
	* library/demos/ttk_repeater.tcl:
	* library/ttk/altTheme.tcl, library/ttk/aquaTheme.tcl:
	* library/ttk/button.tcl, library/ttk/clamTheme.tcl:
	* library/ttk/classicTheme.tcl, library/ttk/combobox.tcl:
	* library/ttk/cursors.tcl, library/ttk/defaults.tcl:
	* library/ttk/dialog.tcl, library/ttk/entry.tcl:
	* library/ttk/fonts.tcl, library/ttk/icons.tcl:
	* library/ttk/keynav.tcl, library/ttk/menubutton.tcl:
	* library/ttk/notebook.tcl, library/ttk/panedwindow.tcl:
	* library/ttk/progress.tcl, library/ttk/scale.tcl:
	* library/ttk/scrollbar.tcl, library/ttk/sizegrip.tcl:
	* library/ttk/treeview.tcl, library/ttk/ttk.tcl:
	* library/ttk/utils.tcl, library/ttk/winTheme.tcl:
	* library/ttk/xpTheme.tcl:
	* macosx/ttkMacOSXTheme.c:
	* tests/ttk/all.tcl, tests/ttk/bwidget.test, tests/ttk/combobox.test:
	* tests/ttk/entry.test, tests/ttk/image.test:
	* tests/ttk/labelframe.test, tests/ttk/layout.test:
	* tests/ttk/misc.test, tests/ttk/notebook.test:
	* tests/ttk/panedwindow.test, tests/ttk/progressbar.test:
	* tests/ttk/scrollbar.test, tests/ttk/treetags.test:
	* tests/ttk/treeview.test, tests/ttk/ttk.test, tests/ttk/validate.test:
	* win/ttkWinMonitor.c, win/ttkWinTheme.c, win/ttkWinXPTheme.c:
	First import of Ttk themed Tk widgets as branched from tile 0.7.8

	* generic/tkInt.h, generic/tkWindow.c: add Ttk_Init call, copy
	tk classic widgets to ::tk namespace.
	* library/tk.tcl: add source of ttk/ttk.tcl, define $::ttk::library.
	* unix/Makefile.in, win/Makefile.in: add Ttk build bits
	* win/configure, win/configure.in: check for uxtheme.h (XP theme).
@
text
@d1 1
a1 1
'\" $Id: paned.n,v 1.2 2005/12/07 23:53:23 jenglish Exp $
d27 2
a28 2
If \fBvertical\fP, subpanes are stacked top-to-bottom;
if \fBhorizontal\fP, subpanes are stacked left-to-right.
d34 1
a34 1
or subracted to each pane proportionally to its \fB-weight\fP.
d36 1
a36 1
Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fP, 
d62 1
a62 1
If one \fI-option\fP is specified, returns the value of that \fIoption\fR.
@

