XmNotebookGetPageInfo(3X)



     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 pagenumber,
          XmNotebookPageInfo *pageinfo);

     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 XmSTATUSAREA and a
                         XmNpageNumber equal to page_number if one
                         exists; otherwise set to NULL.




     Page 1                                          (printed 1/22/99)



     XmNotebookGetPageInfo(3X) UNIX System V XmNotebookGetPageInfo(3X)



               major_tab_widget
                         Specifies a child widget of the Notebook with
                         a XmNchildType of XmMAJORTAB 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 XmMINORTAB 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:

          XmPAGEFOUND
                    The specified page was found.

          XmPAGEINVALID
                    The specified page number is out of the page
                    number range.

          XmPAGEEMPTY
                    The specified page does not have a page widget.

          XmPAGEDUPLICATED
                    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 1/22/99)

Museum