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