redhat man page for xmnotebookgetpageinfo

XmNotebookGetPageInfo(library call)									       XmNotebookGetPageInfo(library call)

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)