~ubuntu-branches/ubuntu/natty/pygtk/natty-proposed

<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtknotebook.html#constructor-gtknotebook" title="Constructor">gtk.Notebook</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--append-page" title="gtk.Notebook.append_page">append_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--append-page-menu" title="gtk.Notebook.append_page_menu">append_page_menu</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>menu_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--prepend-page" title="gtk.Notebook.prepend_page">prepend_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--prepend-page-menu" title="gtk.Notebook.prepend_page_menu">prepend_page_menu</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>menu_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--insert-page" title="gtk.Notebook.insert_page">insert_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span><span class="initializer">=-1</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--insert-page-menu" title="gtk.Notebook.insert_page_menu">insert_page_menu</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>menu_label</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span><span class="initializer">=-1</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--remove-page" title="gtk.Notebook.remove_page">remove_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>page_num</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-current-page" title="gtk.Notebook.get_current_page">get_current_page</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-nth-page" title="gtk.Notebook.get_nth_page">get_nth_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>page_num</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-n-pages" title="gtk.Notebook.get_n_pages">get_n_pages</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--page-num" title="gtk.Notebook.page_num">page_num</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-current-page" title="gtk.Notebook.set_current_page">set_current_page</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>page_num</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--next-page" title="gtk.Notebook.next_page">next_page</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--prev-page" title="gtk.Notebook.prev_page">prev_page</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-show-border" title="gtk.Notebook.set_show_border">set_show_border</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_border</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-show-border" title="gtk.Notebook.get_show_border">get_show_border</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-show-tabs" title="gtk.Notebook.set_show_tabs">set_show_tabs</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_tabs</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-show-tabs" title="gtk.Notebook.get_show_tabs">get_show_tabs</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-pos" title="gtk.Notebook.set_tab_pos">set_tab_pos</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pos</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-tab-pos" title="gtk.Notebook.get_tab_pos">get_tab_pos</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-scrollable" title="gtk.Notebook.set_scrollable">set_scrollable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>scrollable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-scrollable" title="gtk.Notebook.get_scrollable">get_scrollable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--popup-enable" title="gtk.Notebook.popup_enable">popup_enable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--popup-disable" title="gtk.Notebook.popup_disable">popup_disable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-tab-label" title="gtk.Notebook.get_tab_label">get_tab_label</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-label" title="gtk.Notebook.set_tab_label">set_tab_label</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-label-text" title="gtk.Notebook.set_tab_label_text">set_tab_label_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tab_text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-tab-label-text" title="gtk.Notebook.get_tab_label_text">get_tab_label_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-menu-label" title="gtk.Notebook.get_menu_label">get_menu_label</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-menu-label" title="gtk.Notebook.set_menu_label">set_menu_label</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>menu_label</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-menu-label-text" title="gtk.Notebook.set_menu_label_text">set_menu_label_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>menu_text</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-menu-label-text" title="gtk.Notebook.get_menu_label_text">get_menu_label_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--query-tab-label-packing" title="gtk.Notebook.query_tab_label_packing">query_tab_label_packing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-label-packing" title="gtk.Notebook.set_tab_label_packing">set_tab_label_packing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>fill</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pack_type</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--reorder-child" title="gtk.Notebook.reorder_child">reorder_child</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-group-id" title="gtk.Notebook.set_group_id">set_group_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>group_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-group-id" title="gtk.Notebook.get_group_id">get_group_id</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-tab-reorderable" title="gtk.Notebook.get_tab_reorderable">get_tab_reorderable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-reorderable" title="gtk.Notebook.set_tab_reorderable">set_tab_reorderable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--get-tab-detachable" title="gtk.Notebook.get_tab_detachable">get_tab_detachable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtknotebook.html#method-gtknotebook--set-tab-detachable" title="gtk.Notebook.set_tab_detachable">set_tab_detachable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>detachable</code></strong></span></span>)</code><br></pre></td></tr></table><pre class="programlisting">

<span class="bold"><strong>Functions</strong></span>

 

  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>

    +-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>

      +-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>

        +-- <a class="link" href="class-gtknotebook.html" title="gtk.Notebook">gtk.Notebook</a>

                        <a class="link" href="class-gtknotebook.html" title="gtk.Notebook"><code class="classname">gtk.Notebook</code></a>

                        implements 

                        <a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>

              button on the notebook pops up a menu that you can use to go

              to a page.  Default value: <code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"group-id"</td><td valign="top">Read-Write</td><td valign="top">Group ID for tabs drag and drop. Allowed values: &gt;=

          -1. Default value: -1.</td></tr><tr valign="top"><td valign="top">"homogeneous"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, tabs should have

              <code class="literal">gtk.POS_TOP</code> or

              <code class="literal">gtk.POS_BOTTOM</code>.  Default value:

              <code class="literal">gtk.POS_TOP</code>.</td></tr><tr valign="top"><td valign="top">"tab-vborder"</td><td valign="top">Read-Write</td><td valign="top">The width of the vertical border of tab labels.

              the scroll arrows and the tabs. Allowed values: &gt;= 0.

              Default value: 0. Available in GTK+ 2.10.</td></tr><tr valign="top"><td valign="top">"has-backward-stepper"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the standard backward arrow

              button is displayed. Default value:

              GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"tab-curvature"</td><td valign="top">Read-Write</td><td valign="top">The "tab-curvature" property defines size of tab

              curvature. Allowed values: &gt;= 0. Default value: 1. Available

              in GTK+ 2.10.</td></tr><tr valign="top"><td valign="top">"tab-overlap"</td><td valign="top">Read-Write</td><td valign="top">The "tab-overlap" property defines size of tab overlap

              Default value: <code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"menu-label"</td><td valign="top">Read-Write</td><td valign="top">The string displayed in the child's menu entry.

              Default value: <code class="literal">None</code></td></tr><tr valign="top"><td valign="top">"position"</td><td valign="top">Read-Write</td><td valign="top">The index of the child in the parent. Allowed values:

              &gt;= -1 Default value: 0.</td></tr><tr valign="top"><td valign="top">"tab-expand"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, expand the child's tabs.

              reference to the start or end of the parent - one of the <a class="xref" href="gtk-constants.html#gtk-pack-type-constants" title="GTK Pack Type Constants">GTK Pack Type Constants</a>:

              <code class="literal">gtk.PACK_START</code> or

              <code class="literal">gtk.PACK_END</code>.  Default value:

<code class="literal">gtk.POS_LEFT</code>, <code class="literal">gtk.POS_RIGHT</code>,

widget is a <a class="link" href="class-gtkcontainer.html" title="gtk.Container"><code class="classname">gtk.Container</code></a>

whose children are overlapping pages that can be switched between by  using

tab labels along one edge. There are many configuration options for the

          "type" attribute of a &lt;child&gt; 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 &lt;child&gt; type attribute.

 

&lt;object class="GtkNotebook"&gt;

  &lt;child&gt;

                custom element in a &lt;child&gt; element gets parsed by the custom tag handler of

                the parent object, while a custom element in an &lt;object&gt; element gets parsed

                by the custom tag handler of the object.

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to be

used as the label for the page.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>in PyGTK 2.0 and 2.2 returns

          <code class="literal">None</code>. In PyGTK 2.4 and above returns the index

the tab.</p><p>In PyGTK 2.4 and above <em class="parameter"><code>tab_label</code></em> can be

<code class="literal">None</code> to use a default label. Also if

<em class="parameter"><code>tab_label</code></em> is not specified it will default to

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to be

used as the label for the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>menu_label</code></strong> :</span></p></td><td>the widget to use as a label for the

page-switch menu, if that is enabled.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>in PyGTK 2.0 and 2.2 returns

<code class="literal">None</code> then the menu label will have the same text as the

tab label. Otherwise, <em class="parameter"><code>menu_label</code></em> must be specified

and not <code class="literal">None</code>. These parameters will default to

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to be

used as the label for the page.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>in PyGTK 2.0 and 2.2 returns

          <code class="literal">None</code>. In PyGTK 2.4 and above returns the index

specifies the widget to be used as the tab label.</p><p>In PyGTK 2.4 and above <em class="parameter"><code>tab_label</code></em> can be

<code class="literal">None</code> to use a default label. Also if

<em class="parameter"><code>tab_label</code></em> is not specified it will default to

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to be

used as the label for the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>menu_label</code></strong> :</span></p></td><td>the widget to use as a label for the

page-switch menu, if that is enabled.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>in PyGTK 2.0 and 2.2 returns

<code class="literal">None</code> then the menu label will have the same text as the

tab label. Otherwise, <em class="parameter"><code>menu_label</code></em> must be specified

and not <code class="literal">None</code>. These parameters will default to

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the

<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to

be used as the label for the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong> :</span></p></td><td>the index (starting at 0) at which to insert

<code class="literal">None</code> to use a default label. Also if

<em class="parameter"><code>tab_label</code></em> is not specified it will default to

<code class="literal">None</code>.</p><p>In Pygtk 2.4 and above <em class="parameter"><code>position</code></em> will

the contents of the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the

<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> to

be used as the label for the page.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>menu_label</code></strong> :</span></p></td><td>the widget to use as a label for the

tab label. Otherwise, <em class="parameter"><code>menu_label</code></em> must be specified

and not <code class="literal">None</code>. These parameters will default to

<code class="literal">None</code> in PyGTK 2.4 as well.</p><p>In Pygtk 2.4 and above <em class="parameter"><code>position</code></em> will

If -1, the last page will be removed.</td></tr></tbody></table><p>The <code class="methodname">remove_page</code>() method removes from

the notebook the page at the location specified by

<em class="parameter"><code>index</code></em>. The value of <em class="parameter"><code>index</code></em>

starts from 0. If <em class="parameter"><code>index</code></em> is -1 the last page of the

in the notebook. If the notebook has no pages, then -1 will be

returned.</td></tr></tbody></table><p>The <code class="methodname">get_current_page</code>() method returns

notebook</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the child widget, or <code class="literal">None</code> if

<em class="parameter"><code>page_num</code></em> is out of bounds.</td></tr></tbody></table><p>The <code class="methodname">get_nth_page</code>() method returns the

child widget contained in the page with the index specified by

<em class="parameter"><code>page_num</code></em>. If <em class="parameter"><code>page_num</code></em> is out

of bounds for the page range of the notebook this method returns

<em class="parameter"><code>child</code></em>, or -1 if <em class="parameter"><code>child</code></em> is not

in the notebook.</td></tr></tbody></table><p>The <code class="methodname">page_num</code>() method returns the index

of the page which contains the widget specified by

<em class="parameter"><code>child</code></em> or <code class="literal">None</code> if no page contains

from 0. If negative, the last page will be used. If greater than the number

of pages in the notebook, nothing will be done.</td></tr></tbody></table><p>The <code class="methodname">set_current_page</code>() method switches

to the page number specified by <em class="parameter"><code>page_num</code></em>. If

<em class="parameter"><code>page_num</code></em> is negative the last page is

drawn around the notebook.</td></tr></tbody></table><p>The <code class="methodname">show_border</code>() method sets the

"show-border" property to the value of <em class="parameter"><code>show_border</code></em>.

If <em class="parameter"><code>show_border</code></em> is <code class="literal">True</code> a bevel

will be drawn around the notebook pages. This only has a visual effect when

drawn</td></tr></tbody></table><p>The <code class="methodname">get_show_border</code>() method returns

the value of the "show-border" property. If "show-border" is

<code class="literal">True</code> a bevel will be drawn around the notebook pages when

shown.</td></tr></tbody></table><p>The <code class="methodname">set_show_tabs</code>() method sets the

"show-tabs" property to the value of <em class="parameter"><code>show_tabs</code></em>. If

<em class="parameter"><code>show_tabs</code></em> is <code class="literal">True</code> the notebook

shown</td></tr></tbody></table><p>The <code class="methodname">get_show_tabs</code>() method returns the

value of the "show-tabs" property. If "show-tabs" is <code class="literal">True</code>

<code class="literal">gtk.POS_LEFT</code>, <code class="literal">gtk.POS_RIGHT</code>,

<code class="literal">gtk.POS_TOP</code> or

<code class="literal">gtk.POS_BOTTOM</code>.</td></tr></tbody></table><p>The <code class="methodname">set_tab_pos</code>() method sets the edge

by <em class="parameter"><code>pos</code></em>. The value of <em class="parameter"><code>pos</code></em> can

be one of: <code class="literal">gtk.POS_LEFT</code>,

<code class="literal">gtk.POS_RIGHT</code>, <code class="literal">gtk.POS_TOP</code> or

drawn</td></tr></tbody></table><p>The <code class="methodname">get_tab_pos</code>() method returns the

edge at which the tabs for switching pages in the notebook are drawn. The

return value is one of: <code class="literal">gtk.POS_LEFT</code>,

<code class="literal">gtk.POS_RIGHT</code>, <code class="literal">gtk.POS_TOP</code> or

be added</td></tr></tbody></table><p>The <code class="methodname">set_scrollable</code>() method sets the

"scrollable" property to the value specified by

<em class="parameter"><code>scrollable</code></em>. If <em class="parameter"><code>scrollable</code></em> is

<code class="literal">True</code> the tab label area will have arrows for scrolling if

are enabled</td></tr></tbody></table><p>The <code class="methodname">get_scrollable</code>() method returns the

value of the "scrollable" property. If "scrollable" is

<code class="literal">True</code> the tab label area has scrolling arrows enabled and

popup menu: if the user clicks with the right mouse button on the tabs, a

page</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the tab label widget for the page containing

<em class="parameter"><code>child</code></em></td></tr></tbody></table><p>The <code class="methodname">get_tab_label</code>() method returns the

tab label widget for the page containing the widget

<em class="parameter"><code>child</code></em>. <code class="literal">None</code> is returned if

page</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_label</code></strong> :</span></p></td><td>the tab label widget to

use or <code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">set_tab_label</code>() method replaces the

tab label for the notebook page containing <em class="parameter"><code>child</code></em> with

the widget specified by <em class="parameter"><code>tab_label</code></em>.</p><p>In PyGTK 2.4 and above <em class="parameter"><code>tab_label</code></em> can be

<code class="literal">None</code> to use a default label. Also if

<em class="parameter"><code>tab_label</code></em> is not specified it will default to

page</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tab_text</code></strong> :</span></p></td><td>the new label text</td></tr></tbody></table><p>The <code class="methodname">set_tab_label_text</code>() method creates

a new label with the text specified by <em class="parameter"><code>tab_text</code></em> and

sets it as the tab label for the page containing

page</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>value: the text of the tab label, or

<code class="literal">None</code> if the tab label widget is not a <a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a> or

<em class="parameter"><code>child</code></em> is not in a notebook page.</td></tr></tbody></table><p>The <code class="methodname">get_tab_label_text</code>() retrieves the

text of the tab label for the page containing <em class="parameter"><code>child</code></em>.

This method returns <code class="literal">None</code> if <em class="parameter"><code>child</code></em>

is not in a notebook page or the page tab label is not a <a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a>

page</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the menu label, or <code class="literal">None</code> 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.</td></tr></tbody></table><p>The <code class="methodname">get_menu_label</code>() method retrieves

the menu label widget of the page containing <em class="parameter"><code>child</code></em>.

If <em class="parameter"><code>child</code></em> is not in a notebook page or the menu label

has not been set (it defaults to the tab label), this method returns

page</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>menu_label</code></strong> :</span></p></td><td>a widget to be used as the new menu

label</td></tr></tbody></table><p>The <code class="methodname">set_menu_label</code>() replaces the menu

label for the page containing <em class="parameter"><code>child</code></em> with the widget

<code class="literal">None</code> to use a default label. Also if

<em class="parameter"><code>menu_label</code></em> is not specified it will default to

<code class="literal">None</code>. See the <a class="link" href="class-gtknotebook.html#method-gtknotebook--append-page-menu" title="gtk.Notebook.append_page_menu"><code class="methodname">append_page_menu</code>()</a>

page</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>menu_text</code></strong> :</span></p></td><td>the new menu label text</td></tr></tbody></table><p>The <code class="methodname">set_menu_label_text</code>() method

creates a new label widget and replaces the menu label of the page

page.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>value: the text of the tab label, or

<code class="literal">None</code> if the widget does not have a menu label other than

the default menu label, or the menu label widget is not a <a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a> or

<em class="parameter"><code>child</code></em>. If <em class="parameter"><code>child</code></em> is not in a

notebook page or the menu label is not a <a class="link" href="class-gtklabel.html" title="gtk.Label"><code class="classname">gtk.Label</code></a> widget or

the menu label has not been set (it default to the tab label), the return

value and the pack type</td></tr></tbody></table><p>The <code class="methodname">query_tab_label_packing</code>() method

returns a tuple containing the packing attributes (expand, fill, pack type)

for the tab label of the page containing <em class="parameter"><code>child</code></em>. If

can be one of <code class="literal">gtk.PACK_START</code> or

<code class="literal">gtk.PACK_END</code> 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

page</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>expand</code></strong> :</span></p></td><td>if <code class="literal">True</code> the tab can expand

to fill the free space in the tab area</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>fill</code></strong> :</span></p></td><td>if <code class="literal">True</code> the label widget can

fill the space in the tab</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pack_type</code></strong> :</span></p></td><td>the position of the tab:

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 <a class="link" href="class-gtkbox.html#method-gtkbox--pack-start" title="gtk.Box.pack_start"><code class="methodname">gtk.Box.pack_start</code>()</a> 

<em class="parameter"><code>child</code></em> is to move to, or -1 to move to the

end</td></tr></tbody></table><p>The <code class="methodname">reorder_child</code>() method reorders

the notebook pages so that <em class="parameter"><code>child</code></em> appears in the page

whose index is specified by <em class="parameter"><code>position</code></em>. If

<em class="parameter"><code>position</code></em> is greater than or equal to the number of

children in the list or negative, <em class="parameter"><code>child</code></em> will be moved

      group identifier for the notebook to the value specified by

      <em class="parameter"><code>group_id</code></em>. 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

      returns <code class="literal">True</code> if the tab can be reordered via drag

      the "reorderable" property of <em class="parameter"><code>child</code></em> to the

      value of <em class="parameter"><code>reorderable</code></em>. If

      <em class="parameter"><code>reorderable</code></em> is <code class="literal">True</code>, the

      the value of the "detachable" property of

      <em class="parameter"><code>child</code></em>. The method returns

      <em class="parameter"><code>True</code></em> if the tab contents can be detached from

      the "detachable" property of <em class="parameter"><code>child</code></em> to the value

      specified by <em class="parameter"><code>detachable</code></em>. If

      <em class="parameter"><code>detachable</code></em> is <code class="literal">True</code>,

      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.</p><p>If you want a notebook to accept drags from other widgets, you

          in an empty area.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td> data to pass to

function installs a global function (specified by

<em class="parameter"><code>func</code></em>) used to create a window when a detached tab

is dropped in an empty area.</p><p>The signature of the callback function

        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 <code class="literal">None</code>, the drag will be cancelled.

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td><td>the count of pages to move (negative count is

backward)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified

with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>

method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if

any)</td></tr></tbody></table><p>The "change-current-page" signal is emitted when the page

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>page</code></em> :</span></p></td><td>the tab of notebook that is being detached

      </td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td><td>the X coordinate where the drop happens

      </td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td><td>the Y coordinate where the drop happens

      detachable tab is dropped on the root window.</p><p>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

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td><td>the type of tab:

<code class="literal">gtk.NOTEBOOK_TAB_FIRST</code> or

<code class="literal">gtk.NOTEBOOK_TAB_LAST</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified

method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if

any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was

handled</td></tr></tbody></table><p>The "focus-tab" signal is emitted when the focus is changed by

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction_type</code></em> :</span></p></td><td>the direction type of the focus move:

<code class="literal">gtk.DIR_TAB_FORWARD</code>,

<code class="literal">gtk.DIR_TAB_BACKWARD</code>, <code class="literal">gtk.DIR_UP</code>,

method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if

any)</td></tr></tbody></table><p>The "move-focus-out" signal is emitted when the focus is moved

out of the notebook with the specified

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>move_focus</code></em> :</span></p></td><td>if <code class="literal">True</code> move the

focus to a child widget</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified

with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>

method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if

any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was

handled</td></tr></tbody></table><p>The "select-page" signal is emitted when a new child page is

signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>page</code></em> :</span></p></td><td>the new current page</td></tr><tr><td><p><span class="term"><em class="parameter"><code>page_num</code></em> :</span></p></td><td>the index of the new current

page</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified

with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>