XmNotebookGetPageInfo(3X) UNIX System V XmNotebookGetPageInfo(3X)
NAME
XmNotebookGetPageInfo - A Notebook function that returns
page information
SYNOPSIS
#include <Xm/Notebook.h>
XmNotebookPageStatus XmNotebookGetPageInfo(
Widget notebook,
int page_number,
XmNotebookPageInfo *page_info);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmNotebookGetPageInfo returns status information for the
specified Notebook page.
notebook Specifies the Notebook widget.
page_number
Specifies the page number to be queried.
page_info Points to the structure containing the page
information. The structure has the following form:
typedef struct
{
int page_number;
Widget page_widget;
Widget status_area_widget;
Widget major_tab_widget;
Widget minor_tab_widget;
} XmNotebookPageInfo;
(void)
page_number
Specifies the page_number passed to the
function.
page_widget
Specifies a child widget of the Notebook with
a XmNchildType of XmPAGE and a XmNpageNumber
equal to page_number if one exists; otherwise
set to NULL.
status_area_widget
Specifies a child widget of the Notebook with
a XmNchildType of XmSTATUS_AREA and a
XmNpageNumber equal to page_number if one
exists; otherwise set to NULL.
Page 1 (printed 7/20/06)
XmNotebookGetPageInfo(3X) UNIX System V XmNotebookGetPageInfo(3X)
major_tab_widget
Specifies a child widget of the Notebook with
a XmNchildType of XmMAJOR_TAB and the nearest
XmNpageNumberequal to or less than
page_number if one exists; otherwise set to
NULL.
minor_tab_widget
Specifies a child widget of the Notebook with
a XmNchildType of XmMINOR_TAB and the nearest
XmNpageNumberequal to or less than
page_number if one exists; otherwise set to
NULL.
For a complete definition of Notebook and its associated
resources, see XmNotebook(3).
RETURN
Returns one of the following page status values:
XmPAGE_FOUND
The specified page was found.
XmPAGE_INVALID
The specified page number is out of the page
number range.
XmPAGE_EMPTY
The specified page does not have a page widget.
XmPAGE_DUPLICATED
There is more than one page widget with the
specified page number. The more recently managed
page widget is used for the page information
structure.
RELATED
XmNotebook(3).
Page 2 (printed 7/20/06)