1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gtk.Notebook</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="previous" href="class-gtkmisc.html" title="gtk.Misc"><link rel="next" href="class-gtkobject.html" title="gtk.Object"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Notebook</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkmisc.html">Prev</a></td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"><a accesskey="n" href="class-gtkobject.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtknotebook"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>gtk.Notebook</h2><p>gtk.Notebook — a tabbed notebook container.</p></div><div class="refsect1" lang="en"><a name="id3470695"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Notebook</span></span>(<span class="ooclass"><span class="classname"><a href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a 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 href="class-gtknotebook.html#method-gtknotebook--append-page" title="gtk.Notebook.append_page">append_page</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtknotebook.html#method-gtknotebook--prepend-page" title="gtk.Notebook.prepend_page">prepend_page</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtknotebook.html#method-gtknotebook--insert-page" title="gtk.Notebook.insert_page">insert_page</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span><span class="initializer">=-1</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span><span class="initializer">=-1</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtknotebook.html#method-gtknotebook--remove-page" title="gtk.Notebook.remove_page">remove_page</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>page_num</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>page_num</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtknotebook.html#method-gtknotebook--page-num" title="gtk.Notebook.page_num">page_num</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>page_num</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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"><b class="parameter"><tt>show_border</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>show_tabs</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>pos</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtknotebook.html#method-gtknotebook--set-scrollable" title="gtk.Notebook.set_scrollable">set_scrollable</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>scrollable</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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 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"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_text</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_text</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>expand</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>fill</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>pack_type</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtknotebook.html#method-gtknotebook--reorder-child" title="gtk.Notebook.reorder_child">reorder_child</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3471580"></a><h2>Ancestry</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="synopsis">+-- <a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a>
+-- <a href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a href="class-gtknotebook.html" title="gtk.Notebook">gtk.Notebook</a>
</pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3471622"></a><h2>Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"enable-popup"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, pressing the right mouse
button on the notebook pops up a menu that you can use to go to a
page</td></tr><tr valign="top"><td valign="top">"homogeneous"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, tabs should have
homogeneous sizes </td></tr><tr valign="top"><td valign="top">"page"</td><td valign="top">Read-Write</td><td valign="top">The index of the current page</td></tr><tr valign="top"><td valign="top">"scrollable"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, scroll arrows are added if
there are too many tabs to fit</td></tr><tr valign="top"><td valign="top">"show-border"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, the border should be
shown</td></tr><tr valign="top"><td valign="top">"show-tabs"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, tabs should be
shown</td></tr><tr valign="top"><td valign="top">"tab-border"</td><td valign="top">Write</td><td valign="top">The width of the border around the tab labels</td></tr><tr valign="top"><td valign="top">"tab-hborder"</td><td valign="top">Read-Write</td><td valign="top">The width of the horizontal border of tab
labels</td></tr><tr valign="top"><td valign="top">"tab-pos"</td><td valign="top">Read-Write</td><td valign="top">The side of the notebook that holds the tabs:
<tt class="literal">gtk.POS_LEFT</tt>, <tt class="literal">gtk.POS_RIGHT</tt>,
<tt class="literal">gtk.POS_TOP</tt> or <tt class="literal">gtk.POS_BOTTOM</tt></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</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3471887"></a><h2>Child Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><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</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</td></tr><tr valign="top"><td valign="top">"tab-expand"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, expand the child's
tabs</td></tr><tr valign="top"><td valign="top">"tab-fill"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, the child's tab should fill
the allocated area</td></tr><tr valign="top"><td valign="top">"tab-label"</td><td valign="top">Read-Write</td><td valign="top">The string displayed on the child's tab label</td></tr><tr valign="top"><td valign="top">tab-pack""</td><td valign="top">Read-Write</td><td valign="top">A pack type indicating whether the child is packed with
reference to the start or end of the parent:
<tt class="literal">gtk.PACK_START</tt> or
<tt class="literal">gtk.PACK_END</tt>.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3472062"></a><h2>Style Properties</h2><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>These style properties are available in PyGTK 2.4 and above.</p></div><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"has-backward-stepper"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>
the standard backward arrow button is displayed.</td></tr><tr valign="top"><td valign="top">"has-forward-stepper"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>
the standard forward arrow button is displayed.</td></tr><tr valign="top"><td valign="top">"has-secondary-backward-stepper"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt> a second backward arrow
button is displayed on the opposite end of the tab area.</td></tr><tr valign="top"><td valign="top">"has-secondary-forward-stepper"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt> a second forward arrow
button is displayed on the opposite end of the tab area.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3472212"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table cellpadding="5" width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"tab_pos"</td><td valign="top">Read</td><td valign="top">The side of the notebook that holds the tabs:
<tt class="literal">gtk.POS_LEFT</tt>, <tt class="literal">gtk.POS_RIGHT</tt>,
<tt class="literal">gtk.POS_TOP</tt> or <tt class="literal">gtk.POS_BOTTOM</tt></td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3472299"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term">"<a href="class-gtknotebook.html#signal-gtknotebook--change-current-page" title='The "change-current-page" gtk.Notebook Signal'>change-current-page</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>offset</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtknotebook.html#signal-gtknotebook--focus-tab" title='The "focus-tab" gtk.Notebook Signal'>focus-tab</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>type</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtknotebook.html#signal-gtknotebook--move-focus-out" title='The "move-focus-out" gtk.Notebook Signal'>move-focus-out</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>direction_type</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtknotebook.html#signal-gtknotebook--select-page" title='The "select-page" gtk.Notebook Signal'>select-page</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>move_focus</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtknotebook.html#signal-gtknotebook--switch-page" title='The "switch-page" gtk.Notebook Signal'>switch-page</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>page</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>page_num</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3472567"></a><h2>Description</h2><p>The <a href="class-gtknotebook.html" title="gtk.Notebook"><tt class="classname">gtk.Notebook</tt></a>
widget is a <a href="class-gtkcontainer.html" title="gtk.Container"><tt class="classname">gtk.Container</tt></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
<a href="class-gtknotebook.html" title="gtk.Notebook"><tt class="classname">gtk.Notebook</tt></a>. You
can choose on which edge the tabs appear (see <a href="class-gtknotebook.html#method-gtknotebook--set-tab-pos" title="gtk.Notebook.set_tab_pos"><tt class="methodname">set_tab_pos</tt>()</a>);
whether the notebook should be made bigger or scrolling arrows added if
there are too many tabs to fit (see <a href="class-gtknotebook.html#method-gtknotebook--set-scrollable" title="gtk.Notebook.set_scrollable"><tt class="methodname">set_scrollable</tt>()</a>);
and, whether there will be a popup menu allowing the users to switch pages.
(see <a href="class-gtknotebook.html#method-gtknotebook--popup-enable" title="gtk.Notebook.popup_enable"><tt class="methodname">popup_enable</tt>()</a>,
<a href="class-gtknotebook.html#method-gtknotebook--popup-disable" title="gtk.Notebook.popup_disable"><tt class="methodname">popup_disable</tt>()</a>).</p><p>The <a href="class-gtknotebook.html" title="gtk.Notebook"><tt class="classname">gtk.Notebook</tt></a> 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.</p></div><div class="refsect1" lang="en"><a name="constructor-gtknotebook"></a><h2>Constructor</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.Notebook</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the newly created <a href="class-gtknotebook.html" title="gtk.Notebook"><tt class="classname">gtk.Notebook</tt></a></td></tr></tbody></table><p>Creates a new <a href="class-gtknotebook.html" title="gtk.Notebook"><tt class="classname">gtk.Notebook</tt></a>
widget with no pages.</p></div><div class="refsect1" lang="en"><a name="id3472720"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtknotebook--append-page"></a><h3>gtk.Notebook.append_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">append_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to be
used as the label for the page.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">append_page</tt>() method appends a page
to the notebook using the widget specified by <i class="parameter"><tt>child</tt></i>
and the widget specified by <i class="parameter"><tt>tab_label</tt></i> as the label on
the tab.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. Also if
<i class="parameter"><tt>tab_label</tt></i> is not specified it will default to
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--append-page-menu"></a><h3>gtk.Notebook.append_page_menu</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">append_page_menu</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to be
used as the label for the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>menu_label</tt></b>:</span></td><td>the widget to use as a label for the
page-switch menu, if that is enabled.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">append_page_menu</tt>() method appends a
page to the notebook and specifying the widget to use as the label in the
popup menu. <i class="parameter"><tt>child</tt></i> specifies the widget to use as the
contents of the page; <i class="parameter"><tt>tab_label</tt></i> specifies the widget
to be used as the tab label; and, <i class="parameter"><tt>menu_label</tt></i>
specifies the widget to use in the popup menu.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. If
<i class="parameter"><tt>tab_label</tt></i> is a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> or
<tt class="literal">None</tt> and <i class="parameter"><tt>menu_label</tt></i> is
<tt class="literal">None</tt> then the menu label will have the same text as the
tab label. Otherwise, <i class="parameter"><tt>menu_label</tt></i> must be specified
and not <tt class="literal">None</tt>. These parameters will default to
<tt class="literal">None</tt> in PyGTK 2.4 as well.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--prepend-page"></a><h3>gtk.Notebook.prepend_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">prepend_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to be
used as the label for the page.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">prepend_page</tt>() method prepends a
page to the notebook. <i class="parameter"><tt>child</tt></i> specifies the widget to
use as the contents of the page and <i class="parameter"><tt>tab_label</tt></i>
specifies the widget to be used as the tab label.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. Also if
<i class="parameter"><tt>tab_label</tt></i> is not specified it will default to
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--prepend-page-menu"></a><h3>gtk.Notebook.prepend_page_menu</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">prepend_page_menu</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to be
used as the label for the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>menu_label</tt></b>:</span></td><td>the widget to use as a label for the
page-switch menu, if that is enabled.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">prepend_page_menu</tt>() method prepends
a page to the notebook specifying the widget to use as the label in the
popup menu. <i class="parameter"><tt>child</tt></i> specifies the widget to use as the
contents of the page; <i class="parameter"><tt>tab_label</tt></i> specifies the widget
to use as the tab label; and, <i class="parameter"><tt>menu_label</tt></i> specifies
the widget to use in the popup menu.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. If
<i class="parameter"><tt>tab_label</tt></i> is a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> or
<tt class="literal">None</tt> and <i class="parameter"><tt>menu_label</tt></i> is
<tt class="literal">None</tt> then the menu label will have the same text as the
tab label. Otherwise, <i class="parameter"><tt>menu_label</tt></i> must be specified
and not <tt class="literal">None</tt>. These parameters will default to
<tt class="literal">None</tt> in PyGTK 2.4 as well.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--insert-page"></a><h3>gtk.Notebook.insert_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the
<a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to
be used as the label for the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>position</tt></b>:</span></td><td>the index (starting at 0) at which to insert
the page, or -1 to append the page after all other
pages.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">insert_page</tt>() method inserts a page
into the notebook at the location specified by
<i class="parameter"><tt>position</tt></i> (0 is the first page).
<i class="parameter"><tt>child</tt></i> is the widget to use as the contents of the
page and <i class="parameter"><tt>tab_label</tt></i> specifies the widget to be used as
the tab label. If <i class="parameter"><tt>position</tt></i> is -1 the page is appended
to the notebook. In PyGTK 2.4 and above if <i class="parameter"><tt>tab_label</tt></i>
is <tt class="literal">None</tt> a default label if "page N" is used.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. Also if
<i class="parameter"><tt>tab_label</tt></i> is not specified it will default to
<tt class="literal">None</tt>.</p><p>In Pygtk 2.4 and above <i class="parameter"><tt>position</tt></i> will
default to -1 if not specified.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--insert-page-menu"></a><h3>gtk.Notebook.insert_page_menu</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_page_menu</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to use as
the contents of the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the
<a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a> to
be used as the label for the page.</td></tr><tr><td><span class="term"><b class="parameter"><tt>menu_label</tt></b>:</span></td><td>the widget to use as a label for the
page-switch menu, if that is enabled.</td></tr><tr><td><span class="term"><b class="parameter"><tt>position</tt></b>:</span></td><td>the index (starting at 0) at which to insert
the page, or -1 to append the page after all other
pages.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>in PyGTK 2.0 and 2.2 returns
<tt class="literal">None</tt>. In PyGTK 2.4 and above returns the index
number of the page in the notebook</td></tr></tbody></table><p>The <tt class="methodname">insert_page_menu</tt>() method inserts a
page into the notebook at the location specified by
<i class="parameter"><tt>position</tt></i>. <i class="parameter"><tt>child</tt></i> specifies the
widget to use as the contents of the page; <i class="parameter"><tt>tab_label</tt></i>
specifies the widget to use as the tab label; and
<i class="parameter"><tt>menu_label</tt></i> specifies the widget to use as the label
in the popup menu.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. If
<i class="parameter"><tt>tab_label</tt></i> is a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> or
<tt class="literal">None</tt> and <i class="parameter"><tt>menu_label</tt></i> is
<tt class="literal">None</tt> then the menu label will have the same text as the
tab label. Otherwise, <i class="parameter"><tt>menu_label</tt></i> must be specified
and not <tt class="literal">None</tt>. These parameters will default to
<tt class="literal">None</tt> in PyGTK 2.4 as well.</p><p>In Pygtk 2.4 and above <i class="parameter"><tt>position</tt></i> will
default to -1 if not specified.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--remove-page"></a><h3>gtk.Notebook.remove_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>page_num</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>page_num</tt></b>:</span></td><td>the index of a notebook page, starting from 0.
If -1, the last page will be removed.</td></tr></tbody></table><p>The <tt class="methodname">remove_page</tt>() method removes from
the notebook the page at the location specified by
<i class="parameter"><tt>index</tt></i>. The value of <i class="parameter"><tt>index</tt></i>
starts from 0. If <i class="parameter"><tt>index</tt></i> is -1 the last page of the
notebook will be removed.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-current-page"></a><h3>gtk.Notebook.get_current_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_current_page</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the index (starting from 0) of the current page
in the notebook. If the notebook has no pages, then -1 will be
returned.</td></tr></tbody></table><p>The <tt class="methodname">get_current_page</tt>() method returns
the page index of the current page numbered from 0.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-nth-page"></a><h3>gtk.Notebook.get_nth_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_nth_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>page_num</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>page_num</tt></b>:</span></td><td>the index of a page in the
notebook</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the child widget, or <tt class="literal">None</tt> if
<i class="parameter"><tt>page_num</tt></i> is out of bounds.</td></tr></tbody></table><p>The <tt class="methodname">get_nth_page</tt>() method returns the
child widget contained in the page with the index specified by
<i class="parameter"><tt>page_num</tt></i>. If <i class="parameter"><tt>page_num</tt></i> is out
of bounds for the page range of the notebook this method returns
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-n-pages"></a><h3>gtk.Notebook.get_n_pages</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_n_pages</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of pages in the
notebook.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">get_n_pages</tt>() method returns the
number of pages in a notebook.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--page-num"></a><h3>gtk.Notebook.page_num</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">page_num</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a <a href="class-gtkwidget.html" title="gtk.Widget"><tt class="classname">gtk.Widget</tt></a></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the index of the page containing
<i class="parameter"><tt>child</tt></i>, or -1 if <i class="parameter"><tt>child</tt></i> is not
in the notebook.</td></tr></tbody></table><p>The <tt class="methodname">page_num</tt>() method returns the index
of the page which contains the widget specified by
<i class="parameter"><tt>child</tt></i> or <tt class="literal">None</tt> if no page contains
<i class="parameter"><tt>child</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-current-page"></a><h3>gtk.Notebook.set_current_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_current_page</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>page_num</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>page_num</tt></b>:</span></td><td>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.</td></tr></tbody></table><p>The <tt class="methodname">set_current_page</tt>() method switches
to the page number specified by <i class="parameter"><tt>page_num</tt></i>. If
<i class="parameter"><tt>page_num</tt></i> is negative the last page is
selected.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--next-page"></a><h3>gtk.Notebook.next_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">next_page</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">next_page</tt>() method switches to the
next page. Nothing happens if the current page is the last page.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--prev-page"></a><h3>gtk.Notebook.prev_page</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">prev_page</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">prev_page</tt>() method switches to the
previous page. Nothing happens if the current page is the first page.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-show-border"></a><h3>gtk.Notebook.set_show_border</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_border</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>show_border</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>show_border</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> a bevel should be
drawn around the notebook.</td></tr></tbody></table><p>The <tt class="methodname">show_border</tt>() method sets the
"show-border" property to the value of <i class="parameter"><tt>show_border</tt></i>.
If <i class="parameter"><tt>show_border</tt></i> is <tt class="literal">TRUE</tt> a bevel
will be drawn around the notebook pages. This only has a visual effect when
the tabs are not shown. See <a href="class-gtknotebook.html#method-gtknotebook--set-show-tabs" title="gtk.Notebook.set_show_tabs"><tt class="methodname">set_show_tabs</tt>()</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-show-border"></a><h3>gtk.Notebook.get_show_border</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_border</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the bevel should be
drawn</td></tr></tbody></table><p>The <tt class="methodname">get_show_border</tt>() method returns
the value of the "show-border" property. If "show-border" is
<tt class="literal">TRUE</tt> a bevel will be drawn around the notebook pages when
tabs are not shown. See <a href="class-gtknotebook.html#method-gtknotebook--set-show-border" title="gtk.Notebook.set_show_border"><tt class="methodname">set_show_border</tt>()</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-show-tabs"></a><h3>gtk.Notebook.set_show_tabs</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_tabs</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>show_tabs</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>show_tabs</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the tabs should be
shown.</td></tr></tbody></table><p>The <tt class="methodname">set_show_tabs</tt>() method sets the
"show-tabs" property to the value of <i class="parameter"><tt>show_tabs</tt></i>. If
<i class="parameter"><tt>show_tabs</tt></i> is <tt class="literal">TRUE</tt> the notebook
tabs will be displayed.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-show-tabs"></a><h3>gtk.Notebook.get_show_tabs</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_tabs</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the tabs are
shown</td></tr></tbody></table><p>The <tt class="methodname">get_show_tabs</tt>() method returns the
value of the "show-tabs" property. If "show-tabs" is <tt class="literal">TRUE</tt>
the tabs of the notebook are shown. See <a href="class-gtknotebook.html#method-gtknotebook--set-show-tabs" title="gtk.Notebook.set_show_tabs"><tt class="methodname">set_show_tabs</tt>()</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-tab-pos"></a><h3>gtk.Notebook.set_tab_pos</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tab_pos</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>pos</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>pos</tt></b>:</span></td><td>the edge to draw the tabs at:
<tt class="literal">gtk.POS_LEFT</tt>, <tt class="literal">gtk.POS_RIGHT</tt>,
<tt class="literal">gtk.POS_TOP</tt> or
<tt class="literal">gtk.POS_BOTTOM</tt>.</td></tr></tbody></table><p>The <tt class="methodname">set_tab_pos</tt>() method sets the edge
at which the tabs for switching pages in the notebook are drawn as specified
by <i class="parameter"><tt>pos</tt></i>. The value of <i class="parameter"><tt>pos</tt></i> can
be one of: <tt class="literal">gtk.POS_LEFT</tt>,
<tt class="literal">gtk.POS_RIGHT</tt>, <tt class="literal">gtk.POS_TOP</tt> or
<tt class="literal">gtk.POS_BOTTOM</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-tab-pos"></a><h3>gtk.Notebook.get_tab_pos</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_tab_pos</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the edge at which the tabs are
drawn</td></tr></tbody></table><p>The <tt class="methodname">get_tab_pos</tt>() method returns the
edge at which the tabs for switching pages in the notebook are drawn. The
return value is one of: <tt class="literal">gtk.POS_LEFT</tt>,
<tt class="literal">gtk.POS_RIGHT</tt>, <tt class="literal">gtk.POS_TOP</tt> or
<tt class="literal">gtk.POS_BOTTOM</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-scrollable"></a><h3>gtk.Notebook.set_scrollable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_scrollable</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>scrollable</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>scrollable</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> scroll arrows should
be added</td></tr></tbody></table><p>The <tt class="methodname">set_scrollable</tt>() method sets the
"scrollable" property to the value specified by
<i class="parameter"><tt>scrollable</tt></i>. If <i class="parameter"><tt>scrollable</tt></i> is
<tt class="literal">TRUE</tt> the tab label area will have arrows for scrolling if
there are too many tabs to fit in the area.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-scrollable"></a><h3>gtk.Notebook.get_scrollable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_scrollable</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if arrows for scrolling
are enabled</td></tr></tbody></table><p>The <tt class="methodname">get_scrollable</tt>() method returns the
value of the "scrollable" property. If "scrollable" is
<tt class="literal">TRUE</tt> the tab label area has scrolling arrows enabled and
displayed if there are too many tabs to fit in the display area. See <a href="class-gtknotebook.html#method-gtknotebook--set-scrollable" title="gtk.Notebook.set_scrollable"><tt class="methodname">set_scrollable</tt>()</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--popup-enable"></a><h3>gtk.Notebook.popup_enable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">popup_enable</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">popup_enable</tt>() 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.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--popup-disable"></a><h3>gtk.Notebook.popup_disable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">popup_disable</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">popup_disable</tt>() method disables the
popup menu.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-tab-label"></a><h3>gtk.Notebook.get_tab_label</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_tab_label</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the tab label widget for the page containing
<i class="parameter"><tt>child</tt></i></td></tr></tbody></table><p>The <tt class="methodname">get_tab_label</tt>() method returns the
tab label widget for the page containing the widget
<i class="parameter"><tt>child</tt></i>. <tt class="literal">None</tt> is returned if
<i class="parameter"><tt>child</tt></i> is not in the notebook.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-tab-label"></a><h3>gtk.Notebook.set_tab_label</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tab_label</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_label</tt></b>:</span></td><td>the tab label widget to
use or <tt class="literal">None</tt>.</td></tr></tbody></table><p>The <tt class="methodname">set_tab_label</tt>() method replaces the
tab label for the notebook page containing <i class="parameter"><tt>child</tt></i> with
the widget specified by <i class="parameter"><tt>tab_label</tt></i>.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>tab_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. Also if
<i class="parameter"><tt>tab_label</tt></i> is not specified it will default to
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-tab-label-text"></a><h3>gtk.Notebook.set_tab_label_text</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tab_label_text</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tab_text</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><b class="parameter"><tt>tab_text</tt></b>:</span></td><td>the new label text</td></tr></tbody></table><p>The <tt class="methodname">set_tab_label_text</tt>() method creates
a new label with the text specified by <i class="parameter"><tt>tab_text</tt></i> and
sets it as the tab label for the page containing
<i class="parameter"><tt>child</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-tab-label-text"></a><h3>gtk.Notebook.get_tab_label_text</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_tab_label_text</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>value: the text of the tab label, or
<tt class="literal">None</tt> if the tab label widget is not a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> or
<i class="parameter"><tt>child</tt></i> is not in a notebook page.</td></tr></tbody></table><p>The <tt class="methodname">get_tab_label_text</tt>() retrieves the
text of the tab label for the page containing <i class="parameter"><tt>child</tt></i>.
This method returns <tt class="literal">None</tt> if <i class="parameter"><tt>child</tt></i>
is not in a notebook page or the page tab label is not a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a>
widget.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-menu-label"></a><h3>gtk.Notebook.get_menu_label</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_menu_label</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the menu label, or <tt class="literal">None</tt> 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 <tt class="methodname">get_menu_label</tt>() method retrieves
the menu label widget of the page containing <i class="parameter"><tt>child</tt></i>.
If <i class="parameter"><tt>child</tt></i> is not in a notebook page or the menu label
has not been set (it defaults to the tab label), this method returns
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-menu-label"></a><h3>gtk.Notebook.set_menu_label</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_menu_label</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_label</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><b class="parameter"><tt>menu_label</tt></b>:</span></td><td>a widget to be used as the new menu
label</td></tr></tbody></table><p>The <tt class="methodname">set_menu_label</tt>() replaces the menu
label for the page containing <i class="parameter"><tt>child</tt></i> with the widget
specified by <i class="parameter"><tt>menu_label</tt></i>.</p><p>In PyGTK 2.4 and above <i class="parameter"><tt>menu_label</tt></i> can be
<tt class="literal">None</tt> to use a default label. Also if
<i class="parameter"><tt>menu_label</tt></i> is not specified it will default to
<tt class="literal">None</tt>. See the <a href="class-gtknotebook.html#method-gtknotebook--append-page-menu" title="gtk.Notebook.append_page_menu"><tt class="methodname">append_page_menu</tt>()</a>
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-menu-label-text"></a><h3>gtk.Notebook.set_menu_label_text</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_menu_label_text</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>menu_text</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><b class="parameter"><tt>menu_text</tt></b>:</span></td><td>the new menu label text</td></tr></tbody></table><p>The <tt class="methodname">set_menu_label_text</tt>() method
creates a new label widget and replaces the menu label of the page
containing<i class="parameter"><tt>child</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--get-menu-label-text"></a><h3>gtk.Notebook.get_menu_label_text</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_menu_label_text</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a child widget of a notebook
page.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>value: the text of the tab label, or
<tt class="literal">None</tt> if the widget does not have a menu label other than
the default menu label, or the menu label widget is not a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> or
<i class="parameter"><tt>child</tt></i> is not contained in a notebook
page.</td></tr></tbody></table><p>The <tt class="methodname">get_menu_label_text</tt>() method
retrieves the text of the menu label for the page containing
<i class="parameter"><tt>child</tt></i>. If <i class="parameter"><tt>child</tt></i> is not in a
notebook page or the menu label is not a <a href="class-gtklabel.html" title="gtk.Label"><tt class="classname">gtk.Label</tt></a> widget or
the menu label has not been set (it default to the tab label), the return
value is <tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--query-tab-label-packing"></a><h3>gtk.Notebook.query_tab_label_packing</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">query_tab_label_packing</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the page</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a tuple containing: the expand value, the fill
value and the pack type</td></tr></tbody></table><p>The <tt class="methodname">query_tab_label_packing</tt>() method
returns a tuple containing the packing attributes (expand, fill, pack type)
for the tab label of the page containing <i class="parameter"><tt>child</tt></i>. If
the expand attribute is <tt class="literal">TRUE</tt> the tab can expand to take
up the free space in the tab area. If fill is <tt class="literal">TRUE</tt> the
label widget in the tab can use up all the space in the tab. The pack type
can be one of <tt class="literal">gtk.PACK_START</tt> or
<tt class="literal">gtk.PACK_END</tt> 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).</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--set-tab-label-packing"></a><h3>gtk.Notebook.set_tab_label_packing</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tab_label_packing</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>expand</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>fill</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>pack_type</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>a widget contained in a notebook
page</td></tr><tr><td><span class="term"><b class="parameter"><tt>expand</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the tab can expand
to fill the free space in the tab area</td></tr><tr><td><span class="term"><b class="parameter"><tt>fill</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the label widget can
fill the space in the tab</td></tr><tr><td><span class="term"><b class="parameter"><tt>pack_type</tt></b>:</span></td><td>the position of the tab:
<tt class="literal">gtk.PACK_START</tt> or
<tt class="literal">gtk.PACK_END</tt></td></tr></tbody></table><p>The <tt class="methodname">set_tab_label_packing</tt>() method sets
the packing parameters for the tab label of the page containing
<i class="parameter"><tt>child</tt></i>. If <i class="parameter"><tt>expand</tt></i> is
<tt class="literal">TRUE</tt> the tab can expand to take up the free space in the
tab area. If <i class="parameter"><tt>fill</tt></i> is <tt class="literal">TRUE</tt> the
label widget in the tab can use up all the space in the tab. The
<i class="parameter"><tt>pack_type</tt></i> can be one of
<tt class="literal">gtk.PACK_START</tt> or <tt class="literal">gtk.PACK_END</tt> 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 <a href="class-gtkbox.html#method-gtkbox--pack-start" title="gtk.Box.pack_start"><tt class="methodname">gtk.Box.pack_start</tt>()</a>
for the exact meaning of the parameters.</p></div><div class="refsect2" lang="en"><a name="method-gtknotebook--reorder-child"></a><h3>gtk.Notebook.reorder_child</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">reorder_child</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>child</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>child</tt></b>:</span></td><td>the child widget to move</td></tr><tr><td><span class="term"><b class="parameter"><tt>position</tt></b>:</span></td><td>the index of the page that
<i class="parameter"><tt>child</tt></i> is to move to, or -1 to move to the
end</td></tr></tbody></table><p>The <tt class="methodname">reorder_child</tt>() method reorders
the notebook pages so that <i class="parameter"><tt>child</tt></i> appears in the page
whose index is specified by <i class="parameter"><tt>position</tt></i>. If
<i class="parameter"><tt>position</tt></i> is greater than or equal to the number of
children in the list or negative, <i class="parameter"><tt>child</tt></i> will be moved
to the end of the list.</p></div></div><div class="refsect1" lang="en"><a name="id3476345"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtknotebook--change-current-page"></a><h3>The "change-current-page" gtk.Notebook Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>offset</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>notebook</tt></i>:</span></td><td>the notebook that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>offset</tt></i>:</span></td><td>the count of pages to move (negative count is
backward)</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "change-current-page" signal is emitted when the page
forward or page backward request is issued.</p></div><div class="refsect2" lang="en"><a name="signal-gtknotebook--focus-tab"></a><h3>The "focus-tab" gtk.Notebook Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>type</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>notebook</tt></i>:</span></td><td>the notebook that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>type</tt></i>:</span></td><td>the type of tab:
<tt class="literal">gtk.NOTEBOOK_TAB_FIRST</tt> or
<tt class="literal">gtk.NOTEBOOK_TAB_LAST</tt></td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled</td></tr></tbody></table><p>The "focus-tab" signal is emitted when the focus is changed by
tabbing.</p></div><div class="refsect2" lang="en"><a name="signal-gtknotebook--move-focus-out"></a><h3>The "move-focus-out" gtk.Notebook Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>direction_type</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>notebook</tt></i>:</span></td><td>the notebook that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>direction_type</tt></i>:</span></td><td>the direction type of the focus move:
<tt class="literal">gtk.DIR_TAB_FORWARD</tt>,
<tt class="literal">gtk.DIR_TAB_BACKWARD</tt>, <tt class="literal">gtk.DIR_UP</tt>,
<tt class="literal">gtk.DIR_DOWN</tt>, <tt class="literal">gtk.DIR_LEFT</tt> or
<tt class="literal">gtk.DIR_RIGHT</tt></td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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
<i class="parameter"><tt>direction_type</tt></i>.</p></div><div class="refsect2" lang="en"><a name="signal-gtknotebook--select-page"></a><h3>The "select-page" gtk.Notebook Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>move_focus</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>notebook</tt></i>:</span></td><td>the notebook that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>move_focus</tt></i>:</span></td><td>if <tt class="literal">TRUE</tt> move the
focus to a child widget</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled</td></tr></tbody></table><p>The "select-page" signal is emitted when a new child page is
selected.</p></div><div class="refsect2" lang="en"><a name="signal-gtknotebook--switch-page"></a><h3>The "switch-page" gtk.Notebook Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>notebook</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>page</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>page_num</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>notebook</tt></i>:</span></td><td>the notebook that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "switch-page" signal is emitted when the notebook page is
changed.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkmisc.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="class-gtkobject.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.Misc</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">gtk.Object</td></tr></table></div></body></html>
|
