<html> <head><title>Gtk-- Reference: Gtk::Notebook</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Notebook</h1><p> <b> A container which shows only one of it's children at a time, normally subwindows.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AContainer.html">Gtk::Container</a> <br> Derived by: <a href="Gtk::FontSelection.html">Gtk::FontSelection</a> <p> #include <gtk--/notebook.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2173"><tt><font color=blue><b>Notebook</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2197"><tt><font color=blue><b>append_page</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p0</font></tt>, <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p1</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3ANotebook.html#2170">Page</a>*</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2180"><tt><font color=blue><b>get_current</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2181"><tt><font color=blue><b>get_current_child</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2174"><tt><font color=blue><b>get_current_page_num</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2175"><tt><font color=blue><b>get_nth_page</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>page_number</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2184"><tt><font color=blue><b>get_show_border</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2183"><tt><font color=blue><b>get_show_tabs</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkPositionType</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2182"><tt><font color=blue><b>get_tab_pos</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkNotebook</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2166"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkNotebook</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2167"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2168"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2178"><tt><font color=blue><b>next_page</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2176"><tt><font color=blue><b>page_num</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>child</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3ANotebook.html#2172">PageList</a>&</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2198"><tt><font color=blue><b>pages</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <a href="Gtk%3A%3ANotebook.html#2172">PageList</a>&</tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2199"><tt><font color=blue><b>pages</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2194"><tt><font color=blue><b>popup_disable</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2193"><tt><font color=blue><b>popup_enable</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2196"><tt><font color=blue><b>prepend_page</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p0</font></tt>, <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p1</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2179"><tt><font color=blue><b>prev_page</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2188"><tt><font color=blue><b>set_homogeneous_tabs</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>homogeneous</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2177"><tt><font color=blue><b>set_page</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>page_number</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2192"><tt><font color=blue><b>set_scrollable</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>scrollable</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2185"><tt><font color=blue><b>set_show_border</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>show_border</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2186"><tt><font color=blue><b>set_show_tabs</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>show_tabs</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2189"><tt><font color=blue><b>set_tab_border</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>border_width</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2190"><tt><font color=blue><b>set_tab_hborder</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>tab_hborder</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2187"><tt><font color=blue><b>set_tab_pos</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkPositionType</font></tt> <tt><font color=blue>pos</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2191"><tt><font color=blue><b>set_tab_vborder</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>tab_vborder</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>emitable</tt> <tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2195"><tt><font color=blue><b>switch_page</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3ANotebook_Helpers%3A%3APage.html"><tt><font color=navy><b>Page</b></font></tt></a>*, <tt><font color=purple>guint</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2169"><tt><font color=blue><b>~Notebook</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ANotebook.html#2200"><tt><font color=blue><b>switch_page_impl</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3ANotebook_Helpers%3A%3APage.html"><tt><font color=navy><b>Page</b></font></tt></a>* <tt><font color=blue>p0</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>p1</font></tt>)</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> The <tt><font color=navy><b>Gtk::Notebook</b></font></tt> widget is a <tt><font color=navy><b>Gtk::Container</b></font></tt> whose children are pages that can be accessed through bookmarks. The pages are displayed all at the same place.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2197"><font size=+1><b>Gtk::Notebook::append_page</b></font></a> - (deprecated)<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2197"><tt><font color=blue><b>append_page</b></font></tt></a><tt>(<a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p0</font></tt>, <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p1</font></tt>)</tt>;<br><br> <a name="2174"><font size=+1><b>Gtk::Notebook::get_current_page_num</b></font></a> - Returns the page number of the current page.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gint</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2174"><tt><font color=blue><b>get_current_page_num</b></font></tt></a><tt>() <tt>const</tt></tt>;<br><blockquote> Returns: The page number.</blockquote> <br><br> <a name="2175"><font size=+1><b>Gtk::Notebook::get_nth_page</b></font></a> - Returns the content of the page number page_num, or NULL if page_num is out of bounds.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>*</tt> <a href="Gtk%3A%3ANotebook.html#2175"><tt><font color=blue><b>get_nth_page</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>page_number</font></tt>)</tt>;<br><blockquote> page_num: The page number. Returns: The content of the page.</blockquote> <br><br> <a name="2166"><font size=+1><b>Gtk::Notebook::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkNotebook</font></tt>*</tt> <a href="Gtk%3A%3ANotebook.html#2166"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="2168"><font size=+1><b>Gtk::Notebook::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2168"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="2178"><font size=+1><b>Gtk::Notebook::next_page</b></font></a> - Switches to the next page. Nothing happens if the current page is the last page.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2178"><tt><font color=blue><b>next_page</b></font></tt></a><tt>()</tt>;<br><br> <a name="2176"><font size=+1><b>Gtk::Notebook::page_num</b></font></a> - Returns the page number of child in notebook.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gint</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2176"><tt><font color=blue><b>page_num</b></font></tt></a><tt>(<tt>const</tt> <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>child</font></tt>)</tt>;<br><blockquote> child: The child. Returns: The page number, or -1 if child is not in notebook.</blockquote> <br><br> <a name="2194"><font size=+1><b>Gtk::Notebook::popup_disable</b></font></a> - Disables the popup menu.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2194"><tt><font color=blue><b>popup_disable</b></font></tt></a><tt>()</tt>;<br><br> <a name="2193"><font size=+1><b>Gtk::Notebook::popup_enable</b></font></a> - Enables the popup menu.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2193"><tt><font color=blue><b>popup_enable</b></font></tt></a><tt>()</tt>;<br><blockquote> If the user clicks with the right mouse button on the bookmarks, a menu with all the pages will be popped up.</blockquote> <br><br> <a name="2196"><font size=+1><b>Gtk::Notebook::prepend_page</b></font></a> - (deprecated)<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2196"><tt><font color=blue><b>prepend_page</b></font></tt></a><tt>(<a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p0</font></tt>, <a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>p1</font></tt>)</tt>;<br><br> <a name="2179"><font size=+1><b>Gtk::Notebook::prev_page</b></font></a> - Switches to the previous page. Nothing happens if the current page is the first page.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2179"><tt><font color=blue><b>prev_page</b></font></tt></a><tt>()</tt>;<br><br> <a name="2188"><font size=+1><b>Gtk::Notebook::set_homogeneous_tabs</b></font></a> - Sets whether the tabs must have all the same size or not.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2188"><tt><font color=blue><b>set_homogeneous_tabs</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>homogeneous</font></tt>)</tt>;<br><br> <a name="2177"><font size=+1><b>Gtk::Notebook::set_page</b></font></a> - Switches to the page number page_num.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2177"><tt><font color=blue><b>set_page</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>page_number</font></tt>)</tt>;<br><blockquote> Negative values stand for the last page; too large values are ignored. <P> page_num: The page number.</blockquote> <br><br> <a name="2192"><font size=+1><b>Gtk::Notebook::set_scrollable</b></font></a> - Sets whether the bookmarks area may be scrollable or not if there are too many bookmarks to fit in the allocated area.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2192"><tt><font color=blue><b>set_scrollable</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>scrollable</font></tt>)</tt>;<br><br> <a name="2185"><font size=+1><b>Gtk::Notebook::set_show_border</b></font></a> - Sets whether to show the border of the notebook or not. Bookmarks are in the border.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2185"><tt><font color=blue><b>set_show_border</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>show_border</font></tt>)</tt>;<br><br> <a name="2186"><font size=+1><b>Gtk::Notebook::set_show_tabs</b></font></a> - Sets whether to show the bookmarks or not.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2186"><tt><font color=blue><b>set_show_tabs</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>show_tabs</font></tt>)</tt>;<br><br> <a name="2189"><font size=+1><b>Gtk::Notebook::set_tab_border</b></font></a> - Sets whether there should be a border around the bookmarks or not.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2189"><tt><font color=blue><b>set_tab_border</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>border_width</font></tt>)</tt>;<br><br> <a name="2190"><font size=+1><b>Gtk::Notebook::set_tab_hborder</b></font></a> - Sets whether the tabs should have a horizontal border.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2190"><tt><font color=blue><b>set_tab_hborder</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>tab_hborder</font></tt>)</tt>;<br><br> <a name="2187"><font size=+1><b>Gtk::Notebook::set_tab_pos</b></font></a> - pos is one of <tt><font color=green>GTK_POS_LEFT</font></tt>, <tt><font color=green>GTK_POS_RIGHT</font></tt>, <tt><font color=green>GTK_POS_TOP</font></tt>, <tt><font color=green>GTK_POS_BOTTOM</font></tt>.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2187"><tt><font color=blue><b>set_tab_pos</b></font></tt></a><tt>(<tt><font color=navy>GtkPositionType</font></tt> <tt><font color=blue>pos</font></tt>)</tt>;<br><br> <a name="2191"><font size=+1><b>Gtk::Notebook::set_tab_vborder</b></font></a> - Sets whether the tabs should have a vertical border.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ANotebook.html#2191"><tt><font color=blue><b>set_tab_vborder</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>tab_vborder</font></tt>)</tt>;<br><br> <hr noshade> </html>