|
|
|
|
|
|
<TITLE>tixListNoteBook - Create and manipulate tixListNoteBook widgets</TITLE>
|
<TITLE>tixListNoteBook - Create and manipulate tixListNoteBook widgets</TITLE>
|
<Center><H2>tixListNoteBook - Create and manipulate tixListNoteBook widgets</H2></Center><hr>
|
<Center><H2>tixListNoteBook - Create and manipulate tixListNoteBook widgets</H2></Center><hr>
|
|
|
</pre><H3>SYNOPSIS</H3>
|
</pre><H3>SYNOPSIS</H3>
|
<B>tixListNoteBook<I> <I>pathName ?<I>options</I></B>?
|
<B>tixListNoteBook<I> <I>pathName ?<I>options</I></B>?
|
</pre><H3>STANDARD OPTIONS</H3>
|
</pre><H3>STANDARD OPTIONS</H3>
|
The ListNoteBook widget supports all the standard options of a frame widget.
|
The ListNoteBook widget supports all the standard options of a frame widget.
|
See the options(n) manual entry for details on the standard options.
|
See the options(n) manual entry for details on the standard options.
|
</pre><H3>WIDGET-SPECIFIC OPTIONS</H3>
|
</pre><H3>WIDGET-SPECIFIC OPTIONS</H3>
|
<P>
|
<P>
|
<pre><code><code><code>
|
<pre><code><code><code>
|
Name: <B>dynamicGeometry</B></I>
|
Name: <B>dynamicGeometry</B></I>
|
Class: <B>DynamicGeometry</B></I>
|
Class: <B>DynamicGeometry</B></I>
|
Switch: <B>-dynamicgeometry</B></I>
|
Switch: <B>-dynamicgeometry</B></I>
|
</code></code></code></pre>
|
</code></code></code></pre>
|
<UL>
|
<UL>
|
If set to false, the size of the ListNotebook will match the size of the
|
If set to false, the size of the ListNotebook will match the size of the
|
largest page. If set to true, the size of the ListNotebook will match the
|
largest page. If set to true, the size of the ListNotebook will match the
|
size of the current page (therefore, the size may change when the user
|
size of the current page (therefore, the size may change when the user
|
selects different pages). The default value is false. A setting of true
|
selects different pages). The default value is false. A setting of true
|
is discouraged.
|
is discouraged.
|
</UL>
|
</UL>
|
<P>
|
<P>
|
<pre><code><code><code>
|
<pre><code><code><code>
|
Name: <B>ipadX</B></I>
|
Name: <B>ipadX</B></I>
|
Class: <B>Pad</B></I>
|
Class: <B>Pad</B></I>
|
Switch: <B>-ipadx</B></I>
|
Switch: <B>-ipadx</B></I>
|
</code></code></code></pre>
|
</code></code></code></pre>
|
<UL>
|
<UL>
|
The amount of internal horizontal paddings around the sides of the
|
The amount of internal horizontal paddings around the sides of the
|
page subwidgets.
|
page subwidgets.
|
</UL>
|
</UL>
|
<P>
|
<P>
|
<pre><code><code><code>
|
<pre><code><code><code>
|
Name: <B>ipadY</B></I>
|
Name: <B>ipadY</B></I>
|
Class: <B>Pad</B></I>
|
Class: <B>Pad</B></I>
|
Switch: <B>-ipady</B></I>
|
Switch: <B>-ipady</B></I>
|
</code></code></code></pre>
|
</code></code></code></pre>
|
<UL>
|
<UL>
|
The amount of internal vertical paddings around the sides of the
|
The amount of internal vertical paddings around the sides of the
|
page subwidgets.
|
page subwidgets.
|
</UL>
|
</UL>
|
</pre><H3>SUBWIDGETS</H3>
|
</pre><H3>SUBWIDGETS</H3>
|
<P>
|
<P>
|
<pre><code><code><code>
|
<pre><code><code><code>
|
Name: <B>hlist</B></I>
|
Name: <B>hlist</B></I>
|
Class: <B>TixHList</B></I>
|
Class: <B>TixHList</B></I>
|
</code></code></code></pre>
|
</code></code></code></pre>
|
<UL>
|
<UL>
|
The HList widget that displays the names of the pages.
|
The HList widget that displays the names of the pages.
|
</UL>
|
</UL>
|
<P>
|
<P>
|
In addition, all the page subwidgets created as a result of the
|
In addition, all the page subwidgets created as a result of the
|
<B>add</B></I> command can be accessed by the <B>subwidget</B></I> command. They
|
<B>add</B></I> command can be accessed by the <B>subwidget</B></I> command. They
|
are identified by the <B>pageName</B></I> parameter to the <B>add</B></I>
|
are identified by the <B>pageName</B></I> parameter to the <B>add</B></I>
|
command.
|
command.
|
</pre><HR>
|
</pre><HR>
|
</pre><H3>DESCRIPTION</H3>
|
</pre><H3>DESCRIPTION</H3>
|
<P>
|
<P>
|
The <B>tixListNoteBook</B></I> command creates a new window (given by the
|
The <B>tixListNoteBook</B></I> command creates a new window (given by the
|
<I>pathName</I></B> argument) and makes it into a ListNoteBook widget.
|
<I>pathName</I></B> argument) and makes it into a ListNoteBook widget.
|
Additional options, described above, may be specified on the command
|
Additional options, described above, may be specified on the command
|
line or in the option database to configure aspects of the
|
line or in the option database to configure aspects of the
|
ListNoteBook widget such as its cursor and relief.
|
ListNoteBook widget such as its cursor and relief.
|
|
|
The ListNoteBook widget is very similar to the TixNoteBook widget: it
|
The ListNoteBook widget is very similar to the TixNoteBook widget: it
|
can be used to display many windows in a limited space using a
|
can be used to display many windows in a limited space using a
|
"notebook" metaphore. The notebook is divided into a stack of pages
|
"notebook" metaphore. The notebook is divided into a stack of pages
|
(windows). At one time only one of these pages can be shown. The user
|
(windows). At one time only one of these pages can be shown. The user
|
can navigate through these pages by choosing the name of the desired
|
can navigate through these pages by choosing the name of the desired
|
page in the <B>hlist</B></I> subwidget.
|
page in the <B>hlist</B></I> subwidget.
|
</pre><H3>WIDGET COMMANDS</H3>
|
</pre><H3>WIDGET COMMANDS</H3>
|
<P>
|
<P>
|
The <B>tixListNoteBook</B></I> command creates a new Tcl command whose name is
|
The <B>tixListNoteBook</B></I> command creates a new Tcl command whose name is
|
command may be used to invoke various operations on the widget. It has
|
command may be used to invoke various operations on the widget. It has
|
the following general form:
|
the following general form:
|
<pre>
|
<pre>
|
<I>pathName option </I></B>?<I>arg arg ...</I></B>?
|
<I>pathName option </I></B>?<I>arg arg ...</I></B>?
|
<P>
|
<P>
|
</pre>
|
</pre>
|
<I>PathName</I></B> is the name of the command, which is the same as the
|
<I>PathName</I></B> is the name of the command, which is the same as the
|
determine the exact behavior of the command. The following commands
|
determine the exact behavior of the command. The following commands
|
are possible for ListNoteBook widgets:
|
are possible for ListNoteBook widgets:
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>add<I> pageName </I></B>?<I>option value ...</I></B>?
|
<DT> <I>pathName <B>add<I> pageName </I></B>?<I>option value ...</I></B>?
|
</I></B>
|
</I></B>
|
<DD> Adds a new ListNotebook page subwidget into the ListNoteBook widget.
|
<DD> Adds a new ListNotebook page subwidget into the ListNoteBook widget.
|
<I>pageName</I></B> must be the name of an existing entry of the
|
<I>pageName</I></B> must be the name of an existing entry of the
|
<B>hlist</B></I> subwidget. You must create the entry before calling the
|
<B>hlist</B></I> subwidget. You must create the entry before calling the
|
<B>add</B></I> command. Please refer to the <B>tixHList(n)</B></I> manual entry
|
<B>add</B></I> command. Please refer to the <B>tixHList(n)</B></I> manual entry
|
for adding entries in an HList widget.
|
for adding entries in an HList widget.
|
|
|
Additional parameters may be supplied to configure this page
|
Additional parameters may be supplied to configure this page
|
subwidget. Possible options are:
|
subwidget. Possible options are:
|
</DL>
|
</DL>
|
<UL>
|
<UL>
|
<DL>
|
<DL>
|
<DT> <B>-createcmd</B></I>
|
<DT> <B>-createcmd</B></I>
|
</I></B>
|
</I></B>
|
<DD> Specifies a TCL command to be called the first time a page is shown on
|
<DD> Specifies a TCL command to be called the first time a page is shown on
|
the screen. This option can be used to delay the creation of the
|
the screen. This option can be used to delay the creation of the
|
contents of a page until necessary. Therefore, it can be used to speed
|
contents of a page until necessary. Therefore, it can be used to speed
|
up interface creation process especially when there are a large number
|
up interface creation process especially when there are a large number
|
of pages in a ListNoteBook widget.
|
of pages in a ListNoteBook widget.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <B>-raisecmd</B></I>
|
<DT> <B>-raisecmd</B></I>
|
</I></B>
|
</I></B>
|
<DD> Specifies a TCL command to be called whenever this page is raised by
|
<DD> Specifies a TCL command to be called whenever this page is raised by
|
the user.
|
the user.
|
</DL>
|
</DL>
|
</UL>
|
</UL>
|
When successful, this command returns the pathname of the newly
|
When successful, this command returns the pathname of the newly
|
created page.
|
created page.
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>cget</B></I> <I>option</I></B>
|
<DT> <I>pathName <B>cget</B></I> <I>option</I></B>
|
</I></B>
|
</I></B>
|
<DD> Returns the current value of the configuration option given by
|
<DD> Returns the current value of the configuration option given by
|
<I>option</I></B>.<I>Option</I></B> may have any of the values accepted by the
|
<I>option</I></B>.<I>Option</I></B> may have any of the values accepted by the
|
<B>tixListNoteBook</B></I> command.
|
<B>tixListNoteBook</B></I> command.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>configure</B></I> ?<I>option</I></B>? <I>?value option value ...</I></B>?
|
<DT> <I>pathName <B>configure</B></I> ?<I>option</I></B>? <I>?value option value ...</I></B>?
|
</I></B>
|
</I></B>
|
<DD> Query or modify the configuration options of the widget. If no
|
<DD> Query or modify the configuration options of the widget. If no
|
<I>option</I></B> is specified, returns a list describing all of the
|
<I>option</I></B> is specified, returns a list describing all of the
|
available options for <I>pathName</I></B> (see <B>Tk_ConfigureInfo</B></I> for
|
available options for <I>pathName</I></B> (see <B>Tk_ConfigureInfo</B></I> for
|
information on the format of this list). If <I>option</I></B> is specified
|
information on the format of this list). If <I>option</I></B> is specified
|
with no <I>value</I></B>, then the command returns a list describing the
|
with no <I>value</I></B>, then the command returns a list describing the
|
one named option (this list will be identical to the corresponding
|
one named option (this list will be identical to the corresponding
|
sublist of the value returned if no <I>option</I></B> is specified). If
|
sublist of the value returned if no <I>option</I></B> is specified). If
|
one or more <I>option-value</I></B> pairs are specified, then the command
|
one or more <I>option-value</I></B> pairs are specified, then the command
|
modifies the given widget option(s) to have the given value(s); in
|
modifies the given widget option(s) to have the given value(s); in
|
this case the command returns an empty string. <I>Option</I></B> may have
|
this case the command returns an empty string. <I>Option</I></B> may have
|
any of the values accepted by the <B>tixListNoteBook</B></I> command.
|
any of the values accepted by the <B>tixListNoteBook</B></I> command.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>delete<I> pageName</I></B>?
|
<DT> <I>pathName <B>delete<I> pageName</I></B>?
|
</I></B>
|
</I></B>
|
<DD> Deletes the page identified by <I>pageName</I></B>.
|
<DD> Deletes the page identified by <I>pageName</I></B>.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>pagecget</B></I> <I>pageName option</I></B>
|
<DT> <I>pathName <B>pagecget</B></I> <I>pageName option</I></B>
|
</I></B>
|
</I></B>
|
<DD> Returns the current value of the configuration option given by
|
<DD> Returns the current value of the configuration option given by
|
<I>option</I></B> in the page given by <I>pageName</I></B>. <I>Option</I></B> may
|
<I>option</I></B> in the page given by <I>pageName</I></B>. <I>Option</I></B> may
|
have any of the values accepted by the <B>add</B></I> widget command.
|
have any of the values accepted by the <B>add</B></I> widget command.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>pageconfigure<I> pageName ?<I>option</I></B>? <I>?value ...</I></B>?
|
<DT> <I>pathName <B>pageconfigure<I> pageName ?<I>option</I></B>? <I>?value ...</I></B>?
|
</I></B>
|
</I></B>
|
<DD> When no option is given, prints out the values of all options of this
|
<DD> When no option is given, prints out the values of all options of this
|
page. If <I>option</I></B> is specified with no <I>value</I></B>, then the
|
page. If <I>option</I></B> is specified with no <I>value</I></B>, then the
|
command returns the current value of that option. If one or more
|
command returns the current value of that option. If one or more
|
<I>option-value</I></B> pairs are specified, then the command modifies the
|
<I>option-value</I></B> pairs are specified, then the command modifies the
|
command returns an empty string. <I>Option</I></B> may be any of options
|
command returns an empty string. <I>Option</I></B> may be any of options
|
accepted by the <B>add</B></I> widget command.
|
accepted by the <B>add</B></I> widget command.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>pages</B></I>
|
<DT> <I>pathName <B>pages</B></I>
|
</I></B>
|
</I></B>
|
<DD> Returns a list of the names of all the pages.
|
<DD> Returns a list of the names of all the pages.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>raise <I>pageName</I></B>
|
<DT> <I>pathName <B>raise <I>pageName</I></B>
|
</I></B>
|
</I></B>
|
<DD> Raise the page identified by <I>pageName</I></B>.
|
<DD> Raise the page identified by <I>pageName</I></B>.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>raised</B></I>
|
<DT> <I>pathName <B>raised</B></I>
|
</I></B>
|
</I></B>
|
<DD> Returns the name of the currently raised page.
|
<DD> Returns the name of the currently raised page.
|
</DL>
|
</DL>
|
<DL>
|
<DL>
|
<DT> <I>pathName <B>subwidget <I> name ?args?</I></B>
|
<DT> <I>pathName <B>subwidget <I> name ?args?</I></B>
|
</I></B>
|
</I></B>
|
<DD> When no options are given, this command returns the pathname of the
|
<DD> When no options are given, this command returns the pathname of the
|
subwidget of the specified name.
|
subwidget of the specified name.
|
|
|
When options are given, the widget command of the specified subwidget
|
When options are given, the widget command of the specified subwidget
|
will be called with these options.
|
will be called with these options.
|
</DL>
|
</DL>
|
</pre><H3>EXAMPLE</H3>
|
</pre><H3>EXAMPLE</H3>
|
<pre><code><code><code>
|
<pre><code><code><code>
|
tixListNoteBook .n; pack .n
|
tixListNoteBook .n; pack .n
|
.n subwidget hlist add page1 -text "Page 1"
|
.n subwidget hlist add page1 -text "Page 1"
|
.n subwidget hlist add page2 -text "Page 2"
|
.n subwidget hlist add page2 -text "Page 2"
|
|
|
set page1 [.n add page1]
|
set page1 [.n add page1]
|
set page2 [.n add page2]
|
set page2 [.n add page2]
|
|
|
button $page1.b -text "On page1"
|
button $page1.b -text "On page1"
|
button $page2.b -text "On page2"
|
button $page2.b -text "On page2"
|
|
|
pack $page1.b
|
pack $page1.b
|
pack $page2.b
|
pack $page2.b
|
|
|
.n raise page2
|
.n raise page2
|
</code></code></code></pre>
|
</code></code></code></pre>
|
</pre><H3>BINDINGS</H3>
|
</pre><H3>BINDINGS</H3>
|
<P>
|
<P>
|
When the user activates an entry in the <B>hlist</B></I> subwidget, the
|
When the user activates an entry in the <B>hlist</B></I> subwidget, the
|
page associated with that entry will be raised to the front. This can
|
page associated with that entry will be raised to the front. This can
|
be done by using the mouse or keyboard. The <I>hlist</I></B> subwidget
|
be done by using the mouse or keyboard. The <I>hlist</I></B> subwidget
|
operates with its <B>-selectmode</B></I> option set to single. See the
|
operates with its <B>-selectmode</B></I> option set to single. See the
|
event bindings of the HList widget for more details.
|
event bindings of the HList widget for more details.
|
</pre><H3>KEYWORDS</H3>
|
</pre><H3>KEYWORDS</H3>
|
Tix(n), tixHList(n)
|
Tix(n), tixHList(n)
|
<hr><i>Last modified Sun Jan 19 22:34:32 EST 1997 </i> ---
|
<hr><i>Last modified Sun Jan 19 22:34:32 EST 1997 </i> ---
|
<i>Serial 853731302</i>
|
<i>Serial 853731302</i>
|
|
|