<refentry id="GtkNotebook">
<refmeta>
<refentrytitle>GtkNotebook</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkNotebook</refname><refpurpose>A tabbed notebook container.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkNotebook-struct">GtkNotebook</link>;
struct      <link linkend="GtkNotebookPage">GtkNotebookPage</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-notebook-new">gtk_notebook_new</link>                (void);
void        <link linkend="gtk-notebook-append-page">gtk_notebook_append_page</link>        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);
void        <link linkend="gtk-notebook-append-page-menu">gtk_notebook_append_page_menu</link>   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);
void        <link linkend="gtk-notebook-prepend-page">gtk_notebook_prepend_page</link>       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);
void        <link linkend="gtk-notebook-prepend-page-menu">gtk_notebook_prepend_page_menu</link>  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);
void        <link linkend="gtk-notebook-insert-page">gtk_notebook_insert_page</link>        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="gint">gint</link> position);
void        <link linkend="gtk-notebook-insert-page-menu">gtk_notebook_insert_page_menu</link>   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label,
                                             <link linkend="gint">gint</link> position);
void        <link linkend="gtk-notebook-remove-page">gtk_notebook_remove_page</link>        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);
#define     <link linkend="gtk-notebook-current-page">gtk_notebook_current_page</link>
<link linkend="gint">gint</link>        <link linkend="gtk-notebook-page-num">gtk_notebook_page_num</link>           (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);
#define     <link linkend="gtk-notebook-set-page">gtk_notebook_set_page</link>
void        <link linkend="gtk-notebook-next-page">gtk_notebook_next_page</link>          (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
void        <link linkend="gtk-notebook-prev-page">gtk_notebook_prev_page</link>          (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
void        <link linkend="gtk-notebook-reorder-child">gtk_notebook_reorder_child</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gint">gint</link> position);
void        <link linkend="gtk-notebook-set-tab-pos">gtk_notebook_set_tab_pos</link>        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkPositionType">GtkPositionType</link> pos);
void        <link linkend="gtk-notebook-set-show-tabs">gtk_notebook_set_show_tabs</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> show_tabs);
void        <link linkend="gtk-notebook-set-show-border">gtk_notebook_set_show_border</link>    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> show_border);
void        <link linkend="gtk-notebook-set-scrollable">gtk_notebook_set_scrollable</link>     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> scrollable);
void        <link linkend="gtk-notebook-set-tab-border">gtk_notebook_set_tab_border</link>     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> border_width);
void        <link linkend="gtk-notebook-popup-enable">gtk_notebook_popup_enable</link>       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
void        <link linkend="gtk-notebook-popup-disable">gtk_notebook_popup_disable</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
<link linkend="gint">gint</link>        <link linkend="gtk-notebook-get-current-page">gtk_notebook_get_current_page</link>   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-notebook-get-menu-label">gtk_notebook_get_menu_label</link>     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-notebook-get-nth-page">gtk_notebook_get_nth_page</link>       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-notebook-get-tab-label">gtk_notebook_get_tab_label</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);
void        <link linkend="gtk-notebook-query-tab-label-packing">gtk_notebook_query_tab_label_packing</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gboolean">gboolean</link> *expand,
                                             <link linkend="gboolean">gboolean</link> *fill,
                                             <link linkend="GtkPackType">GtkPackType</link> *pack_type);
void        <link linkend="gtk-notebook-set-homogeneous-tabs">gtk_notebook_set_homogeneous_tabs</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> homogeneous);
void        <link linkend="gtk-notebook-set-menu-label">gtk_notebook_set_menu_label</link>     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);
void        <link linkend="gtk-notebook-set-menu-label-text">gtk_notebook_set_menu_label_text</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             const <link linkend="gchar">gchar</link> *menu_text);
void        <link linkend="gtk-notebook-set-tab-hborder">gtk_notebook_set_tab_hborder</link>    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> tab_hborder);
void        <link linkend="gtk-notebook-set-tab-label">gtk_notebook_set_tab_label</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);
void        <link linkend="gtk-notebook-set-tab-label-packing">gtk_notebook_set_tab_label_packing</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gboolean">gboolean</link> expand,
                                             <link linkend="gboolean">gboolean</link> fill,
                                             <link linkend="GtkPackType">GtkPackType</link> pack_type);
void        <link linkend="gtk-notebook-set-tab-label-text">gtk_notebook_set_tab_label_text</link> (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             const <link linkend="gchar">gchar</link> *tab_text);
void        <link linkend="gtk-notebook-set-tab-vborder">gtk_notebook_set_tab_vborder</link>    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> tab_vborder);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gtk-notebook-get-menu-label-text">gtk_notebook_get_menu_label_text</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-notebook-get-scrollable">gtk_notebook_get_scrollable</link>     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-notebook-get-show-border">gtk_notebook_get_show_border</link>    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-notebook-get-show-tabs">gtk_notebook_get_show_tabs</link>      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gtk-notebook-get-tab-label-text">gtk_notebook_get_tab_label_text</link>
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);
<link linkend="GtkPositionType">GtkPositionType</link> <link linkend="gtk-notebook-get-tab-pos">gtk_notebook_get_tab_pos</link>    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);
void        <link linkend="gtk-notebook-set-current-page">gtk_notebook_set_current_page</link>   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkWidget">GtkWidget</link>
               +----<link linkend="GtkContainer">GtkContainer</link>
                     +----GtkNotebook
</synopsis>

</refsect1>

<refsect1>
<title>Properties</title>
<synopsis>

  &quot;<link linkend="GtkNotebook--tab-pos">tab-pos</link>&quot;              <link linkend="GtkPositionType">GtkPositionType</link>      : Read / Write
  &quot;<link linkend="GtkNotebook--show-tabs">show-tabs</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkNotebook--show-border">show-border</link>&quot;          <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkNotebook--scrollable">scrollable</link>&quot;           <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkNotebook--tab-border">tab-border</link>&quot;           <link linkend="guint">guint</link>                : Write
  &quot;<link linkend="GtkNotebook--tab-hborder">tab-hborder</link>&quot;          <link linkend="guint">guint</link>                : Read / Write
  &quot;<link linkend="GtkNotebook--tab-vborder">tab-vborder</link>&quot;          <link linkend="guint">guint</link>                : Read / Write
  &quot;<link linkend="GtkNotebook--page">page</link>&quot;                 <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkNotebook--enable-popup">enable-popup</link>&quot;         <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkNotebook--homogeneous">homogeneous</link>&quot;          <link linkend="gboolean">gboolean</link>             : Read / Write
</synopsis>
</refsect1>

<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkNotebook-change-current-page">change-current-page</link>&quot;
            void        user_function      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="gint">gint</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkNotebook-focus-tab">focus-tab</link>&quot; <link linkend="gboolean">gboolean</link>    user_function      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkNotebookTab">GtkNotebookTab</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkNotebook-move-focus-out">move-focus-out</link>&quot;
            void        user_function      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkDirectionType">GtkDirectionType</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkNotebook-select-page">select-page</link>&quot;
            <link linkend="gboolean">gboolean</link>    user_function      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="gboolean">gboolean</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkNotebook-switch-page">switch-page</link>&quot;
            void        user_function      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkNotebookPage">GtkNotebookPage</link> *page,
                                            <link linkend="gint">gint</link> page_num,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
The <link linkend="GtkNotebook">GtkNotebook</link> widget is a <link linkend="GtkContainer">GtkContainer</link> whose children are pages that
can be switched between using tab labels along one edge.
</para>
<para>
There are many configuration options for <link linkend="GtkNotebook">GtkNotebook</link>. Among other
things, you can choose on which edge the tabs appear
(see <link linkend="gtk-notebook-set-tab-pos">gtk_notebook_set_tab_pos</link>()), whether, if there are too many
tabs to fit the noteobook should be made bigger or scrolling
arrows added (see gtk_notebook_set_scrollable), and whether there
will be a popup menu allowing the users to switch pages.
(see <link linkend="gtk-notebook-enable-popup">gtk_notebook_enable_popup</link>(), <link linkend="gtk-noteobook-disable-popup">gtk_noteobook_disable_popup</link>())
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkNotebook-struct">struct GtkNotebook</title>
<programlisting>struct GtkNotebook;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GtkNotebookPage">struct GtkNotebookPage</title>
<programlisting>struct GtkNotebookPage;</programlisting>
<para>
The <link linkend="GtkNotebookPage">GtkNotebookPage</link> is an opaque implementation detail of <link linkend="GtkNotebook">GtkNotebook</link>.
</para></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-new">gtk_notebook_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_notebook_new                (void);</programlisting>
<para>
Creates a new <link linkend="GtkNotebook">GtkNotebook</link> widget with no pages.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the newly created <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-append-page">gtk_notebook_append_page ()</title>
<programlisting>void        gtk_notebook_append_page        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);</programlisting>
<para>
Appends a page to <parameter>notebook</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-append-page-menu">gtk_notebook_append_page_menu ()</title>
<programlisting>void        gtk_notebook_append_page_menu   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);</programlisting>
<para>
Appends a page to <parameter>notebook</parameter>, specifying the widget to use as the
label in the popup menu.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
<row><entry align="right"><parameter>menu_label</parameter>&nbsp;:</entry>
<entry> the widget to use as a label for the page-switch
             menu, if that is enabled. If <literal>NULL</literal>, and <parameter>tab_label</parameter>
             is a <link linkend="GtkLabel">GtkLabel</link> or <literal>NULL</literal>, then the menu label will be
             a newly created label with the same text as <parameter>tab_label</parameter>;
             If <parameter>tab_label</parameter> is not a <link linkend="GtkLabel">GtkLabel</link>, <parameter>menu_label</parameter> must be
             specified if the page-switch menu is to be used.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-prepend-page">gtk_notebook_prepend_page ()</title>
<programlisting>void        gtk_notebook_prepend_page       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);</programlisting>
<para>
Prepends a page to <parameter>notebook</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-prepend-page-menu">gtk_notebook_prepend_page_menu ()</title>
<programlisting>void        gtk_notebook_prepend_page_menu  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);</programlisting>
<para>
Prepends a page to <parameter>notebook</parameter>, specifying the widget to use as the
label in the popup menu.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
<row><entry align="right"><parameter>menu_label</parameter>&nbsp;:</entry>
<entry> the widget to use as a label for the page-switch
             menu, if that is enabled. If <literal>NULL</literal>, and <parameter>tab_label</parameter>
             is a <link linkend="GtkLabel">GtkLabel</link> or <literal>NULL</literal>, then the menu label will be
             a newly created label with the same text as <parameter>tab_label</parameter>;
             If <parameter>tab_label</parameter> is not a <link linkend="GtkLabel">GtkLabel</link>, <parameter>menu_label</parameter> must be
             specified if the page-switch menu is to be used.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-insert-page">gtk_notebook_insert_page ()</title>
<programlisting>void        gtk_notebook_insert_page        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="gint">gint</link> position);</programlisting>
<para>
Insert a page into <parameter>notebook</parameter> at the given position</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry> the index (starting at 0) at which to insert the page,
           or -1 to append the page after all other pages.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-insert-page-menu">gtk_notebook_insert_page_menu ()</title>
<programlisting>void        gtk_notebook_insert_page_menu   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label,
                                             <link linkend="gint">gint</link> position);</programlisting>
<para>
Insert a page into <parameter>notebook</parameter> at the given position, specifying
the widget to use as the label in the popup menu.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to use as the contents of the page.
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkWidget">GtkWidget</link> to be used as the label for the page,
            or <literal>NULL</literal> to use the default label, 'page N'.
</entry></row>
<row><entry align="right"><parameter>menu_label</parameter>&nbsp;:</entry>
<entry> the widget to use as a label for the page-switch
             menu, if that is enabled. If <literal>NULL</literal>, and <parameter>tab_label</parameter>
             is a <link linkend="GtkLabel">GtkLabel</link> or <literal>NULL</literal>, then the menu label will be
             a newly created label with the same text as <parameter>tab_label</parameter>;
             If <parameter>tab_label</parameter> is not a <link linkend="GtkLabel">GtkLabel</link>, <parameter>menu_label</parameter> must be
             specified if the page-switch menu is to be used.
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry> the index (starting at 0) at which to insert the page,
           or -1 to append the page after all other pages.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-remove-page">gtk_notebook_remove_page ()</title>
<programlisting>void        gtk_notebook_remove_page        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);</programlisting>
<para>
Removes a page from the notebook given its index
in the notebook.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>.
</entry></row>
<row><entry align="right"><parameter>page_num</parameter>&nbsp;:</entry>
<entry> the index of a notebook page, starting
           from 0. If -1, the last page will
           be removed.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-current-page">gtk_notebook_current_page</title>
<programlisting>#define	gtk_notebook_current_page               gtk_notebook_get_current_page
</programlisting>
<warning>
<para>
<literal>gtk_notebook_current_page</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Deprecated compatibility macro. Use
<link linkend="gtk-notebook-get-current-page">gtk_notebook_get_current_page</link>() instead.
</para></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-page-num">gtk_notebook_page_num ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_notebook_page_num           (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
<para>
Finds the index of the page which contains the given child
widget.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkWidget">GtkWidget</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the index of the page containing <parameter>child</parameter>, or
  -1 if <parameter>child</parameter> is not in the notebook.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-page">gtk_notebook_set_page</title>
<programlisting>#define gtk_notebook_set_page                   gtk_notebook_set_current_page
</programlisting>
<warning>
<para>
<literal>gtk_notebook_set_page</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Deprecated compatibility macro. Use
<link linkend="gtk-notebook-set-current-page">gtk_notebook_set_current_page</link>() instead.
</para></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-next-page">gtk_notebook_next_page ()</title>
<programlisting>void        gtk_notebook_next_page          (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Switches to the next page. Nothing happens if the current page is
the last page.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-prev-page">gtk_notebook_prev_page ()</title>
<programlisting>void        gtk_notebook_prev_page          (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Switches to the previous page. Nothing happens if the current page
is the first page.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-reorder-child">gtk_notebook_reorder_child ()</title>
<programlisting>void        gtk_notebook_reorder_child      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gint">gint</link> position);</programlisting>
<para>
Reorders the page containing <parameter>child</parameter>, so that it appears in position
<parameter>position</parameter>. If <parameter>position</parameter> is greater than or equal to the number of
children in the list or negative, <parameter>child</parameter> will be moved to the end
of the list.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the child to move
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry> the new position, or -1 to move to the end
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-pos">gtk_notebook_set_tab_pos ()</title>
<programlisting>void        gtk_notebook_set_tab_pos        (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkPositionType">GtkPositionType</link> pos);</programlisting>
<para>
Sets the edge at which the tabs for switching pages in the
notebook are drawn.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>.
</entry></row>
<row><entry align="right"><parameter>pos</parameter>&nbsp;:</entry>
<entry> the edge to draw the tabs at.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-show-tabs">gtk_notebook_set_show_tabs ()</title>
<programlisting>void        gtk_notebook_set_show_tabs      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> show_tabs);</programlisting>
<para>
Sets whether to show the tabs for the notebook or not.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>show_tabs</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if the tabs should be shown.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-show-border">gtk_notebook_set_show_border ()</title>
<programlisting>void        gtk_notebook_set_show_border    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> show_border);</programlisting>
<para>
Sets whether a bevel will be drawn around the notebook pages.
This only has a visual effect when the tabs are not shown.
See <link linkend="gtk-notebook-set-show-tabs">gtk_notebook_set_show_tabs</link>().</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>show_border</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if a bevel should be drawn around the notebook.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-scrollable">gtk_notebook_set_scrollable ()</title>
<programlisting>void        gtk_notebook_set_scrollable     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> scrollable);</programlisting>
<para>
Sets whether the tab label area will have arrows for scrolling if
there are too many tabs to fit in the area.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>scrollable</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if scroll arrows should be added
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-border">gtk_notebook_set_tab_border ()</title>
<programlisting>void        gtk_notebook_set_tab_border     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> border_width);</programlisting>
<warning>
<para>
<literal>gtk_notebook_set_tab_border</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Sets the width the border around the tab labels
in a notebook. This is equivalent to calling
gtk_notebook_set_tab_hborder (<parameter>notebook</parameter>, <parameter>border_width</parameter>) followed
by gtk_notebook_set_tab_vborder (<parameter>notebook</parameter>, <parameter>border_width</parameter>).</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>border_width</parameter>&nbsp;:</entry>
<entry> width of the border around the tab labels.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-popup-enable">gtk_notebook_popup_enable ()</title>
<programlisting>void        gtk_notebook_popup_enable       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
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.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-popup-disable">gtk_notebook_popup_disable ()</title>
<programlisting>void        gtk_notebook_popup_disable      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Disables the popup menu.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-current-page">gtk_notebook_get_current_page ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_notebook_get_current_page   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Returns the page number of the current page.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the index (starting from 0) of the current
page in the notebook. If the notebook has no pages, then
-1 will be returned.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-menu-label">gtk_notebook_get_menu_label ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_notebook_get_menu_label     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
<para>
Retrieves the menu label widget of the page containing <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> a widget contained in a page of <parameter>notebook</parameter>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the menu label, or <literal>NULL</literal> if the
              notebook page does not have a menu label other
              than the default (the tab label).
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-nth-page">gtk_notebook_get_nth_page ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_notebook_get_nth_page       (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);</programlisting>
<para>
Returns the child widget contained in page number <parameter>page_num</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>page_num</parameter>&nbsp;:</entry>
<entry> the index of a page in the noteobok
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the child widget, or <literal>NULL</literal> if <parameter>page_num</parameter> is
out of bounds.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-tab-label">gtk_notebook_get_tab_label ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_notebook_get_tab_label      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
<para>
Returns the tab label widget for the page <parameter>child</parameter>. <literal>NULL</literal> is returned
if <parameter>child</parameter> is not in <parameter>notebook</parameter> or if no tab label has specifically
been set for <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the page
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the tab label
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-query-tab-label-packing">gtk_notebook_query_tab_label_packing ()</title>
<programlisting>void        gtk_notebook_query_tab_label_packing
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gboolean">gboolean</link> *expand,
                                             <link linkend="gboolean">gboolean</link> *fill,
                                             <link linkend="GtkPackType">GtkPackType</link> *pack_type);</programlisting>
<para>
Query the packing attributes for the tab label of the page
containing <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the page
</entry></row>
<row><entry align="right"><parameter>expand</parameter>&nbsp;:</entry>
<entry> location to store the expand value (or NULL)
</entry></row>
<row><entry align="right"><parameter>fill</parameter>&nbsp;:</entry>
<entry> location to store the fill value (or NULL)
</entry></row>
<row><entry align="right"><parameter>pack_type</parameter>&nbsp;:</entry>
<entry> location to store the pack_type (or NULL)
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-homogeneous-tabs">gtk_notebook_set_homogeneous_tabs ()</title>
<programlisting>void        gtk_notebook_set_homogeneous_tabs
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gboolean">gboolean</link> homogeneous);</programlisting>
<warning>
<para>
<literal>gtk_notebook_set_homogeneous_tabs</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Sets whether the tabs must have all the same size or not.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>homogeneous</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if all tabs should be the same size.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-menu-label">gtk_notebook_set_menu_label ()</title>
<programlisting>void        gtk_notebook_set_menu_label     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *menu_label);</programlisting>
<para>
Changes the menu label for the page containing <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the child widget
</entry></row>
<row><entry align="right"><parameter>menu_label</parameter>&nbsp;:</entry>
<entry> the menu label, or NULL for default
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-menu-label-text">gtk_notebook_set_menu_label_text ()</title>
<programlisting>void        gtk_notebook_set_menu_label_text
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             const <link linkend="gchar">gchar</link> *menu_text);</programlisting>
<para>
Creates a new label and sets it as the menu label of <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the child widget
</entry></row>
<row><entry align="right"><parameter>menu_text</parameter>&nbsp;:</entry>
<entry> the label text
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-hborder">gtk_notebook_set_tab_hborder ()</title>
<programlisting>void        gtk_notebook_set_tab_hborder    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> tab_hborder);</programlisting>
<warning>
<para>
<literal>gtk_notebook_set_tab_hborder</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Sets the width of the horizontal border of tab labels.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>tab_hborder</parameter>&nbsp;:</entry>
<entry> width of the horizontal border of tab labels.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-label">gtk_notebook_set_tab_label ()</title>
<programlisting>void        gtk_notebook_set_tab_label      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="GtkWidget">GtkWidget</link> *tab_label);</programlisting>
<para>
Changes the tab label for <parameter>child</parameter>. If <literal>NULL</literal> is specified
for <parameter>tab_label</parameter>, then the page will have the label 'page N'.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the page
</entry></row>
<row><entry align="right"><parameter>tab_label</parameter>&nbsp;:</entry>
<entry> the tab label widget to use, or <literal>NULL</literal> for default tab
            label.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-label-packing">gtk_notebook_set_tab_label_packing ()</title>
<programlisting>void        gtk_notebook_set_tab_label_packing
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             <link linkend="gboolean">gboolean</link> expand,
                                             <link linkend="gboolean">gboolean</link> fill,
                                             <link linkend="GtkPackType">GtkPackType</link> pack_type);</programlisting>
<para>
Sets the packing parameters for the tab label of the page
containing <parameter>child</parameter>. See <link linkend="gtk-box-pack-start">gtk_box_pack_start</link>() for the exact meaning
of the parameters.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the child widget
</entry></row>
<row><entry align="right"><parameter>expand</parameter>&nbsp;:</entry>
<entry> whether to expand the bookmark or not
</entry></row>
<row><entry align="right"><parameter>fill</parameter>&nbsp;:</entry>
<entry> whether the bookmark should fill the allocated area or not
</entry></row>
<row><entry align="right"><parameter>pack_type</parameter>&nbsp;:</entry>
<entry> the position of the bookmark
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-label-text">gtk_notebook_set_tab_label_text ()</title>
<programlisting>void        gtk_notebook_set_tab_label_text (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child,
                                             const <link linkend="gchar">gchar</link> *tab_text);</programlisting>
<para>
Creates a new label and sets it as the tab label for the page
containing <parameter>child</parameter>.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the page
</entry></row>
<row><entry align="right"><parameter>tab_text</parameter>&nbsp;:</entry>
<entry> the label text
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-tab-vborder">gtk_notebook_set_tab_vborder ()</title>
<programlisting>void        gtk_notebook_set_tab_vborder    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="guint">guint</link> tab_vborder);</programlisting>
<warning>
<para>
<literal>gtk_notebook_set_tab_vborder</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>
Sets the width of the vertical border of tab labels.</para>
<para>
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>tab_vborder</parameter>&nbsp;:</entry>
<entry> width of the vertical border of tab labels.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-menu-label-text">gtk_notebook_get_menu_label_text ()</title>
<programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gtk_notebook_get_menu_label_text
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
<para>
Retrieves the text of the menu label for the page containing
   <parameter>child</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> the child widget of a page of the notebook.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>value: the text of the tab label, or <literal>NULL</literal> if the
               widget does not have a menu label other than
               the default menu label, or the menu label widget
               is not a <link linkend="GtkLabel">GtkLabel</link>. The string is owned by
               the widget and must not be freed.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-scrollable">gtk_notebook_get_scrollable ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_notebook_get_scrollable     (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Returns whether the tab label area has arrows for scrolling. See
<link linkend="gtk-notebook-set-scrollable">gtk_notebook_set_scrollable</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <literal>TRUE</literal> if arrows for scrolling are present
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-show-border">gtk_notebook_get_show_border ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_notebook_get_show_border    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Returns whether a bevel will be drawn around the notebook pages. See
<link linkend="gtk-notebook-set-show-border">gtk_notebook_set_show_border</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <literal>TRUE</literal> if the bevel is drawn
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-show-tabs">gtk_notebook_get_show_tabs ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_notebook_get_show_tabs      (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Returns whether the tabs of the notebook are shown. See
<link linkend="gtk-notebook-set-show-tabs">gtk_notebook_set_show_tabs</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <literal>TRUE</literal> if the tabs are shown
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-tab-label-text">gtk_notebook_get_tab_label_text ()</title>
<programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gtk_notebook_get_tab_label_text
                                            (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
<para>
Retrieves the text of the tab label for the page containing
   <parameter>child</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>child</parameter>&nbsp;:</entry>
<entry> a widget contained in a page of <parameter>notebook</parameter>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>value: the text of the tab label, or <literal>NULL</literal> if the
               tab label widget is not a <link linkend="GtkLabel">GtkLabel</link>. The
               string is owned by the widget and must not
               be freed.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-get-tab-pos">gtk_notebook_get_tab_pos ()</title>
<programlisting><link linkend="GtkPositionType">GtkPositionType</link> gtk_notebook_get_tab_pos    (<link linkend="GtkNotebook">GtkNotebook</link> *notebook);</programlisting>
<para>
Gets the edge at which the tabs for switching pages in the
notebook are drawn.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the edge at which the tabs are drawn
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-notebook-set-current-page">gtk_notebook_set_current_page ()</title>
<programlisting>void        gtk_notebook_set_current_page   (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                             <link linkend="gint">gint</link> page_num);</programlisting>
<para>
Switches to the page number <parameter>page_num</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkNotebook">GtkNotebook</link>
</entry></row>
<row><entry align="right"><parameter>page_num</parameter>&nbsp;:</entry>
<entry> index of the page to switch to, starting from 0.
           If negative, the last page will be used. If greater
           than the number of pages in the notebook, nothing
           will be done.
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GtkNotebook--tab-pos">&quot;<literal>tab-pos</literal>&quot; (<link linkend="GtkPositionType">GtkPositionType</link> : Read / Write)</term>
<listitem>
<para>
The edge at which the tabs for switching pages are drawn.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--show-tabs">&quot;<literal>show-tabs</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether to show tabs for the notebook pages.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--show-border">&quot;<literal>show-border</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether to draw a bevel around the noteobook.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--scrollable">&quot;<literal>scrollable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether the tab label area will have arrows for scrolling if there
are too many tabs to fit in the area.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--tab-border">&quot;<literal>tab-border</literal>&quot; (<link linkend="guint">guint</link> : Write)</term>
<listitem>
<para>
Whether the tab labels have a border on all sides.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--tab-hborder">&quot;<literal>tab-hborder</literal>&quot; (<link linkend="guint">guint</link> : Read / Write)</term>
<listitem>
<para>
Whether the tab labels have a horizontal border.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--tab-vborder">&quot;<literal>tab-vborder</literal>&quot; (<link linkend="guint">guint</link> : Read / Write)</term>
<listitem>
<para>
Whether the tab labels have a vertical border.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--page">&quot;<literal>page</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>
The current page
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--enable-popup">&quot;<literal>enable-popup</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
Whether the popup menu for switching pages is enabled.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkNotebook--homogeneous">&quot;<literal>homogeneous</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
whether the tabs must have all the same size.
</para></listitem></varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkNotebook-change-current-page">The &quot;change-current-page&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="gint">gint</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkNotebook-focus-tab">The &quot;focus-tab&quot; signal</title>
<programlisting><link linkend="gboolean">gboolean</link>    user_function                  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkNotebookTab">GtkNotebookTab</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkNotebook-move-focus-out">The &quot;move-focus-out&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkDirectionType">GtkDirectionType</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkNotebook-select-page">The &quot;select-page&quot; signal</title>
<programlisting><link linkend="gboolean">gboolean</link>    user_function                  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="gboolean">gboolean</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkNotebook-switch-page">The &quot;switch-page&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkNotebook">GtkNotebook</link> *notebook,
                                            <link linkend="GtkNotebookPage">GtkNotebookPage</link> *page,
                                            <link linkend="gint">gint</link> page_num,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Emitted when the user or a function changes the current page.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>notebook</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>page</parameter>&nbsp;:</entry>
<entry>the new current page
</entry></row>
<row><entry align="right"><parameter>page_num</parameter>&nbsp;:</entry>
<entry>the index of the page

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>


<refsect1>
<title>See Also</title>
<para>
<variablelist>
<varlistentry>
<term><link linkend="GtkContainer">GtkContainer</link></term>
<listitem><para>For functions that apply to every <link linkend="GtkContainer">GtkContainer</link>
(like <link linkend="GtkList">GtkList</link>).</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

</refentry>
