XmNotebookGetPageInfo(library call) XmNotebookGetPageInfo(library call)
NAME
XmNotebookGetPageInfo -- A Notebook function that returns page informa-
tion
SYNOPSIS
#include <Xm/Notebook.h>
XmNotebookPageStatus XmNotebookGetPageInfo(
Widget notebook,
int page_number,
XmNotebookPageInfo *page_info);
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 XmN-
childType 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 XmN-
childType of XmSTATUS_AREA and a XmNpageNumber equal
to page_number if one exists; otherwise set to NULL.
major_tab_widget
Specifies a child widget of the Notebook with a XmN-
childType of XmMAJOR_TAB and the nearest XmNpageNumber
equal to or less than page_number if one exists; oth-
erwise set to NULL.
minor_tab_widget
Specifies a child widget of the Notebook with a XmN-
childType of XmMINOR_TAB and the nearest XmNpageNumber
equal to or less than page_number if one exists; oth-
erwise 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).
XmNotebookGetPageInfo(library call)
openMotif 2.3.1 - Generated Tue Dec 2 06:17:05 CST 2008