GtkNotebook
A tabbed notebook container
Object Hierarchy
Description
The GtkNotebook widget is a GtkContainer whose children are pages that can be switched between using tab labels along one edge.
There are many configuration options for GtkNotebook. Among other things, you can choose on which edge the tabs appear (see set_tab_pos() ), whether, if there are too many tabs to fit the noteobook should be made bigger or scrolling arrows added (see set_scrollable() ), and whether there will be a popup menu allowing the users to switch pages. (see popup_enable() , popup_disable() )
Constructors
GtkNotebook ();-- Creates a new GtkNotebook widget with no pages.
Methods
append_page() Appends a new page to the notebook. append_page_menu() FIXME: should be merged into append_page current_page() DEPRECATED. get_current_page() Returns the page number of the current page. get_menu_label() Retrieves the menu label widget of the page containing child. get_menu_label_text() Retrieves the text of the menu label for the page containing child. get_n_pages() Gets the number of pages in a notebook. get_nth_page() Returns the child widget contained in the given page number. get_scrollable() Returns whether the tab label area has arrows for scrolling. get_show_border() Returns whether a bevel will be drawn around the notebook pages. get_show_tabs() Returns whether the tabs of the notebook are shown. get_tab_label() Returns the tab label widget for the page child. get_tab_label_text() Retrieves the text of the tab label for the page containing child. get_tab_pos() Gets the edge at which the tabs are drawn. insert_page() Insert a page into notebook at the given position. insert_page_menu() FIXME: Should be merged with insert_page next_page() Switches to the next page. page_num() Finds the index of the page which contains the given child widget. popup_disable() Disables the popup menu. popup_enable() Enables the popup menu. prepend_page() Prepends a page to the notebook. prepend_page_menu() FIXME: Should be merged with prepend_page prev_page() Switches to the previous page. remove_page() Removes a page from the notebook. reorder_child() Reorders the page containing child. set_current_page() Switches to the given page number. set_homogeneous_tabs() DEPRECATED. Sets whether the tabs must have all the same size or not. set_menu_label() Changes the menu label for the page. set_menu_label_text() Creates a new label and sets it as the menu label. set_page() DEPRECATED. set_scrollable() Sets whether the tab label area will have arrows for scrolling. set_show_border() Sets whether a bevel will be drawn around the notebook pages. set_show_tabs() Sets whether to show the tabs for the notebook or not. set_tab_border() DEPRECATED. set_tab_hborder() DEPRECATED. set_tab_label() Changes the tab label for a child. set_tab_label_packing() Sets the packing parameters for the tab label set_tab_label_text() Creates a new label for a child. set_tab_pos() Sets the edge at which the tabs are drawn. set_tab_vborder() DEPRECATED.
Fields
tab_pos: Which side of the notebook holds the tabs.
Signals
"change-current-page" Another page has been made active. "focus-tab" A tab got the focus. "move-focus-out" "select-page" A page has been selected "switch-page" The page has been switched.