|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" Notebook.sgm /main/11 1996/09/08 20:54:37 rws $
|
|
Packit |
b099d7 |
.de P!
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\!!1 setgray
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\\&.\"
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\!!0 setgray
|
|
Packit |
b099d7 |
.fl \" force out current output buffer
|
|
Packit |
b099d7 |
\!!save /psv exch def currentpoint translate 0 0 moveto
|
|
Packit |
b099d7 |
\!!/showpage{}def
|
|
Packit |
b099d7 |
.fl \" prolog
|
|
Packit |
b099d7 |
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
|
|
Packit |
b099d7 |
\!!psv restore
|
|
Packit |
b099d7 |
.
|
|
Packit |
b099d7 |
.de pF
|
|
Packit |
b099d7 |
.ie ?\\*(f1?? .ds f1 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f2?? .ds f2 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f3?? .ds f3 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f4?? .ds f4 \\n(.f
|
|
Packit |
b099d7 |
.el .tm ? font overflow
|
|
Packit |
b099d7 |
.ft \\$1
|
|
Packit |
b099d7 |
..
|
|
Packit |
b099d7 |
.de fP
|
|
Packit |
b099d7 |
.ie !?\\*(f4?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f4
|
|
Packit |
b099d7 |
. ds f4\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f3?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f3
|
|
Packit |
b099d7 |
. ds f3\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f2?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f2
|
|
Packit |
b099d7 |
. ds f2\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f1?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f1
|
|
Packit |
b099d7 |
. ds f1\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .tm ? font underflow
|
|
Packit |
b099d7 |
..
|
|
Packit |
b099d7 |
.ds f1\"
|
|
Packit |
b099d7 |
.ds f2\"
|
|
Packit |
b099d7 |
.ds f3\"
|
|
Packit |
b099d7 |
.ds f4\"
|
|
Packit |
b099d7 |
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
|
|
Packit |
b099d7 |
.TH "XmNotebook" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmNotebook\fP \(em The Notebook widget class
|
|
Packit |
b099d7 |
.iX "XmNotebook"
|
|
Packit |
b099d7 |
.iX "widget class" "Notebook"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/Notebook\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook is a manager widget that
|
|
Packit |
b099d7 |
organizes its children into pages, tabs, status areas, and page scrollers to
|
|
Packit |
b099d7 |
simulate a real notebook\&. It stacks its page children so that all page
|
|
Packit |
b099d7 |
children occupy the same area like real book pages\&.
|
|
Packit |
b099d7 |
Notebook displays visuals that look like the binding of a book and the
|
|
Packit |
b099d7 |
edges of other pages around the page that is shown\&.
|
|
Packit |
b099d7 |
Tab children simulate
|
|
Packit |
b099d7 |
notebook tabs\&. Major tabs divide Notebook into several sections,
|
|
Packit |
b099d7 |
and minor tabs subdivide these sections\&. Status area children provide additional
|
|
Packit |
b099d7 |
information about pages such as page numbers\&. The page scroller child allows
|
|
Packit |
b099d7 |
the user to move from page to page\&. Notebook also provides tab scrollers
|
|
Packit |
b099d7 |
for scrolling major and minor tabs if it cannot display all tabs within its
|
|
Packit |
b099d7 |
edges\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The application creates pages, tabs, status areas, and page scroller
|
|
Packit |
b099d7 |
as children of the Notebook widget\&. Notebook creates tab scrollers
|
|
Packit |
b099d7 |
when the Notebook is created\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The \fBXmNnotebookChildType\fP constraint resource
|
|
Packit |
b099d7 |
of Notebook determines whether a child widget is a page, tab, status area,
|
|
Packit |
b099d7 |
or page scroller\&. Any Motif widget can be a page of the Notebook\&.
|
|
Packit |
b099d7 |
When the application creates a child of the Notebook widget without setting
|
|
Packit |
b099d7 |
the child type constraint, the child becomes a page by default, unless it has
|
|
Packit |
b099d7 |
the \fBXmQTactivatable\fP,
|
|
Packit |
b099d7 |
\fBXmQTaccessTextual\fP, or \fBXmQTnavigator\fP trait\&.
|
|
Packit |
b099d7 |
Children with the \fBXmQTactivatable\fP,
|
|
Packit |
b099d7 |
\fBXmQTaccessTextual\fP, or \fBXmQTnavigator\fP trait become
|
|
Packit |
b099d7 |
major tabs, status areas, and page scrollers, respectively\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook uses the \fBXmQTaccessTextual\fP, \fBXmQTactivatable\fP,
|
|
Packit |
b099d7 |
\fBXmQTjoinSide\fP, and
|
|
Packit |
b099d7 |
\fBXmQTnavigator\fP traits, and installs the \fBXmQTscrollFrame\fP trait\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The application attaches a tab to a page by creating a tab child of the
|
|
Packit |
b099d7 |
Notebook and setting the \fBXmNpageNumber\fP constraint to the page number of
|
|
Packit |
b099d7 |
the targeted page\&. By the same method, a status area widget can be attached to
|
|
Packit |
b099d7 |
a page\&. The page scroller child, on the other hand, is associated with the
|
|
Packit |
b099d7 |
Notebook, not with a specific page\&. Therefore, there is only one valid page
|
|
Packit |
b099d7 |
scroller for each Notebook\&.
|
|
Packit |
b099d7 |
.SS "Pages"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Only one child of type \fBXmPAGE\fP is displayed at a time by Notebook\&.
|
|
Packit |
b099d7 |
Other page children are hidden off-screen\&. When Notebook displays a particular
|
|
Packit |
b099d7 |
page, it positions the previously-displayed page off-screen and puts the new
|
|
Packit |
b099d7 |
page in its place\&. The page is resized to fit into the dimensions that
|
|
Packit |
b099d7 |
Notebook has allocated to display pages\&.
|
|
Packit |
b099d7 |
.SS "Page Numbers"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook uses the \fBXmNcurrentPageNumber\fP, \fBXmNfirstPageNumber\fP,
|
|
Packit |
b099d7 |
and \fBXmNlastPageNumber\fP resources to determine the current page and
|
|
Packit |
b099d7 |
available page number range\&. Only those pages whose page numbers are within
|
|
Packit |
b099d7 |
the range can be displayed\&. Other pages cannot be displayed until the range
|
|
Packit |
b099d7 |
between \fBXmNfirstPageNumber\fP and \fBXmNlastPageNumber\fP is
|
|
Packit |
b099d7 |
changed to include them or their page numbers are changed to a number within
|
|
Packit |
b099d7 |
the range\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
If \fBXmNfirstPageNumber\fP and \fBXmNlastPageNumber\fP are not set explicitly
|
|
Packit |
b099d7 |
by the application, they are set to 1 by default; Notebook
|
|
Packit |
b099d7 |
sets \fBXmNlastPageNumber\fP
|
|
Packit |
b099d7 |
to the largest page number assigned by the application thereafter by
|
|
Packit |
b099d7 |
default\&. However, once \fBXmNlastPageNumber\fP is set by the application,
|
|
Packit |
b099d7 |
Notebook no longer changes it
|
|
Packit |
b099d7 |
even when a page with a higher page number is managed\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The \fBXmNpageNumber\fP constraint resource is used for specifying the page
|
|
Packit |
b099d7 |
number of a page widget\&. It can be set to any integer\&. For tab and status area
|
|
Packit |
b099d7 |
children, the resource is used for linking the child widget to a page\&.
|
|
Packit |
b099d7 |
For the page scroller child, the resource has no meaning and is ignored by
|
|
Packit |
b099d7 |
the Notebook\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
When a page without a page number is managed, Notebook assigns it
|
|
Packit |
b099d7 |
the smallest unallocated page number that is not less than
|
|
Packit |
b099d7 |
the first page number and greater than the last allocated page number\&. When
|
|
Packit |
b099d7 |
a tab or a status area without a page number is managed, the newly managed
|
|
Packit |
b099d7 |
widget is assigned
|
|
Packit |
b099d7 |
the page number of the most recently managed page, unless the page already has
|
|
Packit |
b099d7 |
the same type of child\&. If the page does have the same type of child,
|
|
Packit |
b099d7 |
Notebook assigns the newly managed widget
|
|
Packit |
b099d7 |
a page number one greater than the most recently managed page;
|
|
Packit |
b099d7 |
this new page number is now occupied\&.
|
|
Packit |
b099d7 |
Notebook may generate a
|
|
Packit |
b099d7 |
default page number greater than \fBXmNlastPageNumber\fP, making
|
|
Packit |
b099d7 |
those pages inaccessible to the user\&.
|
|
Packit |
b099d7 |
.SS "Duplicate and Empty Pages"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Since an application can create or change page numbers, it is possible
|
|
Packit |
b099d7 |
to have duplicate page numbers and empty pages\&. When two pages with the
|
|
Packit |
b099d7 |
same page number are managed, only the more recently managed page can be
|
|
Packit |
b099d7 |
displayed\&. Inserting a page with an existing page number
|
|
Packit |
b099d7 |
does not cause a warning\&. The old page widget cannot be displayed
|
|
Packit |
b099d7 |
until the new page widget is removed from the Notebook or until the page number
|
|
Packit |
b099d7 |
of the old page widget is changed to some other number\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
An empty page is a page
|
|
Packit |
b099d7 |
slot where no page is inserted\&. Empty pages occur when a tab or status area
|
|
Packit |
b099d7 |
is associated with a page number that has no matching page widget\&.
|
|
Packit |
b099d7 |
Empty pages display the blank Notebook
|
|
Packit |
b099d7 |
background unless the application provides visual information to this
|
|
Packit |
b099d7 |
empty area while processing \fBXmNpageChangedCallback\fP\&.
|
|
Packit |
b099d7 |
.SS "Notebook Visuals"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook draws lines around two sides of the top page
|
|
Packit |
b099d7 |
to simulate the edges of other pages that are behind the top page\&.
|
|
Packit |
b099d7 |
The \fBXmNbackPagePlacement\fP and \fBXmNorientation\fP resources determine
|
|
Packit |
b099d7 |
which two sides have the lines drawn around them\&. By default, they are drawn
|
|
Packit |
b099d7 |
on the bottom and right sides of the top page\&. The application can set
|
|
Packit |
b099d7 |
resources to control how many lines are drawn and how wide the area that they
|
|
Packit |
b099d7 |
are drawn in is\&. Applications can also choose from three styles of binding
|
|
Packit |
b099d7 |
visual that simulates the binding of a Notebook\&. Solid or spiral bindings
|
|
Packit |
b099d7 |
can be drawn by Notebook, or the application can supply a pixmap that is
|
|
Packit |
b099d7 |
tiled into the binding\&.
|
|
Packit |
b099d7 |
.SS "Tabs"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A major or minor tab is a Motif widget with the \fBXmQTactivatable\fP trait\&.
|
|
Packit |
b099d7 |
If a widget without the trait is created
|
|
Packit |
b099d7 |
for a tab, Notebook does not provide the page activation callback\&.
|
|
Packit |
b099d7 |
As a result, even though the tab is displayed, it cannot automatically move the
|
|
Packit |
b099d7 |
associated page to the top\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Major tabs divide the Notebook pages into sections\&. Minor tabs
|
|
Packit |
b099d7 |
subdivide these sections\&.
|
|
Packit |
b099d7 |
Only minor tabs associated with the current
|
|
Packit |
b099d7 |
section are displayed, where a section consists of the group of pages
|
|
Packit |
b099d7 |
between the current major tab and the next major tab, including the
|
|
Packit |
b099d7 |
current major tab but not including the page containing the next major tab\&.
|
|
Packit |
b099d7 |
The exception to this is when there is no preceding major tab, in
|
|
Packit |
b099d7 |
which case the section starts from the \fBXmNfirstPageNumber\fP value\&.
|
|
Packit |
b099d7 |
A user in one major tab section does not see
|
|
Packit |
b099d7 |
the minor tabs in other sections\&.
|
|
Packit |
b099d7 |
However, all tabs are used in computing
|
|
Packit |
b099d7 |
the size of the Notebook\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Unlike regular notebook tabs, tabs in the
|
|
Packit |
b099d7 |
Notebook are not attached to a physical page (a widget)\&. They are, instead,
|
|
Packit |
b099d7 |
attached to a logical page (a page number)\&. Therefore, it is possible to have
|
|
Packit |
b099d7 |
a tab with an empty page\&. When a page with a tab is removed from the Notebook,
|
|
Packit |
b099d7 |
the tab is not removed because it is still bound to a logical page\&.
|
|
Packit |
b099d7 |
Destroying or unmanaging
|
|
Packit |
b099d7 |
a page widget only erases the page and leaves an empty page\&.
|
|
Packit |
b099d7 |
It does not tear the page out of the Notebook\&. To remove the tab, the
|
|
Packit |
b099d7 |
application must explicitly destroy or unmanage it\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook supports the \fBXmQTjoinSide\fP trait\&. A widget that has the
|
|
Packit |
b099d7 |
\fBXmQTjoinSide\fP trait can be added to the Notebook as a Major or Minor
|
|
Packit |
b099d7 |
tab and will appear to be attached to its associated page with no margins or
|
|
Packit |
b099d7 |
shadows between them\&.
|
|
Packit |
b099d7 |
.SS "Status Areas"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A status area is any widget that is used for describing
|
|
Packit |
b099d7 |
the associated page\&. For example, the Label widget as a status area child
|
|
Packit |
b099d7 |
can hold a simple string or a pixmap that describes a page\&. A status area
|
|
Packit |
b099d7 |
widget is also attached to a page by the page number constraint resource\&.
|
|
Packit |
b099d7 |
Therefore, it is possible to have multiple status area widgets for one page\&.
|
|
Packit |
b099d7 |
Only the most recently managed status area widget for that page can be
|
|
Packit |
b099d7 |
displayed\&. All others for that page are not unmanaged, but their sizes are
|
|
Packit |
b099d7 |
used for computing the size of the Notebook\&. If no status area widget
|
|
Packit |
b099d7 |
is provided, the Notebook displays its blank background in the status area\&'s
|
|
Packit |
b099d7 |
reserved space\&. Notebook does not create any default status area widget\&.
|
|
Packit |
b099d7 |
.SS "Page Scrollers"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The page scroller of the Notebook is any widget that the application
|
|
Packit |
b099d7 |
creates for scrolling pages\&. If the application does not create one when
|
|
Packit |
b099d7 |
the Notebook is realized, Notebook creates a SpinBox widget as the
|
|
Packit |
b099d7 |
default page scroller\&.
|
|
Packit |
b099d7 |
If the application creates a new page scroller, the default page scroller is
|
|
Packit |
b099d7 |
destroyed\&. If the application creates multiple page scrollers, only the
|
|
Packit |
b099d7 |
most recently managed one can be displayed and used\&. All others are
|
|
Packit |
b099d7 |
unmanaged\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The default SpinBox page scroller grays out one of the arrow visuals
|
|
Packit |
b099d7 |
if the current page is a boundary page\&.
|
|
Packit |
b099d7 |
If the current page is the first page, the previous arrow of the SpinBox
|
|
Packit |
b099d7 |
is grayed\&. If the current page is the last page, the next arrow of the
|
|
Packit |
b099d7 |
SpinBox is grayed\&.
|
|
Packit |
b099d7 |
.SS "Tab Scrollers"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Tab scrollers are created by the Notebook for scrolling major tabs and minor
|
|
Packit |
b099d7 |
tabs\&. When Notebook is initialized, it creates four ArrowButtonGadgets
|
|
Packit |
b099d7 |
for scrolling to the next major tab, the previous major tab, the next
|
|
Packit |
b099d7 |
minor tab, and the previous minor tab\&.
|
|
Packit |
b099d7 |
The application cannot replace these tab scrollers\&.
|
|
Packit |
b099d7 |
The application can change all resources
|
|
Packit |
b099d7 |
of these widgets except the position and the arrow direction\&. Tab scrollers
|
|
Packit |
b099d7 |
are only visible and enabled when there is not enough space to display all the
|
|
Packit |
b099d7 |
major or minor tabs appropriate to the page\&. Tab scrollers are also
|
|
Packit |
b099d7 |
grayed out when scrolling is inappropriate\&. The following lists the
|
|
Packit |
b099d7 |
tab scrollers that are created:
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s
|
|
Packit |
b099d7 |
l| l| l.
|
|
Packit |
b099d7 |
T{
|
|
Packit |
b099d7 |
\fBChild Widgets that XmNotebook Creates\fP
|
|
Packit |
b099d7 |
T}
|
|
Packit |
b099d7 |
\fBChild\fP?\fBName\fP?\fBWidget Class\fP
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
Page Scroller?PageScroller?XmSpinBox
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
Next Major Tab Scroller?MajorTabScrollerNext?XmArrowButtonGadget
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
Previous Major Tab Scroller?MajorTabScrollerPrevious?XmArrowButtonGadget
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
Next Minor Tab Scroller?MinorTabScrollerNext?XmArrowButtonGadget
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
Previous Minor Tab Scroller?MinorTabScrollerPrevious?XmArrowButtonGadget
|
|
Packit |
b099d7 |
_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
When the user selects the page scroller, a major tab, or a minor tab, the value
|
|
Packit |
b099d7 |
of \fBXmNcurrentPageNumber\fP is changed to the selected page number and
|
|
Packit |
b099d7 |
\fBXmNpageChangedCallback\fP is invoked\&. After the application returns from
|
|
Packit |
b099d7 |
the callback, the Notebook displays the last page child whose page number is
|
|
Packit |
b099d7 |
equal to the current page number\&. It also displays the last matched status
|
|
Packit |
b099d7 |
area child\&. All other pages and status areas are automatically hidden\&. Major
|
|
Packit |
b099d7 |
tabs and minor tabs that can fit into the Notebook\&'s edges are displayed and
|
|
Packit |
b099d7 |
positioned appropriately\&. All other tabs are also hidden\&. The application
|
|
Packit |
b099d7 |
can also cause a page change by calling \fBXtSetValues\fP on
|
|
Packit |
b099d7 |
\fBXmNcurrentPageNumber\fP and then calling \fBXtCallCallbacks\fP on
|
|
Packit |
b099d7 |
\fBXmNpageChangedCallback\fP\&.
|
|
Packit |
b099d7 |
.SS "Orientation"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The Notebook has eight different visual configurations, depending on
|
|
Packit |
b099d7 |
the value of \fBXmNbackPagePlacement\fP and \fBXmNorientation\fP\&. These two
|
|
Packit |
b099d7 |
resources determine the placement of back pages, the binding, major tabs,
|
|
Packit |
b099d7 |
minor tabs, the status area, and the page scroller\&. The location of the binding
|
|
Packit |
b099d7 |
is determined by \fBXmNorientation\fP\&.
|
|
Packit |
b099d7 |
Major tabs are always placed on the back page side opposite to the binding;
|
|
Packit |
b099d7 |
Minor tabs are placed on the
|
|
Packit |
b099d7 |
back page display area that is visually connected to the binding\&.
|
|
Packit |
b099d7 |
Both Major and Minor tabs are ordered so that the page numbers they access
|
|
Packit |
b099d7 |
increase as they get closer to the corner where the back pages meet\&.
|
|
Packit |
b099d7 |
The status area and the page scroller are always located on the bottom
|
|
Packit |
b099d7 |
of the Notebook, inside the frame\&. The page scroller is always placed adjacent
|
|
Packit |
b099d7 |
to a back page side\&. The following table shows the possible configurations
|
|
Packit |
b099d7 |
and the locations of each Notebook component within the configuration\&.
|
|
Packit |
b099d7 |
The default back page value
|
|
Packit |
b099d7 |
and the default orientation
|
|
Packit |
b099d7 |
are based upon \fBXmNlayoutDirection\fP\&.
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBNotebook Configurations\fP
|
|
Packit |
b099d7 |
\fBXmNbackPagePlacement\fP?\fBXmNorientation\fP?\fBMajor Tabs\fP?\fBStatus Area\fP?\fBBinding\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??\fBMinor Tabs\fP?\fBPage Scroller\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmBOTTOM_RIGHT?XmHORIZONTAL?RIGHT?BOTTOM LEFT?LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??BOTTOM?BOTTOM RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmBOTTOM_RIGHT?XmVERTICAL?BOTTOM?BOTTOM LEFT?TOP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??RIGHT?BOTTOM RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmBOTTOM_LEFT?XmHORIZONTAL?LEFT?BOTTOM RIGHT?RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??BOTTOM?BOTTOM LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmBOTTOM_LEFT?XmVERTICAL?BOTTOM?BOTTOM RIGHT?TOP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??LEFT?BOTTOM LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmTOP_RIGHT?XmHORIZONTAL?RIGHT?BOTTOM LEFT?LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??TOP?BOTTOM RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmTOP_RIGHT?XmVERTICAL?TOP?BOTTOM LEFT?BOTTOM
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??RIGHT?BOTTOM RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmTOP_LEFT?XmHORIZONTAL?LEFT?BOTTOM RIGHT?RIGHT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??TOP?BOTTOM LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmTOP_LEFT?XmVERTICAL?TOP?BOTTOM RIGHT?BOTTOM
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
??LEFT?BOTTOM LEFT
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
There are three tab groups for tab group traversal
|
|
Packit |
b099d7 |
inside the Notebook: major tabs, minor tabs,
|
|
Packit |
b099d7 |
and the page scroller\&.
|
|
Packit |
b099d7 |
The application can also create additional types of tab groups
|
|
Packit |
b099d7 |
within the Notebook; for example, each page added by the application is
|
|
Packit |
b099d7 |
treated as a separate tab group by the traversal actions\&.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook inherits behavior, resources, and traits from \fBCore\fP,
|
|
Packit |
b099d7 |
\fBComposite\fP, \fBConstraint\fP, and \fBXmManager\fP classes\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmNotebookWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmNotebook\fP\&.
|
|
Packit |
b099d7 |
.SS "New Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following table defines a set of widget resources used by the
|
|
Packit |
b099d7 |
programmer to specify data\&. The programmer can also set the resource
|
|
Packit |
b099d7 |
values for the inherited classes to set attributes for this widget\&.
|
|
Packit |
b099d7 |
To reference a resource by name or by class in a \fB\&.Xdefaults\fP file,
|
|
Packit |
b099d7 |
remove the \fBXmN\fP or \fBXmC\fP prefix and use the remaining letters\&.
|
|
Packit |
b099d7 |
To specify one of the defined values for a resource in a \fB\&.Xdefaults\fP
|
|
Packit |
b099d7 |
file, remove the \fBXm\fP prefix and use the remaining letters (in
|
|
Packit |
b099d7 |
either lowercase or uppercase, but include any underscores between
|
|
Packit |
b099d7 |
words)\&. The codes in the access column indicate if the given resource
|
|
Packit |
b099d7 |
can be set at creation time (C), set by using \fBXtSetValues\fP
|
|
Packit |
b099d7 |
(S), retrieved by using \fBXtGetValues\fP (G), or is not
|
|
Packit |
b099d7 |
applicable (N/A)\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmNotebook Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackPageBackground?XmCBackPageBackground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackPageForeground?XmCBackPageForeground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackPageNumber?XmCBackPageNumber?Cardinal?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackPagePlacement?XmCBackPagePlacement?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackPageSize?XmCBackPageSize?Dimension?8?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbindingPixmap?XmCBindingPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbindingType?XmCBindingType?unsigned char?XmSPIRAL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbindingWidth?XmCBindingWidth?Dimension?25?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNcurrentPageNumber?XmCCurrentPageNumber?int?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfirstPageNumber?XmCFirstPageNumber?int?1?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNframeBackground?XmCFrameBackground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNframeShadowThickness?XmCShadowThickness?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinnerMarginHeight?XmCInnerMarginHeight?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinnerMarginWidth?XmCInnerMarginWidth?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlastPageNumber?XmCLastPageNumber?int?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNminorTabSpacing?XmCMinorTabSpacing?Dimension?3?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmajorTabSpacing?XmCMajorTabSpacing?Dimension?3?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNorientation?XmCOrientation?unsigned char?XmHORIZONTAL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpageChangedCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNbackPageBackground\fP" 10
|
|
Packit |
b099d7 |
Specifies the background color for drawing back pages\&.
|
|
Packit |
b099d7 |
The default is a lower-intensity version of \fBXmNframeBackground\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbackPageForeground\fP" 10
|
|
Packit |
b099d7 |
Specifies the forground color for drawing back pages\&. The default is
|
|
Packit |
b099d7 |
taken from the application\&'s default foreground color\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbackPageNumber\fP" 10
|
|
Packit |
b099d7 |
Specifies the number of lines to draw for back pages\&. The minimum value is
|
|
Packit |
b099d7 |
1, and the maximum value is (\fBXmNbackPageSize\fP / 2)\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbackPagePlacement\fP" 10
|
|
Packit |
b099d7 |
Specifies where to place the back pages\&.
|
|
Packit |
b099d7 |
The default is dependent on the \fBXmNlayoutDirection\fP resource
|
|
Packit |
b099d7 |
of the Notebook\&'s instance parents\&.
|
|
Packit |
b099d7 |
It can have one of the following
|
|
Packit |
b099d7 |
values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmBOTTOM_RIGHT\fP" 10
|
|
Packit |
b099d7 |
Displays back pages on the Notebook\&'s bottom and
|
|
Packit |
b099d7 |
right sides\&.
|
|
Packit |
b099d7 |
.IP "\fBXmBOTTOM_LEFT\fP" 10
|
|
Packit |
b099d7 |
Displays back pages on the Notebook\&'s bottom and
|
|
Packit |
b099d7 |
left sides\&.
|
|
Packit |
b099d7 |
.IP "\fBXmTOP_RIGHT\fP" 10
|
|
Packit |
b099d7 |
Displays back pages on the Notebook\&'s top and right
|
|
Packit |
b099d7 |
sides\&.
|
|
Packit |
b099d7 |
.IP "\fBXmTOP_LEFT\fP" 10
|
|
Packit |
b099d7 |
Displays back pages on the Notebook\&'s top and left sides\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNbackPageSize\fP" 10
|
|
Packit |
b099d7 |
Specifies the thickness of the back page rendering\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbindingPixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies the pixmap or bitmap for stippling or tiling the binding when
|
|
Packit |
b099d7 |
\fBXmNbindingType\fP is \fBXmPIXMAP\fP or \fBXmPIXMAP_OVERLAP_ONLY\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNbindingType\fP" 10
|
|
Packit |
b099d7 |
Specifies the binding type\&. It can have one of the following values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmNONE\fP" 10
|
|
Packit |
b099d7 |
Displays no binding\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSOLID\fP" 10
|
|
Packit |
b099d7 |
Displays a solid binding in the foreground color of the
|
|
Packit |
b099d7 |
Notebook within the binding area specified by \fBXmNbindingWidth\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSPIRAL\fP" 10
|
|
Packit |
b099d7 |
Displays a spiral binding in the foreground color of the
|
|
Packit |
b099d7 |
Notebook within the area specified by \fBXmNbindingWidth\fP
|
|
Packit |
b099d7 |
and within the area outside of the frame equal to
|
|
Packit |
b099d7 |
the area specified by \fBXmNbindingWidth\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmPIXMAP\fP" 10
|
|
Packit |
b099d7 |
Displays the binding with the pixmap or bitmap specified by
|
|
Packit |
b099d7 |
\fBXmNbindingPixmap\fP as a stipple or tile\&. It uses the foreground color of
|
|
Packit |
b099d7 |
the Notebook for stippling\&. The binding width is decided by the larger value
|
|
Packit |
b099d7 |
of \fBXmNbindingWidth\fP and the width of the pixmap or bitmap\&.
|
|
Packit |
b099d7 |
.IP "\fBXmPIXMAP_OVERLAP_ONLY\fP" 10
|
|
Packit |
b099d7 |
Displays the binding with the pixmap or bitmap
|
|
Packit |
b099d7 |
specified by \fBXmNbindingPixmap\fP as a stipple or tile\&. It uses the
|
|
Packit |
b099d7 |
foreground color of the Notebook for stippling\&. The binding is displayed only
|
|
Packit |
b099d7 |
within the binding area specified by \fBXmNbindingWidth\fP\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNbindingWidth\fP" 10
|
|
Packit |
b099d7 |
Specifies the width of the Notebook binding\&. If \fBXmNbindingType\fP is
|
|
Packit |
b099d7 |
\fBXmPIXMAP\fP and the width of the pixmap specified in
|
|
Packit |
b099d7 |
\fBXmNbindingPixmap\fP is greater than \fBXmNbindingWidth\fP, then this
|
|
Packit |
b099d7 |
resource is ignored and the
|
|
Packit |
b099d7 |
width of the pixmap is used as the width of the Notebook binding
|
|
Packit |
b099d7 |
instead\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNcurrentPageNumber\fP" 10
|
|
Packit |
b099d7 |
Specifies the page number of the currently displayed page\&. Initially, it is set
|
|
Packit |
b099d7 |
to \fBXmNfirstPageNumber\fP\&. If it is set to less than
|
|
Packit |
b099d7 |
\fBXmNfirstPageNumber\fP,
|
|
Packit |
b099d7 |
then it is set to \fBXmNfirstPageNumber\fP\&.
|
|
Packit |
b099d7 |
If it is set to \fBXmNlastPageNumber\fP,
|
|
Packit |
b099d7 |
then it is set to \fBXmNlastPageNumber\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNfirstPageNumber\fP" 10
|
|
Packit |
b099d7 |
Specifies the page number for the first page of the Notebook\&.
|
|
Packit |
b099d7 |
The Notebook does not scroll to any page numbers below this value\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNframeBackground\fP" 10
|
|
Packit |
b099d7 |
Specifies the background color for drawing the Notebook\&'s frame\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNframeShadowThickness\fP" 10
|
|
Packit |
b099d7 |
Specifies the shadow thickness around the Notebook\&'s frame\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNinnerMarginHeight\fP" 10
|
|
Packit |
b099d7 |
Specifies the margin on the top and bottom sides of the page, status
|
|
Packit |
b099d7 |
area, and page scroller widgets\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNinnerMarginWidth\fP" 10
|
|
Packit |
b099d7 |
Specifies the margin on the left and right sides of the page, status
|
|
Packit |
b099d7 |
area, and page scroller widgets\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlastPageNumber\fP" 10
|
|
Packit |
b099d7 |
Specifies the page number for the last page of the Notebook\&.
|
|
Packit |
b099d7 |
The Notebook does not scroll to any page numbers above this value\&.
|
|
Packit |
b099d7 |
The default page number is the largest page number of managed page,
|
|
Packit |
b099d7 |
major tab, or minor tab widgets\&.
|
|
Packit |
b099d7 |
If this is set to a value that is less than \fBXmNfirstPageNumber\fP, the
|
|
Packit |
b099d7 |
behavior of the Notebook is undefined\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmajorTabSpacing\fP" 10
|
|
Packit |
b099d7 |
Specifies the spacing distance between major tabs\&.
|
|
Packit |
b099d7 |
If \fBXmNframeShadowThickness\fP is greater than \fBXmNmajorTabSpacing\fP, then
|
|
Packit |
b099d7 |
this resource is ignored and the size of \fBXmNframeShadowThickness\fP is
|
|
Packit |
b099d7 |
used as the spacing distance between major tabs\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNminorTabSpacing\fP" 10
|
|
Packit |
b099d7 |
Specifies the spacing distance between minor tabs\&. If
|
|
Packit |
b099d7 |
\fBXmNframeShadowThickness\fP is greater than \fBXmNminorTabSpacing\fP, then
|
|
Packit |
b099d7 |
this resource is ignored and the size of \fBXmNframeShadowThickness\fP is
|
|
Packit |
b099d7 |
used as the spacing distance between minor tabs\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNorientation\fP" 10
|
|
Packit |
b099d7 |
Specifies the orientation of the Notebook\&. It can have one of the following
|
|
Packit |
b099d7 |
values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmHORIZONTAL\fP" 10
|
|
Packit |
b099d7 |
Places the binding beside the pages, in the left or
|
|
Packit |
b099d7 |
right side of the frame\&.
|
|
Packit |
b099d7 |
.IP "\fBXmVERTICAL\fP" 10
|
|
Packit |
b099d7 |
Places the binding above or below the pages, in the top
|
|
Packit |
b099d7 |
or the bottom of the frame\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNpageChangedCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks to call whenever the
|
|
Packit |
b099d7 |
\fBXmNcurrentPageNumber\fP, representing the current page number, is
|
|
Packit |
b099d7 |
changed\&. This includes the point when the widget is realized and the
|
|
Packit |
b099d7 |
page number is initialized\&.
|
|
Packit |
b099d7 |
The callback structure is \fBXmNotebookCallbackStruct\fR\&.
|
|
Packit |
b099d7 |
The reason is \fBXmCR_MAJOR_TAB\fP, \fBXmCR_MINOR_TAB\fP,
|
|
Packit |
b099d7 |
\fBXmCR_PAGE_SCROLLER_INCREMENT\fP,
|
|
Packit |
b099d7 |
\fBXmCR_PAGE_SCROLLER_DECREMENT\fP, or \fBXmCR_NONE\fP, depending
|
|
Packit |
b099d7 |
upon what action caused the Notebook to display a new page\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmNotebook Constraint Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnotebookChildType?XmCNotebookChildType?unsigned char?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpageNumber?XmCPageNumber?int?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNresizable?XmCResizable?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNnotebookChildType\fP" 10
|
|
Packit |
b099d7 |
Specifies the child type of the Notebook\&. It can be one of the following types:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmPAGE\fP" 10
|
|
Packit |
b099d7 |
The child is a page of the Notebook\&. This is the default
|
|
Packit |
b099d7 |
when the child does not have
|
|
Packit |
b099d7 |
the \fBXmQTactivatable\fP,
|
|
Packit |
b099d7 |
\fBXmQTaccessTextual\fP, or \fBXmQTnavigator\fP trait\&.
|
|
Packit |
b099d7 |
.IP "\fBXmMAJOR_TAB\fP" 10
|
|
Packit |
b099d7 |
The child is a major tab\&. This is the default when
|
|
Packit |
b099d7 |
the child has the \fBXmQTactivatable\fP trait\&.
|
|
Packit |
b099d7 |
.IP "\fBXmMINOR_TAB\fP" 10
|
|
Packit |
b099d7 |
The child is a minor tab\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSTATUS_AREA\fP" 10
|
|
Packit |
b099d7 |
The child is a status area\&. This is the default when
|
|
Packit |
b099d7 |
the child has the \fBXmQTaccessTextual\fP trait and does not have
|
|
Packit |
b099d7 |
the \fBXmQTactivatable\fP trait\&.
|
|
Packit |
b099d7 |
.IP "\fBXmPAGE_SCROLLER\fP" 10
|
|
Packit |
b099d7 |
The child is the page scroller\&. The default page
|
|
Packit |
b099d7 |
scroller is destroyed, if it exists\&. Any previously created page
|
|
Packit |
b099d7 |
scrollers are unmanaged\&. This is the default when the child
|
|
Packit |
b099d7 |
has the \fBXmQTnavigator\fP trait and does have the
|
|
Packit |
b099d7 |
\fBXmQTactivatable\fP trait or the \fBXmQTaccessTextual\fP trait\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNpageNumber\fP" 10
|
|
Packit |
b099d7 |
Specifies the page number associated with the widget\&.
|
|
Packit |
b099d7 |
If the widget is a page, the number specifies the page number of the widget\&.
|
|
Packit |
b099d7 |
If the widget is not a page, the number specifies the page number of the
|
|
Packit |
b099d7 |
associated page\&. If none is supplied by the application, Notebook
|
|
Packit |
b099d7 |
generates the smallest unallocated page number when the child is managed\&.
|
|
Packit |
b099d7 |
This resource is ignored for the page scroller\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNresizable\fP" 10
|
|
Packit |
b099d7 |
Specifies whether this child can request a resize\&.
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook inherits behavior and resources from the
|
|
Packit |
b099d7 |
superclasses described in the following tables\&.
|
|
Packit |
b099d7 |
For a complete description of each resource, refer to the
|
|
Packit |
b099d7 |
reference page for that superclass\&.
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmManager Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowColor?XmCBottomShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowPixmap?XmCBottomShadowPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNforeground?XmCForeground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhelpCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightColor?XmCHighlightColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightPixmap?XmCHighlightPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinitialFocus?XmCInitialFocus?Widget?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlayoutDirection?XmCLayoutDirection?XmDirection?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnavigationType?XmCNavigationType?XmNavigationType?XmTAB_GROUP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpopupHandlerCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNshadowThickness?XmCShadowThickness?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNstringDirection?XmCStringDirection?XmStringDirection?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowColor?XmCTopShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowPixmap?XmCTopShadowPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtraversalOn?XmCTraversalOn?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNunitType?XmCUnitType?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNuserData?XmCUserData?XtPointer?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBComposite Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNchildren?XmCReadOnly?WidgetList?NULL?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinsertPosition?XmCInsertPosition?XtOrderProc?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnumChildren?XmCReadOnly?Cardinal?0?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBCore Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNaccelerators?XmCAccelerators?XtAccelerators?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNancestorSensitive?XmCSensitive?Boolean?dynamic?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackground?XmCBackground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackgroundPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderColor?XmCBorderColor?Pixel?XtDefaultForeground?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderWidth?XmCBorderWidth?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNcolormap?XmCColormap?Colormap?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdepth?XmCDepth?int?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdestroyCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNheight?XmCHeight?Dimension?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinitialResourcesPersistent?XmCInitialResourcesPersistent?Boolean?True?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmappedWhenManaged?XmCMappedWhenManaged?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNscreen?XmCScreen?Screen *?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNsensitive?XmCSensitive?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtranslations?XmCTranslations?XtTranslations?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNwidth?XmCWidth?Dimension?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNx?XmCPosition?Position?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNy?XmCPosition?Position?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.SS "Callback"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A pointer to the following structure is passed to callbacks for
|
|
Packit |
b099d7 |
\fBXmNpageChangedCallback\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
typedef struct
|
|
Packit |
b099d7 |
{
|
|
Packit |
b099d7 |
int \fIreason\fP;
|
|
Packit |
b099d7 |
XEvent \fI*event\fP;
|
|
Packit |
b099d7 |
int \fIpage_number\fP;
|
|
Packit |
b099d7 |
Widget \fIpage_widget\fP;
|
|
Packit |
b099d7 |
int \fIprev_page_number\fP;
|
|
Packit |
b099d7 |
Widget \fIprev_page_widget\fP;
|
|
Packit |
b099d7 |
} XmNotebookCallbackStruct;
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.IP "\fIreason\fP" 10
|
|
Packit |
b099d7 |
Specifies the reason for the callback\&.
|
|
Packit |
b099d7 |
.IP "\fIevent\fP" 10
|
|
Packit |
b099d7 |
Points to the \fBXEvent\fP that triggered the callback\&. It can be NULL\&.
|
|
Packit |
b099d7 |
.IP "\fIpage_number\fP" 10
|
|
Packit |
b099d7 |
Indicates the page number to be displayed\&.
|
|
Packit |
b099d7 |
.IP "\fIpage_widget\fP" 10
|
|
Packit |
b099d7 |
Indicates the page widget that has the new page number\&.
|
|
Packit |
b099d7 |
It is NULL if no page widget with the page number is found\&.
|
|
Packit |
b099d7 |
.IP "\fIprev_page_number\fP" 10
|
|
Packit |
b099d7 |
Indicates the page number of the currently displayed page\&. If the
|
|
Packit |
b099d7 |
callback procedure is being called at widget initialization, this page
|
|
Packit |
b099d7 |
number will be returned as \fBXmUNSPECIFIED_PAGE_NUMBER\fP\&.
|
|
Packit |
b099d7 |
.IP "\fIprev_page_widget\fP" 10
|
|
Packit |
b099d7 |
Indicates the currently displayed page widget\&. If the callback
|
|
Packit |
b099d7 |
procedure is being called at widget initialization, NULL will be
|
|
Packit |
b099d7 |
returned\&.
|
|
Packit |
b099d7 |
.SS "Translations"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook inherits translations from Manager\&.
|
|
Packit |
b099d7 |
.SS "Accelerators"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook accelerators are added to all major tab and minor tab
|
|
Packit |
b099d7 |
children of XmNotebook\&.
|
|
Packit |
b099d7 |
Notebook accelerators are listed below\&.
|
|
Packit |
b099d7 |
These accelerators might not directly correspond to a
|
|
Packit |
b099d7 |
translation table\&.
|
|
Packit |
b099d7 |
.IP "\fB<osfBeginLine>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBHome\fP)
|
|
Packit |
b099d7 |
.IP "\fB<osfEndLine>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBEnd\fP)
|
|
Packit |
b099d7 |
.IP "\fB<osfLeft>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBPrevious\fP)
|
|
Packit |
b099d7 |
.IP "\fB<osfRight>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBNext\fP)
|
|
Packit |
b099d7 |
.IP "\fB<osfUp>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBPrevious\fP)
|
|
Packit |
b099d7 |
.IP "\fB<osfDown>\fP\fB:\fP" 10
|
|
Packit |
b099d7 |
TraverseTab(\fBNext\fP)
|
|
Packit |
b099d7 |
.SS "Action Routines"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Notebook action routines are described below:
|
|
Packit |
b099d7 |
.IP "TraverseTab(\fBHome|End|Next|Previous\fP)" 10
|
|
Packit |
b099d7 |
Moves the focus on major or minor tabs\&.
|
|
Packit |
b099d7 |
.SS "Additional Behavior"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The Notebook widget has the additional behavior described below:
|
|
Packit |
b099d7 |
.IP "\fB<Tab>\fP" 10
|
|
Packit |
b099d7 |
Notebook intercepts tab group traversal when traversal is entering or
|
|
Packit |
b099d7 |
leaving major or minor tabs\&. It does this to support major tabs and minor
|
|
Packit |
b099d7 |
tabs as two separate tab groups when they are actually treated as one
|
|
Packit |
b099d7 |
by traversal\&. If a minor tab has keyboard focus and a user or program
|
|
Packit |
b099d7 |
action specifies \fBXmTRAVERSE_PREV_TAB_GROUP\fP, keyboard focus will
|
|
Packit |
b099d7 |
go to a major tab\&. If a major tab has keyboard focus and a user or program
|
|
Packit |
b099d7 |
action specifies \fBXmTRAVERSE_NEXT_TAB_GROUP\fP, keyboard focus will
|
|
Packit |
b099d7 |
go to a minor tab\&.
|
|
Packit |
b099d7 |
.SS "Virtual Bindings"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The bindings for virtual keys are vendor specific\&.
|
|
Packit |
b099d7 |
For information about bindings for virtual buttons and keys, see
|
|
Packit |
b099d7 |
\fBVirtualBindings\fP(3)\&.
|
|
Packit |
b099d7 |
.SH "RELATED"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBComposite\fP(3),
|
|
Packit |
b099d7 |
\fBConstraint\fP(3),
|
|
Packit |
b099d7 |
\fBCore\fP(3),
|
|
Packit |
b099d7 |
\fBXmCreateNotebook\fP(3),
|
|
Packit |
b099d7 |
\fBXmManager\fP(3),
|
|
Packit |
b099d7 |
\fBXmNotebookGetPageInfo\fP(3),
|
|
Packit |
b099d7 |
\fBXmVaCreateNotebook\fP(3), and
|
|
Packit |
b099d7 |
\fBXmVaCreateManagedNotebook\fP(3)\&.
|