summaryrefslogtreecommitdiffstats
path: root/doc/ttk_notebook.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2007-10-23 15:44:35 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2007-10-23 15:44:35 (GMT)
commit620c50bb12c97692f525d2b46aa33bd6f36835b8 (patch)
tree5eda8228f68eff81bf0c9d40d5b70ae6d20b6d5e /doc/ttk_notebook.n
parent7cfd88386b38d33b8f0d92c874016a163c2646d2 (diff)
downloadtk-620c50bb12c97692f525d2b46aa33bd6f36835b8.zip
tk-620c50bb12c97692f525d2b46aa33bd6f36835b8.tar.gz
tk-620c50bb12c97692f525d2b46aa33bd6f36835b8.tar.bz2
Rendering-with-groff GOOBE.
Diffstat (limited to 'doc/ttk_notebook.n')
-rw-r--r--doc/ttk_notebook.n179
1 files changed, 84 insertions, 95 deletions
diff --git a/doc/ttk_notebook.n b/doc/ttk_notebook.n
index 18459d4..a677443 100644
--- a/doc/ttk_notebook.n
+++ b/doc/ttk_notebook.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: ttk_notebook.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
+'\" RCS: @(#) $Id: ttk_notebook.n,v 1.4 2007/10/23 15:44:36 dkf Exp $
'\"
.so man.macros
.TH ttk_notebook n 8.5 Tk "Tk Themed Widget"
@@ -13,170 +13,161 @@
.SH NAME
ttk_notebook \- Multi-paned container widget
.SH SYNOPSIS
+.nf
\fBttk::notebook\fR \fIpathName \fR?\fIoptions\fR?
-.br
+
\fIpathName \fBadd\fR \fIpathName\fR.\fIsubwindow\fR ?\fIoptions...\fR?
\fIpathName \fBinsert\fR \fIindex\fR \fIpathName\fR.\fIsubwindow\fR ?\fIoptions...\fR?
+.fi
.BE
.SH DESCRIPTION
-A \fBttk::notebook\fR widget manages a collection of subpanes
-and displays a single one at a time.
-Each pane is associated with a tab, which the user
-may select to change the currently-displayed pane.
+A \fBttk::notebook\fR widget manages a collection of subpanes and displays a
+single one at a time. Each pane is associated with a tab, which the user may
+select to change the currently-displayed pane.
.SO
-\-class \-cursor \-takefocus \-style
+\-class \-cursor \-style
+\-takefocus
.SE
-
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-height height Height
-If present and greater than zero,
-specifies the desired height of the pane area
-(not including internal padding or tabs).
-Otherwise, the maximum height of all panes is used.
+If present and greater than zero, specifies the desired height of the pane
+area (not including internal padding or tabs). Otherwise, the maximum height
+of all panes is used.
.OP \-padding padding Padding
-Specifies the amount of extra space to add around the outside
-of the notebook.
-The padding is a list of up to four length specifications
-\fIleft top right bottom\fR.
-If fewer than four elements are specified,
-\fIbottom\fR defaults to \fItop\fR,
-\fIright\fR defaults to \fIleft\fR, and
-\fItop\fR defaults to \fIleft\fR.
+Specifies the amount of extra space to add around the outside of the notebook.
+The padding is a list of up to four length specifications \fIleft top right
+bottom\fR. If fewer than four elements are specified, \fIbottom\fR defaults to
+\fItop\fR, \fIright\fR defaults to \fIleft\fR, and \fItop\fR defaults to
+\fIleft\fR.
.OP \-width width Width
-If present and greater than zero,
-specifies the desired width of the pane area
-(not including internal padding).
-Otherwise, the maximum width of all panes is used.
+If present and greater than zero, specifies the desired width of the pane area
+(not including internal padding). Otherwise, the maximum width of all panes is
+used.
.SH "TAB OPTIONS"
The following options may be specified for individual notebook panes:
.OP \-state state State
-Either \fBnormal\fR, \fBdisabled\fR or \fBhidden\fR.
-If \fBdisabled\fR, then the tab is not selectable. If \fBhidden\fR,
-then the tab is not shown.
+Either \fBnormal\fR, \fBdisabled\fR or \fBhidden\fR. If \fBdisabled\fR, then
+the tab is not selectable. If \fBhidden\fR, then the tab is not shown.
.OP \-sticky sticky Sticky
-Specifies how the child pane is positioned within the pane area.
-Value is a string containing zero or more of the characters
-\fBn, s, e,\fR or \fBw\fR.
-Each letter refers to a side (north, south, east, or west)
-that the child window will "stick" to,
-as per the \fBgrid\fR geometry manager.
+Specifies how the child pane is positioned within the pane area. Value is a
+string containing zero or more of the characters \fBn, s, e,\fR or \fBw\fR.
+Each letter refers to a side (north, south, east, or west) that the child
+window will "stick" to, as per the \fBgrid\fR geometry manager.
.OP \-padding padding Padding
Specifies the amount of extra space to add between the notebook and this pane.
-Syntax is the same as for the widget \fB-padding\fR option.
+Syntax is the same as for the widget \fB\-padding\fR option.
.OP \-text text Text
Specifies a string to be displayed in the tab.
.OP \-image image Image
-Specifies an image to display in the tab,
-which must have been created with the \fBimage create\fR command.
+Specifies an image to display in the tab, which must have been created with
+the \fBimage create\fR command.
.OP \-compound compound Compound
-Specifies how to display the image relative to the text,
-in the case both \fB-text\fR and \fB-image\fR are present.
-See \fIlabel(n)\fR for legal values.
+Specifies how to display the image relative to the text, in the case both
+\fB\-text\fR and \fB\-image\fR are present. See \fIlabel(n)\fR for legal
+values.
.OP \-underline underline Underline
-Specifies the integer index (0-based) of a character to underline
-in the text string.
-The underlined character is used for mnemonic activation
-if \fBttk::notebook::enableTraversal\fR is called.
-
+Specifies the integer index (0-based) of a character to underline in the text
+string. The underlined character is used for mnemonic activation if
+\fBttk::notebook::enableTraversal\fR is called.
.SH "WIDGET COMMAND"
.TP
\fIpathname \fBadd \fIchild\fR ?\fIoptions...\fR?
-Adds a new tab to the notebook.
-When the tab is selected, the \fIchild\fR window
-will be displayed.
-\fIchild\fR must be a direct child of the notebook window.
-See \fBTAB OPTIONS\fR for the list of available \fIoptions\fR.
+.
+Adds a new tab to the notebook. When the tab is selected, the \fIchild\fR
+window will be displayed. \fIchild\fR must be a direct child of the notebook
+window. See \fBTAB OPTIONS\fR for the list of available \fIoptions\fR.
.TP
\fIpathname \fBconfigure\fR ?\fIoptions\fR?
+.
See \fIttk_widget(n)\fR.
.TP
\fIpathname \fBcget\fR \fIoption\fR
+.
See \fIttk_widget(n)\fR.
.TP
\fIpathname \fBforget\fR \fItabid\fR
-Removes the tab specified by \fItabid\fR,
-unmaps and unmanages the associated child window.
+.
+Removes the tab specified by \fItabid\fR, unmaps and unmanages the associated
+child window.
.TP
\fIpathname \fBindex\fR \fItabid\fR
-Returns the numeric index of the tab specified by \fItabid\fR,
-or the total number of tabs if \fItabid\fR is the string "\fBend\fR".
+.
+Returns the numeric index of the tab specified by \fItabid\fR, or the total
+number of tabs if \fItabid\fR is the string "\fBend\fR".
.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 notebook,
-moves it to the specified position.
-See \fBTAB 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 notebook, moves it to the specified
+position. See \fBTAB OPTIONS\fR for the list of available options.
.TP
\fIpathname \fBinstate\fR \fIstatespec \fR?\fIscript...\fR?
+.
See \fIttk_widget(n)\fR.
.TP
\fIpathname \fBselect\fR ?\fItabid\fR?
-Selects the specified tab. The associated child pane will be displayed,
-and the previously-selected pane (if different) is unmapped.
-If \fItabid\fR is omitted, returns the widget name of the
-currently selected pane.
+.
+Selects the specified tab. The associated child pane will be displayed, and
+the previously-selected pane (if different) is unmapped. If \fItabid\fR is
+omitted, returns the widget name of the currently selected pane.
.TP
\fIpathname \fBstate\fR ?\fIstatespec\fR?
+.
See \fIttk_widget(n)\fR.
.TP
-\fIpathname \fBtab\fR \fItabid\fR ?\fI-options \fR?\fIvalue ...\fR
-Query or modify the options of the specific tab.
-If no \fI-option\fR is specified, returns a dictionary of the tab 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.
-See \fBTAB OPTIONS\fR for the available options.
+\fIpathname \fBtab\fR \fItabid\fR ?\fI\-options \fR?\fIvalue ...\fR
+.
+Query or modify the options of the specific tab. If no \fI\-option\fR is
+specified, returns a dictionary of the tab 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. See
+\fBTAB OPTIONS\fR for the available options.
.TP
\fIpathname \fBtabs\fR
+.
Returns a list of all windows managed by the widget.
.\" Perhaps "panes" is a better name for this command?
-
.SH "KEYBOARD TRAVERSAL"
-To enable keyboard traversal for a toplevel window
-containing a notebook widget \fI$nb\fR, call:
+To enable keyboard traversal for a toplevel window containing a notebook
+widget \fI$nb\fR, call:
.CS
ttk::notebook::enableTraversal $nb
.CE
.PP
-This will extend the bindings for the toplevel widget
-containing the notebook as follows:
+This will extend the bindings for the toplevel widget containing the notebook
+as follows:
.IP \(bu
\fBControl-Tab\fR selects the tab following the currently selected one.
.IP \(bu
\fBShift-Control-Tab\fR selects the tab preceding the currently selected one.
.IP \(bu
-\fBAlt-K\fR, where \fBK\fR is the mnemonic (underlined) character
-of any tab, will select that tab.
+\fBAlt-K\fR, where \fBK\fR is the mnemonic (underlined) character of any tab,
+will select that tab.
.PP
Multiple notebooks in a single toplevel may be enabled for traversal,
-including nested notebooks.
-However, notebook traversal only works properly if all panes
-are direct children of the notebook.
-
+including nested notebooks. However, notebook traversal only works properly if
+all panes are direct children of the notebook.
.SH "TAB IDENTIFIERS"
-The \fItabid\fR argument to the above commands may take
-any of the following forms:
+The \fItabid\fR argument to the above commands may take any of the following
+forms:
.IP \(bu
An integer between zero and the number of tabs;
.IP \(bu
The name of a child pane window;
.IP \(bu
-A positional specification of the form "@\fIx\fR,\fIy\fR",
-which identifies the tab
+A positional specification of the form "@\fIx\fR,\fIy\fR", which identifies
+the tab
.IP \(bu
-The literal string "\fBcurrent\fR",
-which identifies the currently-selected tab; or:
+The literal string "\fBcurrent\fR", which identifies the currently-selected
+tab; or:
.IP \(bu
-The literal string "\fBend\fR",
-which returns the number of tabs
-(only valid for "\fIpathname \fBindex\fR").
-
+The literal string "\fBend\fR", which returns the number of tabs (only valid
+for "\fIpathname \fBindex\fR").
.SH "VIRTUAL EVENTS"
-The notebook widget generates a \fB<<NotebookTabChanged>>\fR
-virtual event after a new tab is selected.
-
+The notebook widget generates a \fB<<NotebookTabChanged>>\fR virtual event
+after a new tab is selected.
.SH "EXAMPLE"
.CS
notebook .nb
@@ -185,9 +176,7 @@ notebook .nb
\.nb select .nb.f2
ttk::notebook::enableTraversal .nb
.CE
-
.SH "SEE ALSO"
ttk_widget(n), grid(n)
-
.SH "KEYWORDS"
pane, tab