diff options
Diffstat (limited to 'doc/ttk_panedwindow.n')
-rw-r--r-- | doc/ttk_panedwindow.n | 106 |
1 files changed, 54 insertions, 52 deletions
diff --git a/doc/ttk_panedwindow.n b/doc/ttk_panedwindow.n index e9befb6..b0adaa6 100644 --- a/doc/ttk_panedwindow.n +++ b/doc/ttk_panedwindow.n @@ -3,9 +3,9 @@ '\" '\" 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.8 2007/10/23 15:44:36 dkf Exp $ -'\" +'\" +'\" RCS: @(#) $Id: ttk_panedwindow.n,v 1.9 2007/10/26 20:13:23 dgp Exp $ +'\" .so man.macros .TH ttk_panedwindow n 8.5 Tk "Tk Themed Widget" .BS @@ -15,7 +15,7 @@ ttk_panedwindow \- Multi-pane container window .SH SYNOPSIS .nf \fBttk::panedwindow\fR \fIpathName \fR?\fIoptions\fR? - +.br \fIpathName \fBadd\fR \fIpathName.subwindow\fR ?\fIoptions...\fR? \fIpathName \fBinsert\fR \fIindex\fR \fIpathName.subwindow\fR ?\fIoptions...\fR? .fi @@ -23,79 +23,81 @@ ttk_panedwindow \- Multi-pane container window .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. +either vertically or horizontally. The user may adjust the relative sizes +of the subwindows by dragging the sash between panes. .SO -\-class \-cursor \-style -\-takefocus +\-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. +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. +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. +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. +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: +Supports the standard \fBconfigure\fR, \fBcget\fR, \fBstate\fR, +and \fBinstate\fR commands; see \fIttk_widget(n)\fR for details. +Additional commands: .TP \fIpathname \fBadd\fR \fIsubwindow\fR \fIoptions...\fR -. -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. +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. .TP \fIpathname \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. +Removes the specified subpane from the widget. +\fIpane\fR is either an integer index or the name of a managed subwindow. .TP \fIpathname \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. +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 \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. +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 \fBsashpos\fR \fIindex\fR ?\fInewpos\fR? -. -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. +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. .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. +Returns the index of the sash at point \fIx,y\fR, +or the empty string if \fIx,y\fR is not over a sash. + .SH "SEE ALSO" ttk_widget(n), ttk_notebook(n), panedwindow(n) |