![]() |
![]() |
The Gtk::Notebook widget is a Gtk::Container whose children are pages that can be switched between using tab labels along one edge.
You can use the PageList returned by pages() as any normal STL container to manipulate the pages.
Public Types | |
typedef Notebook_Helpers::PageList | PageList |
Public Member Functions | |
int | append_page (Widget& child, const Glib::ustring& tab_label, const Glib::ustring& menu_label, bool use_mnemonic=false) |
int | append_page (Widget& child, Widget& tab_label, Widget& menu_label) |
Appends a page to notebook , specifying the widget to use as the label in the popup menu. | |
int | append_page (Widget& child, const Glib::ustring& tab_label, bool use_mnemonic=false) |
int | append_page (Widget& child) |
int | append_page (Widget& child, Widget& tab_label) |
Appends a page to notebook . | |
PageList::iterator | get_current () |
int | get_current_page () const |
Returns the page number of the current page. | |
const Widget* | get_menu_label (Widget& child) const |
Retrieves the menu label widget of the page containing child . | |
Widget* | get_menu_label (Widget& child) |
Retrieves the menu label widget of the page containing child . | |
Glib::ustring | get_menu_label_text (Widget& child) const |
Retrieves the text of the menu label for the page containing child . | |
int | get_n_pages () |
Gets the number of pages in a notebook. | |
const Widget* | get_nth_page (int page_num) const |
Returns the child widget contained in page number page_num . | |
Widget* | get_nth_page (int page_num) |
Returns the child widget contained in page number page_num . | |
bool | get_scrollable () const |
Returns whether the tab label area has arrows for scrolling. | |
bool | get_show_border () const |
Returns whether a bevel will be drawn around the notebook pages. | |
bool | get_show_tabs () const |
Returns whether the tabs of the notebook are shown. | |
const Widget* | get_tab_label (Widget& child) const |
Returns the tab label widget for the page child . | |
Widget* | get_tab_label (Widget& child) |
Returns the tab label widget for the page child . | |
Glib::ustring | get_tab_label_text (Widget& child) const |
Retrieves the text of the tab label for the page containing child . | |
PositionType | get_tab_pos () const |
Gets the edge at which the tabs for switching pages in the notebook are drawn. | |
const GtkNotebook* | gobj () const |
Provides access to the underlying C GtkObject. | |
GtkNotebook* | gobj () |
Provides access to the underlying C GtkObject. | |
int | insert_page (Widget& child, const Glib::ustring& tab_label, const Glib::ustring& menu_label, int position, bool use_mnemonic=false) |
int | insert_page (Widget& child, Widget& tab_label, Widget& menu_label, int position) |
Insert a page into notebook at the given position, specifying the widget to use as the label in the popup menu. | |
int | insert_page (Widget& child, const Glib::ustring& tab_label, int position, bool use_mnemonic=false) |
int | insert_page (Widget& child, int position) |
int | insert_page (Widget& child, Widget& tab_label, int position) |
Insert a page into notebook at the given position. | |
void | next_page () |
Switches to the next page. | |
Notebook () | |
int | page_num (const Widget& child) |
Finds the index of the page which contains the given child widget. | |
const PageList& | pages () const |
PageList& | pages () |
void | popup_disable () |
Disables the popup menu. | |
void | popup_enable () |
Enables the popup menu: if the user clicks with the right mouse button on the bookmarks, a menu with all the pages will be popped up. | |
int | prepend_page (Widget& child, const Glib::ustring& tab_label, const Glib::ustring& menu_label, bool use_mnemonic) |
int | prepend_page (Widget& child, Widget& tab_label, Widget& menu_label) |
Prepends a page to notebook , specifying the widget to use as the label in the popup menu. | |
int | prepend_page (Widget& child, const Glib::ustring& tab_label, bool use_mnemonic=false) |
int | prepend_page (Widget& child) |
int | prepend_page (Widget& child, Widget& tab_label) |
Prepends a page to notebook . | |
void | prev_page () |
Switches to the previous page. | |
Glib::PropertyProxy_ReadOnly< bool > | property_enable_popup () const |
If TRUE. | |
Glib::PropertyProxy<bool> | property_enable_popup () |
If TRUE. | |
Glib::PropertyProxy_ReadOnly< bool > | property_homogeneous () const |
Whether tabs should have homogeneous sizes. | |
Glib::PropertyProxy<bool> | property_homogeneous () |
Whether tabs should have homogeneous sizes. | |
Glib::PropertyProxy_ReadOnly< int > | property_page () const |
The index of the current page. | |
Glib::PropertyProxy<int> | property_page () |
The index of the current page. | |
Glib::PropertyProxy_ReadOnly< bool > | property_scrollable () const |
If TRUE. | |
Glib::PropertyProxy<bool> | property_scrollable () |
If TRUE. | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_border () const |
Whether the border should be shown or not. | |
Glib::PropertyProxy<bool> | property_show_border () |
Whether the border should be shown or not. | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_tabs () const |
Whether tabs should be shown or not. | |
Glib::PropertyProxy<bool> | property_show_tabs () |
Whether tabs should be shown or not. | |
Glib::PropertyProxy_WriteOnly< guint > | property_tab_border () |
Width of the border around the tab labels. | |
Glib::PropertyProxy_ReadOnly< guint > | property_tab_hborder () const |
Width of the horizontal border of tab labels. | |
Glib::PropertyProxy<guint> | property_tab_hborder () |
Width of the horizontal border of tab labels. | |
Glib::PropertyProxy_ReadOnly< PositionType > | property_tab_pos () const |
Which side of the notebook holds the tabs. | |
Glib::PropertyProxy<PositionType> | property_tab_pos () |
Which side of the notebook holds the tabs. | |
Glib::PropertyProxy_ReadOnly< guint > | property_tab_vborder () const |
Width of the vertical border of tab labels. | |
Glib::PropertyProxy<guint> | property_tab_vborder () |
Width of the vertical border of tab labels. | |
void | query_tab_label_packing (Widget& child, bool& expand, bool& fill, PackType& pack_type) |
void | remove_page (Widget& child) |
void | remove_page (int page_num=0) |
Removes a page from the notebook given its index in the notebook. | |
void | reorder_child (Widget& child, int position) |
Reorders the page containing child , so that it appears in position position . | |
void | set_current_page (int page_num) |
Switches to the page number page_num . | |
void | set_menu_label (Widget& child, Widget& menu_label) |
Changes the menu label for the page containing child . | |
void | set_menu_label_text (Widget& child, const Glib::ustring& menu_text) |
Creates a new label and sets it as the menu label of child . | |
void | set_scrollable (bool scrollable=true) |
Sets whether the tab label area will have arrows for scrolling if there are too many tabs to fit in the area. | |
void | set_show_border (bool show_border=true) |
Sets whether a bevel will be drawn around the notebook pages. | |
void | set_show_tabs (bool show_tabs=true) |
Sets whether to show the tabs for the notebook or not. | |
void | set_tab_label (Widget& child, Widget& tab_label) |
Changes the tab label for child . | |
void | set_tab_label_packing (Widget& child, bool expand, bool fill, PackType pack_type) |
Sets the packing parameters for the tab label of the page containing child . | |
void | set_tab_label_text (Widget& child, const Glib::ustring& tab_text) |
Creates a new label and sets it as the tab label for the page containing child . | |
void | set_tab_pos (PositionType pos) |
Sets the edge at which the tabs for switching pages in the notebook are drawn. | |
Glib::SignalProxy2< void, GtkNotebookPage*, guint > | signal_switch_page () |
virtual | ~Notebook () |
Protected Member Functions | |
virtual void | on_switch_page (GtkNotebookPage* page, guint page_num) |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Notebook* | wrap (GtkNotebook* object, bool take_copy=false) |
|
|
|
|
|
|
|
|
|
Appends a page to notebook , specifying the widget to use as the label in the popup menu.
|
|
|
|
|
|
Appends a page to notebook .
|
|
|
|
Returns the page number of the current page.
|
|
Retrieves the menu label widget of the page containing child .
|
|
Retrieves the menu label widget of the page containing child .
|
|
Retrieves the text of the menu label for the page containing child .
|
|
Gets the number of pages in a notebook.
|
|
Returns the child widget contained in page number page_num .
|
|
Returns the child widget contained in page number page_num .
|
|
Returns whether the tab label area has arrows for scrolling. See set_scrollable().
|
|
Returns whether a bevel will be drawn around the notebook pages. See set_show_border().
|
|
Returns whether the tabs of the notebook are shown. See set_show_tabs().
|
|
Returns the tab label widget for the page child .
|
|
Returns the tab label widget for the page child .
|
|
Retrieves the text of the tab label for the page containing child .
|
|
Gets the edge at which the tabs for switching pages in the notebook are drawn.
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Container. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Container. |
|
|
|
Insert a page into notebook at the given position, specifying the widget to use as the label in the popup menu.
|
|
|
|
|
|
Insert a page into notebook at the given position.
|
|
Switches to the next page. Nothing happens if the current page is the last page. |
|
|
|
Finds the index of the page which contains the given child widget.
|
|
|
|
|
|
Disables the popup menu.
|
|
Enables the popup menu: if the user clicks with the right mouse button on the bookmarks, a menu with all the pages will be popped up.
|
|
|
|
Prepends a page to notebook , specifying the widget to use as the label in the popup menu.
|
|
|
|
|
|
Prepends a page to notebook .
|
|
Switches to the previous page. Nothing happens if the current page is the first page. |
|
If TRUE. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
If TRUE. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether tabs should have homogeneous sizes. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether tabs should have homogeneous sizes. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The index of the current page. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The index of the current page. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
If TRUE. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
If TRUE. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the border should be shown or not. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the border should be shown or not. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether tabs should be shown or not. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether tabs should be shown or not. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Width of the border around the tab labels. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Width of the horizontal border of tab labels. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Width of the horizontal border of tab labels. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Which side of the notebook holds the tabs. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Which side of the notebook holds the tabs. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Width of the vertical border of tab labels. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Width of the vertical border of tab labels. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
|
|
|
|
Removes a page from the notebook given its index in the notebook.
|
|
Reorders the page containing child , so that it appears in position position . If position is greater than or equal to the number of children in the list or negative, child will be moved to the end of the list.
|
|
Switches to the page number page_num .
|
|
Changes the menu label for the page containing child .
|
|
Creates a new label and sets it as the menu label of child .
|
|
Sets whether the tab label area will have arrows for scrolling if there are too many tabs to fit in the area.
|
|
Sets whether a bevel will be drawn around the notebook pages. This only has a visual effect when the tabs are not shown. See set_show_tabs().
|
|
Sets whether to show the tabs for the notebook or not.
|
|
Changes the tab label for child .
If
|
|
Sets the packing parameters for the tab label of the page containing child . See Gtk::Box::pack_start() for the exact meaning of the parameters.
|
|
Creates a new label and sets it as the tab label for the page containing child .
|
|
Sets the edge at which the tabs for switching pages in the notebook are drawn.
|
|
|
|
|