<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtknotebook">
  <refnamediv>
    <refname>gtk.Notebook</refname>
    <refpurpose>a tabbed notebook container.</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.Notebook</classname></ooclass>
      <ooclass><classname><link
linkend="class-gtkcontainer">gtk.Container</link></classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gtknotebook">gtk.Notebook</link></methodname>
	<methodparam></methodparam>  </constructorsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--append-page">append_page</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--append-page-menu">append_page_menu</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--prepend-page">prepend_page</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--prepend-page-menu">prepend_page_menu</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--insert-page">insert_page</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter><initializer>-1</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--insert-page-menu">insert_page_menu</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter><initializer>-1</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--remove-page">remove_page</link></methodname>
	<methodparam><parameter
		       role="keyword">page_num</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-current-page">get_current_page</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-nth-page">get_nth_page</link></methodname>
	<methodparam><parameter
		       role="keyword">page_num</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtknotebook--get-n-pages">get_n_pages</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--page-num">page_num</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-current-page">set_current_page</link></methodname>
	<methodparam><parameter
		       role="keyword">page_num</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--next-page">next_page</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--prev-page">prev_page</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-show-border">set_show_border</link></methodname>
	<methodparam><parameter
		       role="keyword">show_border</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-show-border">get_show_border</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-show-tabs">set_show_tabs</link></methodname>
	<methodparam><parameter
		       role="keyword">show_tabs</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-show-tabs">get_show_tabs</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-tab-pos">set_tab_pos</link></methodname>
	<methodparam><parameter role="keyword">pos</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-tab-pos">get_tab_pos</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-scrollable">set_scrollable</link></methodname>
	<methodparam><parameter
		       role="keyword">scrollable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-scrollable">get_scrollable</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--popup-enable">popup_enable</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--popup-disable">popup_disable</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-tab-label">get_tab_label</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-tab-label">set_tab_label</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-tab-label-text">set_tab_label_text</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tab_text</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-tab-label-text">get_tab_label_text</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-menu-label">get_menu_label</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-menu-label">set_menu_label</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-menu-label-text">set_menu_label_text</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">menu_text</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--get-menu-label-text">get_menu_label_text</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--query-tab-label-packing">query_tab_label_packing</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--set-tab-label-packing">set_tab_label_packing</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">expand</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">fill</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">pack_type</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtknotebook--reorder-child">reorder_child</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--set-group-id">set_group_id</link></methodname>
        <methodparam><parameter role="keyword">group_id</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-group-id">get_group_id</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-tab-reorderable">get_tab_reorderable</link></methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--set-tab-reorderable">set_tab_reorderable</link></methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
        <methodparam><parameter role="keyword">reorderable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-tab-detachable">get_tab_detachable</link></methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--set-tab-detachable">set_tab_detachable</link></methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
        <methodparam><parameter role="keyword">detachable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--set-group-name">set_group_name</link></methodname>
        <methodparam><parameter role="keyword">group_name</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-group-name">get_group_name</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-tab-hborder">get_tab_hborder</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-tab-vborder">get_tab_vborder</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--get-action-widget">get_action_widget</link></methodname>
        <methodparam><parameter role="keyword">pack_type</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtknotebook--set-action-widget">set_action_widget</link></methodname>
        <methodparam><parameter role="keyword">widget</parameter></methodparam>
        <methodparam><parameter role="keyword">pack_type</parameter></methodparam>
      </methodsynopsis>
    </classsynopsis>

<programlisting>
<emphasis role="bold">Functions</emphasis>
 
<methodsynopsis language="python">
    <methodname><link linkend="function-gtk--notebook-set-window-creation-hook">gtk.notebook_set_window_creation_hook</link></methodname>
    <methodparam><parameter role="keyword">func</parameter></methodparam>
    <methodparam><parameter role="keyword">data</parameter></methodparam>
  </methodsynopsis></programlisting>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtknotebook">gtk.Notebook</link>
</synopsis>

  </refsect1>
  
  <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>

  <refsect1 id="properties-gtknotebook">
    <title>gtk.Notebook Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"enable-popup"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, pressing the right mouse
	      button on the notebook pops up a menu that you can use to go
	      to a page.  Default value: <literal>False</literal>.</entry>
	    </row>
        
        <!-- HOLD THE DISPLAY OF THIS PROPERTY
        <row valign="top">
          <entry>"group"</entry>
          <entry>Read-Write</entry>
          <entry>Group for tabs drag and drop.</entry>
        </row>
        END HOLD -->
        
        <row valign="top">
          <entry>"group-id"</entry>
          <entry>Read-Write</entry>
          <entry>Group ID for tabs drag and drop. Allowed values: >=
          -1. Default value: -1.</entry>
        </row>

        <row valign="top">
          <entry>"group-name"</entry>
          <entry>Read-Write</entry>
          <entry>Group name for tabs drag and drop. Default value: <literal>None</literal>.
          Available in GTK+ 2.24.</entry>
        </row>

	    <row valign="top">
	      <entry>"homogeneous"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, tabs should have
	      homogeneous sizes. Default value:
	      <literal>False</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"page"</entry>
	      <entry>Read-Write</entry>
	      <entry>The index of the current page. Allowed values: >= 0.
	      Default value: 0.</entry>
	    </row>
	    <row valign="top">
	      <entry>"scrollable"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, scroll arrows are added if
	      there are too many tabs to fit.  Default value:
	      <literal>False</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"show-border"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the border should be shown.
	      Default value: <literal>True</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"show-tabs"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, tabs should be shown.
	      Default value: <literal>True</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-border"</entry>
	      <entry>Write</entry>
	      <entry>The width of the border around the tab labels. Default
	      value: 2.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-hborder"</entry>
	      <entry>Read-Write</entry>
	      <entry>The width of the horizontal border of tab labels.
	      Default value: 2.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-pos"</entry>
	      <entry>Read-Write</entry>
	      <entry>The side of the notebook that holds the tabs - one of
	      the <xref linkend="gtk-position-type-constants"
	      endterm="gtk-position-type-constants-title"></xref>:
	      <literal>gtk.POS_LEFT</literal>,
	      <literal>gtk.POS_RIGHT</literal>,
	      <literal>gtk.POS_TOP</literal> or
	      <literal>gtk.POS_BOTTOM</literal>.  Default value:
	      <literal>gtk.POS_TOP</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-vborder"</entry>
	      <entry>Read-Write</entry>
	      <entry>The width of the vertical border of tab labels.
	      Default value: 2,</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="style-properties-gtknotebook">
    <title>gtk.Notebook Style Properties</title>

    <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"arrow-spacing"</entry>
	      <entry>Read-Write</entry>
	      <entry>The "arrow-size" property defines the spacing between
	      the scroll arrows and the tabs. Allowed values: >= 0.
	      Default value: 0. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"has-backward-stepper"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> the standard backward arrow
	      button is displayed. Default value:
	      <literal>True</literal>. Available in GTK+ 2.4 and
	      above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"has-forward-stepper"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> the standard forward arrow
	      button is displayed. Default value:
	      <literal>True</literal>. Available in GTK+ 2.4 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"has-secondary-backward-stepper"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> a second backward arrow
	      button is displayed on the opposite end of the tab
	      area. Default value: <literal>False</literal>. Available in
	      GTK+ 2.4 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"has-secondary-forward-stepper"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> a second forward arrow
	      button is displayed on the opposite end of the tab
	      area. Default value: <literal>False</literal>. Available in
	      GTK+ 2.4 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"tab-curvature"</entry>
	      <entry>Read-Write</entry>
	      <entry>The "tab-curvature" property defines size of tab
	      curvature. Allowed values: >= 0. Default value: 1. Available
	      in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"tab-overlap"</entry>
	      <entry>Read-Write</entry>
	      <entry>The "tab-overlap" property defines size of tab overlap
	      area. Default value: 2. Available in GTK+ 2.10.</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="child-properties-gtknotebook">
    <title>gtk.Notebook Child Properties</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

            <row valign="top">
              <entry>"detachable"</entry>
              <entry>Read-Write</entry>
              <entry>if <literal>True</literal> the tab is detachable.
              Default value: <literal>False</literal>.</entry>
            </row>

	    <row valign="top">
	      <entry>"menu-label"</entry>
	      <entry>Read-Write</entry>
	      <entry>The string displayed in the child's menu entry.
	      Default value: <literal>None</literal></entry>
	    </row>
	    <row valign="top">
	      <entry>"position"</entry>
	      <entry>Read-Write</entry>
	      <entry>The index of the child in the parent. Allowed values:
	      >= -1 Default value: 0.</entry>
	    </row>
	    <row valign="top">
	      <entry>"reorderable"</entry>
	      <entry>Read-Write</entry>
	      <entry>Whether the tab is reorderable by user action or not.
        Default value: <literal>False</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-expand"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, expand the child's tabs.
	      Default value: <literal>False</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-fill"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the child's tab should fill
	      the allocated area.  Default value:
	      <literal>True</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-label"</entry>
	      <entry>Read-Write</entry>
	      <entry>The string displayed on the child's tab label.  Default
	      value: <literal>None</literal>.</entry>
	    </row>
	    <row valign="top">
	      <entry>"tab-pack""</entry>
	      <entry>Read-Write</entry>
	      <entry>A pack type indicating whether the child is packed with
	      reference to the start or end of the parent - one of the <xref
	      linkend="gtk-pack-type-constants"
	      endterm="gtk-pack-type-constants-title"></xref>:
	      <literal>gtk.PACK_START</literal> or
	      <literal>gtk.PACK_END</literal>.  Default value:
	      <literal>gtk.PACK_START</literal>.</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1>
    <title>Attributes</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	<?dbhtml cellpadding="5"?>
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"tab_pos"</entry>
	      <entry>Read</entry>
	      <entry>The side of the notebook that holds the tabs:
<literal>gtk.POS_LEFT</literal>, <literal>gtk.POS_RIGHT</literal>,
<literal>gtk.POS_TOP</literal> or <literal>gtk.POS_BOTTOM</literal></entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="signal-prototypes-gtknotebook">
    <title>gtk.Notebook Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>

    <variablelist>
      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--change-current-page">change-current-page</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
            <methodparam><parameter>offset</parameter>
            </methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--create-window">create-window</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
            <methodparam><parameter>page</parameter>
            </methodparam>
            <methodparam><parameter>x</parameter>
            </methodparam>
            <methodparam><parameter>y</parameter>
            </methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--focus-tab">focus-tab</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>type</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--move-focus-out">move-focus-out</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>direction_type</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link linkend="signal-gtknotebook--page-added">page-added</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>child</parameter></methodparam>
	    <methodparam><parameter>page_num</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link linkend="signal-gtknotebook--page-removed">page-removed</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>child</parameter></methodparam>
	    <methodparam><parameter>page_num</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link linkend="signal-gtknotebook--page-reordered">page-reordered</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>child</parameter></methodparam>
	    <methodparam><parameter>page_num</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--select-page">select-page</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>move_focus</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link
linkend="signal-gtknotebook--switch-page">switch-page</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>notebook</parameter>
            </methodparam>
	    <methodparam><parameter>page</parameter></methodparam>
	    <methodparam><parameter>page_num</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter>
            </methodparam>
            <methodparam><parameter>...</parameter>
            </methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>The <link
linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
widget is a <link
linkend="class-gtkcontainer"><classname>gtk.Container</classname></link>
whose children are overlapping pages that can be switched between by  using
tab labels along one edge. There are many configuration options for the
<link
linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>. You
can choose on which edge the tabs appear (see <link
linkend="method-gtknotebook--set-tab-pos"><methodname>set_tab_pos</methodname>()</link>); 
whether the notebook should be made bigger or scrolling arrows added if
there are too many tabs to fit (see <link
linkend="method-gtknotebook--set-scrollable"><methodname>set_scrollable</methodname>()</link>); 
and, whether there will be a popup menu allowing the users to switch pages.
(see <link
linkend="method-gtknotebook--popup-enable"><methodname>popup_enable</methodname>()</link>, 
<link
linkend="method-gtknotebook--popup-disable"><methodname>popup_disable</methodname>()</link>).</para>

    <para>The <link
linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link> is
particularly useful for displaying a large number of application controls
that can be grouped into several functional areas. The typical example is
the user preferences dialog in some applications. For example, a notebook
page can be setup for each of font selection, color selection, formating,
etc.</para>
    
    <title>GtkNotebook as GtkBuildable</title>
    
    <para>
          The <link linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
          implementation of the <link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
          interface supports placing children into tabs by specifying "tab" as the
          "type" attribute of a &#60;child&#62; element. Note that the content of the
          tab must be created before the tab can be filled. A tab child can be specified
          without specifying a &#60;child&#62; type attribute.
    </para>
    
    <refsect2 id="gtkbuilder-ui-definition-fragment-with-gtknotebook">
            <title>A UI definition fragment with gtk.Notebook</title>
<programlisting>
<![CDATA[
<object class="GtkNotebook">
  <child>
    <object class="GtkLabel" id="notebook-content">
      <property name="label">Content</property>
    </object>
  </child>
  <child type="tab">
    <object class="GtkLabel" id="notebook-tab">
      <property name="label">Tab</property>
    </object>
  </child>
</object>
]]>
</programlisting>
            <para>
                Beyond this general structure, several object classes define their own XML DTD
                fragments for filling in the ANY placeholders in the DTD above. Note that a
                custom element in a &#60;child&#62; element gets parsed by the custom tag handler of
                the parent object, while a custom element in an &#60;object&#62; element gets parsed
                by the custom tag handler of the object.
            </para>
        </refsect2>

  </refsect1>

  <refsect1 id="constructor-gtknotebook">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.Notebook</methodname>
	<methodparam></methodparam>  </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>the newly created <link
linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link></simpara></listitem>
      </varlistentry>
    </variablelist>

    <para>Creates a new <link
linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
widget with no pages.</para>

  </refsect1>

  <refsect1>
    <title>Methods</title>

  <refsect2 id="method-gtknotebook--append-page">
      <title>gtk.Notebook.append_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_page</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to be
used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>append_page</methodname>() method appends a page
to the notebook using the widget specified by <parameter>child</parameter>
and the widget specified by <parameter>tab_label</parameter> as the label on
the tab.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. Also if
<parameter>tab_label</parameter> is not specified it will default to
<literal>None</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--append-page-menu">
      <title>gtk.Notebook.append_page_menu</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_page_menu</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to be
used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">menu_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget to use as a label for the
page-switch menu, if that is enabled.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>append_page_menu</methodname>() method appends a
page to the notebook and specifying the widget to use as the label in the
popup menu. <parameter>child</parameter> specifies the widget to use as the
contents of the page; <parameter>tab_label</parameter> specifies the widget
to be used as the tab label; and, <parameter>menu_label</parameter>
specifies the widget to use in the popup menu.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. If
<parameter>tab_label</parameter> is a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link> or
<literal>None</literal> and <parameter>menu_label</parameter> is
<literal>None</literal> then the menu label will have the same text as the
tab label. Otherwise, <parameter>menu_label</parameter> must be specified
and not <literal>None</literal>. These parameters will default to
<literal>None</literal> in PyGTK 2.4 as well.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--prepend-page">
      <title>gtk.Notebook.prepend_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_page</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to be
used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>prepend_page</methodname>() method prepends a
page to the notebook. <parameter>child</parameter> specifies the widget to
use as the contents of the page and <parameter>tab_label</parameter>
specifies the widget to be used as the tab label.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. Also if
<parameter>tab_label</parameter> is not specified it will default to
<literal>None</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--prepend-page-menu">
      <title>gtk.Notebook.prepend_page_menu</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_page_menu</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to be
used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">menu_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget to use as a label for the
page-switch menu, if that is enabled.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>prepend_page_menu</methodname>() method prepends
a page to the notebook specifying the widget to use as the label in the
popup menu. <parameter>child</parameter> specifies the widget to use as the
contents of the page; <parameter>tab_label</parameter> specifies the widget
to use as the tab label; and, <parameter>menu_label</parameter> specifies
the widget to use in the popup menu.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. If
<parameter>tab_label</parameter> is a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link> or
<literal>None</literal> and <parameter>menu_label</parameter> is
<literal>None</literal> then the menu label will have the same text as the
tab label. Otherwise, <parameter>menu_label</parameter> must be specified
and not <literal>None</literal>. These parameters will default to
<literal>None</literal> in PyGTK 2.4 as well.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--insert-page">
      <title>gtk.Notebook.insert_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_page</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term> <listitem><simpara>the
<link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to
be used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the index (starting at 0) at which to insert
the page, or -1 to append the page after all other
pages.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>insert_page</methodname>() method inserts a page
into the notebook at the location specified by
<parameter>position</parameter> (0 is the first page).
<parameter>child</parameter> is the widget to use as the contents of the
page and <parameter>tab_label</parameter> specifies the widget to be used as
the tab label. If <parameter>position</parameter> is -1 the page is appended
to the notebook. In PyGTK 2.4 and above if <parameter>tab_label</parameter>
is <literal>None</literal> a default label if "page N" is used.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. Also if
<parameter>tab_label</parameter> is not specified it will default to
<literal>None</literal>.</para>

      <para>In Pygtk 2.4 and above <parameter>position</parameter> will
default to -1 if not specified.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--insert-page-menu">
      <title>gtk.Notebook.insert_page_menu</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_page_menu</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to use as
the contents of the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">tab_label</parameter>&nbsp;:</term>
          <listitem><simpara>the
<link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to
be used as the label for the page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">menu_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget to use as a label for the
page-switch menu, if that is enabled.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the index (starting at 0) at which to insert
the page, or -1 to append the page after all other
pages.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>in PyGTK 2.0 and 2.2 returns
	  <literal>None</literal>. In PyGTK 2.4 and above returns the index
	  number of the page in the notebook</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>insert_page_menu</methodname>() method inserts a
page into the notebook at the location specified by
<parameter>position</parameter>. <parameter>child</parameter> specifies the
widget to use as the contents of the page; <parameter>tab_label</parameter>
specifies the widget to use as the tab label; and
<parameter>menu_label</parameter> specifies the widget to use as the label
in the popup menu.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. If
<parameter>tab_label</parameter> is a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link> or
<literal>None</literal> and <parameter>menu_label</parameter> is
<literal>None</literal> then the menu label will have the same text as the
tab label. Otherwise, <parameter>menu_label</parameter> must be specified
and not <literal>None</literal>. These parameters will default to
<literal>None</literal> in PyGTK 2.4 as well.</para>

      <para>In Pygtk 2.4 and above <parameter>position</parameter> will
default to -1 if not specified.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--remove-page">
      <title>gtk.Notebook.remove_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>remove_page</methodname>
	  <methodparam><parameter
			 role="keyword">page_num</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the index of a notebook page, starting from 0.
If -1, the last page will be removed.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>remove_page</methodname>() method removes from
the notebook the page at the location specified by
<parameter>index</parameter>. The value of <parameter>index</parameter>
starts from 0. If <parameter>index</parameter> is -1 the last page of the
notebook will be removed.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-current-page">
      <title>gtk.Notebook.get_current_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_current_page</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the index (starting from 0) of the current page
in the notebook. If the notebook has no pages, then -1 will be
returned.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_current_page</methodname>() method returns
the page index of the current page numbered from 0.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-nth-page">
      <title>gtk.Notebook.get_nth_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_nth_page</methodname>
	  <methodparam><parameter
			 role="keyword">page_num</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the index of a page in the
notebook</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the child widget, or <literal>None</literal> if
<parameter>page_num</parameter> is out of bounds.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_nth_page</methodname>() method returns the
child widget contained in the page with the index specified by
<parameter>page_num</parameter>. If <parameter>page_num</parameter> is out
of bounds for the page range of the notebook this method returns
<literal>None</literal>.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-n-pages">
      <title>gtk.Notebook.get_n_pages</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_n_pages</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of pages in the
	  notebook.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above.</para>
      </note>

      <para>The <methodname>get_n_pages</methodname>() method returns the
number of pages in a notebook.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--page-num">
      <title>gtk.Notebook.page_num</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>page_num</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the index of the page containing
<parameter>child</parameter>, or -1 if <parameter>child</parameter> is not
in the notebook.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>page_num</methodname>() method returns the index
of the page which contains the widget specified by
<parameter>child</parameter> or -1 if no page contains
<parameter>child</parameter>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-current-page">
      <title>gtk.Notebook.set_current_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_current_page</methodname>
	  <methodparam><parameter
			 role="keyword">page_num</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the 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.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_current_page</methodname>() method switches
to the page number specified by <parameter>page_num</parameter>. If
<parameter>page_num</parameter> is negative the last page is
selected.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--next-page">
      <title>gtk.Notebook.next_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>next_page</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>next_page</methodname>() method switches to the
next page. Nothing happens if the current page is the last page.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--prev-page">
      <title>gtk.Notebook.prev_page</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prev_page</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>prev_page</methodname>() method switches to the
previous page. Nothing happens if the current page is the first page.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-show-border">
      <title>gtk.Notebook.set_show_border</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_show_border</methodname>
	  <methodparam><parameter
			 role="keyword">show_border</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">show_border</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> a bevel should be
drawn around the notebook.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>show_border</methodname>() method sets the
"show-border" property to the value of <parameter>show_border</parameter>.
If <parameter>show_border</parameter> is <literal>True</literal> a bevel
will be drawn around the notebook pages. This only has a visual effect when
the tabs are not shown. See <link
linkend="method-gtknotebook--set-show-tabs"><methodname>set_show_tabs</methodname>()</link>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-show-border">
      <title>gtk.Notebook.get_show_border</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_show_border</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the bevel should be
drawn</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_show_border</methodname>() method returns
the value of the "show-border" property. If "show-border" is
<literal>True</literal> a bevel will be drawn around the notebook pages when
tabs are not shown. See <link
linkend="method-gtknotebook--set-show-border"><methodname>set_show_border</methodname>()</link>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-show-tabs">
      <title>gtk.Notebook.set_show_tabs</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_show_tabs</methodname>
	  <methodparam><parameter
			 role="keyword">show_tabs</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">show_tabs</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the tabs should be
shown.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_show_tabs</methodname>() method sets the
"show-tabs" property to the value of <parameter>show_tabs</parameter>. If
<parameter>show_tabs</parameter> is <literal>True</literal> the notebook
tabs will be displayed.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-show-tabs">
      <title>gtk.Notebook.get_show_tabs</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_show_tabs</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the tabs are
shown</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_show_tabs</methodname>() method returns the
value of the "show-tabs" property. If "show-tabs" is <literal>True</literal>
the tabs of the notebook are shown. See <link
linkend="method-gtknotebook--set-show-tabs"><methodname>set_show_tabs</methodname>()</link>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-tab-pos">
      <title>gtk.Notebook.set_tab_pos</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_tab_pos</methodname>
	  <methodparam><parameter
			 role="keyword">pos</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">pos</parameter>&nbsp;:</term>
	  <listitem><simpara>the edge to draw the tabs at:
<literal>gtk.POS_LEFT</literal>, <literal>gtk.POS_RIGHT</literal>,
<literal>gtk.POS_TOP</literal> or
<literal>gtk.POS_BOTTOM</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_tab_pos</methodname>() method sets the edge
at which the tabs for switching pages in the notebook are drawn as specified
by <parameter>pos</parameter>. The value of <parameter>pos</parameter> can
be one of: <literal>gtk.POS_LEFT</literal>,
<literal>gtk.POS_RIGHT</literal>, <literal>gtk.POS_TOP</literal> or
<literal>gtk.POS_BOTTOM</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-tab-pos">
      <title>gtk.Notebook.get_tab_pos</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_tab_pos</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the edge at which the tabs are
drawn</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_tab_pos</methodname>() method returns the
edge at which the tabs for switching pages in the notebook are drawn. The
return value is one of: <literal>gtk.POS_LEFT</literal>,
<literal>gtk.POS_RIGHT</literal>, <literal>gtk.POS_TOP</literal> or
<literal>gtk.POS_BOTTOM</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-scrollable">
      <title>gtk.Notebook.set_scrollable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_scrollable</methodname>
	  <methodparam><parameter
			 role="keyword">scrollable</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">scrollable</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> scroll arrows should
be added</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_scrollable</methodname>() method sets the
"scrollable" property to the value specified by
<parameter>scrollable</parameter>. If <parameter>scrollable</parameter> is
<literal>True</literal> the tab label area will have arrows for scrolling if
there are too many tabs to fit in the area.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-scrollable">
      <title>gtk.Notebook.get_scrollable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_scrollable</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if arrows for scrolling
are enabled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_scrollable</methodname>() method returns the
value of the "scrollable" property. If "scrollable" is
<literal>True</literal> the tab label area has scrolling arrows enabled and
displayed if there are too many tabs to fit in the display area. See <link
linkend="method-gtknotebook--set-scrollable"><methodname>set_scrollable</methodname>()</link>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--popup-enable">
      <title>gtk.Notebook.popup_enable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>popup_enable</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>popup_enable</methodname>() method enables the
popup menu: if the user clicks with the right mouse button on the tabs, a
menu with all the pages will be popped up.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--popup-disable">
      <title>gtk.Notebook.popup_disable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>popup_disable</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>popup_disable</methodname>() method disables the
popup menu.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-tab-label">
      <title>gtk.Notebook.get_tab_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_tab_label</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the tab label widget for the page containing
<parameter>child</parameter></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_tab_label</methodname>() method returns the
tab label widget for the page containing the widget
<parameter>child</parameter>. <literal>None</literal> is returned if
<parameter>child</parameter> is not in the notebook.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-tab-label">
      <title>gtk.Notebook.set_tab_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_tab_label</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tab_label</parameter>&nbsp;:</term>
	  <listitem><simpara>the tab label widget to
use or <literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_tab_label</methodname>() method replaces the
tab label for the notebook page containing <parameter>child</parameter> with
the widget specified by <parameter>tab_label</parameter>.</para>

      <para>In PyGTK 2.4 and above <parameter>tab_label</parameter> can be
<literal>None</literal> to use a default label. Also if
<parameter>tab_label</parameter> is not specified it will default to
<literal>None</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-tab-label-text">
      <title>gtk.Notebook.set_tab_label_text</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_tab_label_text</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tab_text</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">tab_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the new label text</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_tab_label_text</methodname>() method creates
a new label with the text specified by <parameter>tab_text</parameter> and
sets it as the tab label for the page containing
<parameter>child</parameter>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-tab-label-text">
      <title>gtk.Notebook.get_tab_label_text</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_tab_label_text</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>value: the text of the tab label, or
<literal>None</literal> if the tab label widget is not a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link> or
<parameter>child</parameter> is not in a notebook page.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_tab_label_text</methodname>() retrieves the
text of the tab label for the page containing <parameter>child</parameter>.
This method returns <literal>None</literal> if <parameter>child</parameter>
is not in a notebook page or the page tab label is not a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link>
widget.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-menu-label">
      <title>gtk.Notebook.get_menu_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_menu_label</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the menu label, or <literal>None</literal> if
the notebook page does not have a menu label other than the default (the tab
label) or if child is not in a notebook page.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_menu_label</methodname>() method retrieves
the menu label widget of the page containing <parameter>child</parameter>.
If <parameter>child</parameter> is not in a notebook page or the menu label
has not been set (it defaults to the tab label), this method returns
<literal>None</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-menu-label">
      <title>gtk.Notebook.set_menu_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_menu_label</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">menu_label</parameter><initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">menu_label</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget to be used as the new menu
label</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_menu_label</methodname>() replaces the menu
label for the page containing <parameter>child</parameter> with the widget
specified by <parameter>menu_label</parameter>.</para>

      <para>In PyGTK 2.4 and above <parameter>menu_label</parameter> can be
<literal>None</literal> to use a default label. Also if
<parameter>menu_label</parameter> is not specified it will default to
<literal>None</literal>. See the <link
linkend="method-gtknotebook--append-page-menu"><methodname>append_page_menu</methodname>()</link>
method for more information.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-menu-label-text">
      <title>gtk.Notebook.set_menu_label_text</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_menu_label_text</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">menu_text</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">menu_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the new menu label text</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_menu_label_text</methodname>() method
creates a new label widget and replaces the menu label of the page
containing<parameter>child</parameter>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--get-menu-label-text">
      <title>gtk.Notebook.get_menu_label_text</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_menu_label_text</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a child widget of a notebook
page.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>value: the text of the tab label, or
<literal>None</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="class-gtklabel"><classname>gtk.Label</classname></link> or
<parameter>child</parameter> is not contained in a notebook
page.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_menu_label_text</methodname>() method
retrieves the text of the menu label for the page containing
<parameter>child</parameter>. If <parameter>child</parameter> is not in a
notebook page or the menu label is not a <link
linkend="class-gtklabel"><classname>gtk.Label</classname></link> widget or
the menu label has not been set (it default to the tab label), the return
value is <literal>None</literal>.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--query-tab-label-packing">
      <title>gtk.Notebook.query_tab_label_packing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>query_tab_label_packing</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a tuple containing: the expand value, the fill
value and the pack type</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>query_tab_label_packing</methodname>() method
returns a tuple containing the packing attributes (expand, fill, pack type)
for the tab label of the page containing <parameter>child</parameter>. If
the expand attribute is <literal>True</literal> the tab can expand to take
up the free space in the tab area. If fill is <literal>True</literal> the
label widget in the tab can use up all the space in the tab. The pack type
can be one of <literal>gtk.PACK_START</literal> or
<literal>gtk.PACK_END</literal> to specify whether the tab is packed to the
left or right if tabs are on the top or bottom edge (top or bottom if the
tabs are on the left or right edge).</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--set-tab-label-packing">
      <title>gtk.Notebook.set_tab_label_packing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_tab_label_packing</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">expand</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">fill</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">pack_type</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget contained in a notebook
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">expand</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the tab can expand
to fill the free space in the tab area</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">fill</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the label widget can
fill the space in the tab</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">pack_type</parameter>&nbsp;:</term>
	  <listitem><simpara>the position of the tab:
<literal>gtk.PACK_START</literal> or
<literal>gtk.PACK_END</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_tab_label_packing</methodname>() method sets
the packing parameters for the tab label of the page containing
<parameter>child</parameter>. If <parameter>expand</parameter> is
<literal>True</literal> the tab can expand to take up the free space in the
tab area. If <parameter>fill</parameter> is <literal>True</literal> the
label widget in the tab can use up all the space in the tab. The
<parameter>pack_type</parameter> can be one of
<literal>gtk.PACK_START</literal> or <literal>gtk.PACK_END</literal> to
specify whether the tab is packed to the left or right if tabs are on the
top or bottom edge (top or bottom if the tabs are on the left or right
edge).See <link
linkend="method-gtkbox--pack-start"><methodname>gtk.Box.pack_start</methodname>()</link> 
for the exact meaning of the parameters.</para>

    </refsect2>

  <refsect2 id="method-gtknotebook--reorder-child">
      <title>gtk.Notebook.reorder_child</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>reorder_child</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the child widget to move</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the index of the page that
<parameter>child</parameter> is to move to, or -1 to move to the
end</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>reorder_child</methodname>() method reorders
the notebook pages so that <parameter>child</parameter> appears in the page
whose index is specified by <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>

    </refsect2>

    <refsect2 id="method-gtknotebook--set-group-id">
      <title>gtk.Notebook.set_group_id</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_group_id</methodname>
        <methodparam><parameter role="keyword">group_id</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">group_id</parameter>&nbsp;:</term>
          <listitem><simpara>a group identifier, or -1 to unset
          it</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>set_group_id</methodname>() method sets the
      group identifier for the notebook to the value specified by
      <parameter>group_id</parameter>. Notebooks sharing the same group
      identifier will be able to exchange tabs via drag and drop. A notebook
      with group identifier -1 will not be able to exchange tabs with any
      other notebook.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-group-id">
      <title>gtk.Notebook.get_group_id</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_group_id</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the group identifier, or -1 if none is
          set.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_group_id</methodname>() method returns the
      current group identifier for the notebook.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-tab-reorderable">
      <title>gtk.Notebook.get_tab_reorderable</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_tab_reorderable</methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">child</parameter>&nbsp;:</term>
          <listitem><simpara>a child <link
          linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the tab is
          reorderable.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_tab_reorderable</methodname>() method
      returns <literal>True</literal> if the tab can be reordered via drag
      and drop.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--set-tab-reorderable">
      <title>gtk.Notebook.set_tab_reorderable</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_tab_reorderable</methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
        <methodparam><parameter role="keyword">reorderable</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">child</parameter>&nbsp;:</term>
          <listitem><simpara>a child <link
          linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">reorderable</parameter>&nbsp;:</term>
          <listitem><simpara>if <literal>True</literal> the tab is
          reorderable.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>set_tab_reorderable</methodname>() method sets
      the "reorderable" property of <parameter>child</parameter> to the
      value of <parameter>reorderable</parameter>. If
      <parameter>reorderable</parameter> is <literal>True</literal>, the
      notebook tab can be reordered via drag and drop.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-tab-detachable">
      <title>gtk.Notebook.get_tab_detachable</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_tab_detachable</methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">child</parameter>&nbsp;:</term>
          <listitem><simpara>a child <link
          linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>if <literal>True</literal> the tab is
          detachable.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_tab_detachable</methodname>() method returns
      the value of the "detachable" property of
      <parameter>child</parameter>. The method returns
      <parameter>True</parameter> if the tab contents can be detached from
      <parameter>notebook</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--set-tab-detachable">
      <title>gtk.Notebook.set_tab_detachable</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_tab_detachable</methodname>
        <methodparam><parameter role="keyword">child</parameter></methodparam>
        <methodparam><parameter role="keyword">detachable</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">child</parameter>&nbsp;:</term>
          <listitem><simpara>a child <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">detachable</parameter>&nbsp;:</term>
          <listitem><simpara>if <literal>True</literal> the tab is
          detachable or not</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>set_tab_detachable</methodname>() method sets
      the "detachable" property of <parameter>child</parameter> to the value
      specified by <parameter>detachable</parameter>. If
      <parameter>detachable</parameter> is <literal>True</literal>,
      <parameter>child</parameter> can be moved from this notebook to
      another notebook or widget.</para>
      
      <para>Note that two notebooks must share a common group identifier
      (see the <link
      linkend="method-gtknotebook--set-group-id"><methodname>set_group_id</methodname>()</link>
      method) to allow automatic tabs interchange between them.</para>
      
      <para>If you want a widget to interact with a notebook through DnD
      (i.e.: accept dragged tabs from it) it must be set as a drop
      destination and accept the target 'GTK_NOTEBOOK_TAB'. The notebook
      will fill the selection with a reference to the child
      widget that corresponds to the dropped tab.</para>
      
      <para>If you want a notebook to accept drags from other widgets, you
      will have to set your own DnD code to do it.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--set-group-name">
      <title>gtk.Notebook.set_group_name</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_group_name</methodname>
        <methodparam><parameter role="keyword">group_name</parameter></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">group_name</parameter>&nbsp;:</term>
          <listitem><simpara>the group name, or <literal>None</literal>.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.24 and above.</para>
      </note>

      <para>The <methodname>set_group_name</methodname>() method sets a group name for notebook.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-group-name">
      <title>gtk.Notebook.get_group_name</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_group_name</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the group name, or <literal>None</literal>.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.24 and above.</para>
      </note>

      <para>The <methodname>get_group_name</methodname>() method gets the current group name for notebook.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-tab-hborder">
      <title>gtk.Notebook.get_tab_hborder</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_tab_hborder</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the horizontal width of a tab border.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.22 and above.</para>
      </note>

      <para>The <methodname>get_tab_hborder</methodname>() method returns the horizontal width of a tab border.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-tab-vborder">
      <title>gtk.Notebook.get_tab_vborder</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_tab_vborder</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the vertical width of a tab border.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.22 and above.</para>
      </note>

      <para>The <methodname>get_tab_vborder</methodname>() method returns the vertical width of a tab border.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--get-action-widget">
      <title>gtk.Notebook.get_action_widget</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_action_widget</methodname>
        <methodparam><parameter role="keyword">pack_type</parameter></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">pack_type</parameter>&nbsp;:</term>
          <listitem><simpara>pack type of the action widget to receive.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the action widget with the given pack_type or <literal>None</literal>
          when this action widget has not been set.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.22 and above.</para>
      </note>

      <para>The <methodname>get_action_widget</methodname>() method gets one of the action widgets.</para>

    </refsect2>

    <refsect2 id="method-gtknotebook--set-action-widget">
      <title>gtk.Notebook.set_action_widget</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_action_widget</methodname>
        <methodparam><parameter role="keyword">widget</parameter></methodparam>
        <methodparam><parameter role="keyword">pack_type</parameter></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
          <listitem><simpara>a <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">pack_type</parameter>&nbsp;:</term>
          <listitem><simpara>pack type of the action widget.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.22 and above.</para>
      </note>

      <para>The <methodname>set_action_widget</methodname>() method sets widget as one of the action widgets. Depending on
      the pack type the widget will be placed before or after the tabs. You can use a <link linkend="class-gtkbox"><classname>gtk.Box</classname></link>
      if you need to pack more than one widget on the same side.</para>

      <para>Note that action widgets are "internal" children of the notebook and thus not included in the list returned
      from <link linkend="method-gtkcontainer--foreach"><methodname>foreach</methodname></link>().</para>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Functions</title>
                                                                              
    <refsect2 id="function-gtk--notebook-set-window-creation-hook">
      <title>gtk.notebook_set_window_creation_hook</title>
                                                                              
      <programlisting><methodsynopsis language="python">
          <methodname>gtk.notebook_set_window_creation_hook</methodname>
          <methodparam><parameter
                         role="keyword">func</parameter></methodparam>
          <methodparam><parameter
                         role="keyword">data</parameter></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara> a function to call when a tab is dropped
          in an empty area.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">data</parameter>&nbsp;:</term>
          <listitem><simpara> data to pass to
<parameter>func</parameter></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.10 and above.</para>
      </note>
                                                                              
      <para>The <function>gtk.notebook_set_window_creation_hook</function>
function installs a global function (specified by
<parameter>func</parameter>) used to create a window when a detached tab
is dropped in an empty area.</para>

      <para>The signature of the callback function
<parameter>func</parameter> is:</para>

      <programlisting>
def func(source, page, x, y, user_data)
</programlisting>

      <para>where <parameter>source</parameter> is the
      <link linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
      of the drag operation, <parameter>page</parameter> is the child
      <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> affected,
      <parameter>x</parameter> is the X coordinate where the drop happens,
      <parameter>y</parameter> is the Y coordinate where the drop happens,
      <parameter>user_data</parameter> is the user data to pass to <parameter>func</parameter>.
      
      </para>
      
      <para>
        This function is used by
        <link linkend="class-gtknotebook"><classname>gtk.Notebook</classname></link>
        when a detachable tab is dropped in the root window,
        it's used to create a window containing a notebook where the tab will be attached.
        This function will also be responsible of moving/resizing the window and adding the
        necessary properties to the notebook (i.e.: group-id). If the
        function returns <literal>None</literal>, the drag will be cancelled.
      </para>
    </refsect2>
                                                                              
  </refsect1>

  <refsect1>
    <title>Signals</title>

    <refsect2 id="signal-gtknotebook--change-current-page">
      <title>The "change-current-page" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>offset</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>offset</parameter>&nbsp;:</term>
	  <listitem><simpara>the count of pages to move (negative count is
backward)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "change-current-page" signal is emitted when the page
forward or page backward request is issued.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--create-window">
      <title>The "create-window" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>page</parameter></methodparam>
      <methodparam><parameter>x</parameter></methodparam>
      <methodparam><parameter>y</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page</parameter>&nbsp;:</term>
	  <listitem><simpara>the tab of notebook that is being detached
      </simpara></listitem>
	</varlistentry>
    <varlistentry>
	  <term><parameter>x</parameter>&nbsp;:</term>
	  <listitem><simpara>the X coordinate where the drop happens
      </simpara></listitem>
	</varlistentry>
    <varlistentry>
	  <term><parameter>y</parameter>&nbsp;:</term>
	  <listitem><simpara>the Y coordinate where the drop happens
      </simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "create-window" signal is emitted when a
      detachable tab is dropped on the root window.</para>

      <para>A handler for this signal can create a window containing
      a notebook where the tab will be attached. It is also responsible
      for moving/resizing the window and adding the necessary properties
      to the notebook (e.g. the <link linkend="properties-gtknotebook">GtkNotebook:group-id</link> ).</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--focus-tab">
      <title>The "focus-tab" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>type</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>type</parameter>&nbsp;:</term>
	  <listitem><simpara>the type of tab:
<literal>gtk.NOTEBOOK_TAB_FIRST</literal> or
<literal>gtk.NOTEBOOK_TAB_LAST</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
handled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "focus-tab" signal is emitted when the focus is changed by
tabbing.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--move-focus-out">
      <title>The "move-focus-out" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>direction_type</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>direction_type</parameter>&nbsp;:</term>
	  <listitem><simpara>the direction type of the focus move:
<literal>gtk.DIR_TAB_FORWARD</literal>,
<literal>gtk.DIR_TAB_BACKWARD</literal>, <literal>gtk.DIR_UP</literal>,
<literal>gtk.DIR_DOWN</literal>, <literal>gtk.DIR_LEFT</literal> or
<literal>gtk.DIR_RIGHT</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "move-focus-out" signal is emitted when the focus is moved
out of the notebook with the specified
<parameter>direction_type</parameter>.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--page-added">
      <title>The "page-added" Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>child</parameter></methodparam>
	  <methodparam><parameter>page_num</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>child</parameter>&nbsp;:</term>
	  <listitem><simpara>the child <link
	  linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
	  affected</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the new page number for
	  <parameter>child</parameter></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This signal is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The "page-added" signal is emitted when a page is added to the
      notebook.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--page-removed">
      <title>The "page-removed" Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>child</parameter></methodparam>
	  <methodparam><parameter>page_num</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>child</parameter>&nbsp;:</term>
	  <listitem><simpara>the child <link
	  linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
	  affected</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the new page number for
	  <parameter>child</parameter></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This signal is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The "page-removed" signal is emitted after a page is removed
      from the notebook.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--page-reordered">
      <title>The "page-reordered" Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>child</parameter></methodparam>
	  <methodparam><parameter>page_num</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>child</parameter>&nbsp;:</term>
	  <listitem><simpara>the child <link
	  linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
	  affected</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the new page number for
	  <parameter>child</parameter></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This signal is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The "page-reordered" signal is emitted when a page has been
      reordered.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--select-page">
      <title>The "select-page" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>move_focus</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>move_focus</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> move the
focus to a child widget</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
handled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "select-page" signal is emitted when a new child page is
selected.</para>

    </refsect2>

    <refsect2 id="signal-gtknotebook--switch-page">
      <title>The "switch-page" gtk.Notebook Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>notebook</parameter></methodparam>
	  <methodparam><parameter>page</parameter></methodparam>
	  <methodparam><parameter>page_num</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>notebook</parameter>&nbsp;:</term>
	  <listitem><simpara>the notebook that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page</parameter>&nbsp;:</term>
	  <listitem><simpara>the new current page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>page_num</parameter>&nbsp;:</term>
	  <listitem><simpara>the index of the new current
page</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "switch-page" signal is emitted when the notebook page is
changed. Note the <parameter>page</parameter> parameter is a GPointer and
not usable within PyGTK. Use the <parameter>page_num</parameter> parameter
to retrieve the new current page using the <link
linkend="method-gtknotebook--get-nth-page"><methodname>get_nth_page</methodname>()</link>
method.</para>

    </refsect2>

  </refsect1>

</refentry>