xmnotebookgetpageinfo(3)

NAME

XmNotebookGetPageInfo -- A Notebook function that returns page information

#include <Xm/Notebook.h>
XmNotebookPageStatus XmNotebookGetPageInfo(
Widget notebook,
int page_number,
XmNotebookPageInfo *page_info);

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.
major_tab_widget: Specifies a child widget of the Notebook with a XmNchildType of XmMAJOR_TAB and the nearest XmNpageNumber equal 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 XmNpageNumber equal 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).

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.