Provided by: libmotif-dev_2.3.3-5ubuntu1_amd64 bug

NAME

       XmNotebookGetPageInfo — A Notebook function that returns page information

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

                                                              XmNotebookGetPageInfo(library call)