Poster of Linux kernelThe best gift for a Linux geek
XmNotebookGetPageInfo

XmNotebookGetPageInfo

Section: Misc. Reference Manual Pages (library call)
Local index Up
 

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN
RELATED

This document was created by man2html, using the manual pages.
Time: 21:58:58 GMT, April 16, 2011