XmNotebookGetPageInfo

Motif 2.1 Programmer's Reference

XmNotebookGetPageInfo

A Notebook function that returns page information

Format

#include <Xm/Notebook.h>
XmNotebookPageStatus XmNotebookGetPageInfo
Widget
notebookint
page_numberXmNotebookPageInfo
*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 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).

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).