1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GtkNotebook</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
<link rel="up" href="LayoutContainers.html" title="Layout Containers">
9
<link rel="prev" href="GtkLayout.html" title="GtkLayout">
10
<link rel="next" href="GtkTable.html" title="GtkTable">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
30
<link rel="chapter" href="Printing.html" title="Printing">
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
37
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
48
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
49
<link rel="glossary" href="glossary.html" title="Glossary">
50
<link rel="index" href="ix01.html" title="Index">
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
61
<td><a accesskey="p" href="GtkLayout.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
64
<th width="100%" align="center">GTK+ Reference Manual</th>
65
<td><a accesskey="n" href="GtkTable.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3531004" class="shortcut">Top</a>
69
<a href="#id3533358" class="shortcut">Description</a>
71
<a href="#id3532668" class="shortcut">Object Hierarchy</a>
73
<a href="#id3532722" class="shortcut">Implemented Interfaces</a>
75
<a href="#id3532745" class="shortcut">Properties</a>
77
<a href="#id3532952" class="shortcut">Child Properties</a>
79
<a href="#id3533106" class="shortcut">Style Properties</a>
81
<a href="#id3533243" class="shortcut">Signals</a></nobr></td></tr>
83
<div class="refentry" lang="en">
84
<a name="GtkNotebook"></a><div class="titlepage"></div>
85
<div class="refnamediv"><table width="100%"><tr>
88
<a name="id3531004"></a><span class="refentrytitle">GtkNotebook</span>
90
<p>GtkNotebook — A tabbed notebook container</p>
92
<td valign="top" align="right"><img src="notebook.png"></td>
94
<div class="refsynopsisdiv">
96
<pre class="synopsis">
98
#include <gtk/gtk.h>
101
<a href="GtkNotebook.html#GtkNotebook-struct">GtkNotebook</a>;
102
<a href="GtkNotebook.html#GtkNotebookPage">GtkNotebookPage</a>;
103
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkNotebook.html#gtk-notebook-new">gtk_notebook_new</a> (void);
104
gint <a href="GtkNotebook.html#gtk-notebook-append-page">gtk_notebook_append_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
105
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
106
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);
107
gint <a href="GtkNotebook.html#gtk-notebook-append-page-menu">gtk_notebook_append_page_menu</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
108
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
109
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
110
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);
111
gint <a href="GtkNotebook.html#gtk-notebook-prepend-page">gtk_notebook_prepend_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
112
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
113
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);
114
gint <a href="GtkNotebook.html#gtk-notebook-prepend-page-menu">gtk_notebook_prepend_page_menu</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
115
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
116
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
117
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);
118
gint <a href="GtkNotebook.html#gtk-notebook-insert-page">gtk_notebook_insert_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
119
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
120
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
122
gint <a href="GtkNotebook.html#gtk-notebook-insert-page-menu">gtk_notebook_insert_page_menu</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
123
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
124
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
125
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label,
127
void <a href="GtkNotebook.html#gtk-notebook-remove-page">gtk_notebook_remove_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
129
#define <a href="GtkNotebook.html#gtk-notebook-current-page">gtk_notebook_current_page</a>
130
gint <a href="GtkNotebook.html#gtk-notebook-page-num">gtk_notebook_page_num</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
131
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
132
#define <a href="GtkNotebook.html#gtk-notebook-set-page">gtk_notebook_set_page</a>
133
void <a href="GtkNotebook.html#gtk-notebook-next-page">gtk_notebook_next_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
134
void <a href="GtkNotebook.html#gtk-notebook-prev-page">gtk_notebook_prev_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
135
void <a href="GtkNotebook.html#gtk-notebook-reorder-child">gtk_notebook_reorder_child</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
136
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
138
void <a href="GtkNotebook.html#gtk-notebook-set-tab-pos">gtk_notebook_set_tab_pos</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
139
<a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> pos);
140
void <a href="GtkNotebook.html#gtk-notebook-set-show-tabs">gtk_notebook_set_show_tabs</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
142
void <a href="GtkNotebook.html#gtk-notebook-set-show-border">gtk_notebook_set_show_border</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
143
gboolean show_border);
144
void <a href="GtkNotebook.html#gtk-notebook-set-scrollable">gtk_notebook_set_scrollable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
145
gboolean scrollable);
146
void <a href="GtkNotebook.html#gtk-notebook-set-tab-border">gtk_notebook_set_tab_border</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
148
void <a href="GtkNotebook.html#gtk-notebook-popup-enable">gtk_notebook_popup_enable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
149
void <a href="GtkNotebook.html#gtk-notebook-popup-disable">gtk_notebook_popup_disable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
150
gint <a href="GtkNotebook.html#gtk-notebook-get-current-page">gtk_notebook_get_current_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
151
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkNotebook.html#gtk-notebook-get-menu-label">gtk_notebook_get_menu_label</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
152
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
153
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkNotebook.html#gtk-notebook-get-nth-page">gtk_notebook_get_nth_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
155
gint <a href="GtkNotebook.html#gtk-notebook-get-n-pages">gtk_notebook_get_n_pages</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
156
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkNotebook.html#gtk-notebook-get-tab-label">gtk_notebook_get_tab_label</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
157
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
158
void <a href="GtkNotebook.html#gtk-notebook-query-tab-label-packing">gtk_notebook_query_tab_label_packing</a>
159
(<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
160
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
163
<a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> *pack_type);
164
void <a href="GtkNotebook.html#gtk-notebook-set-homogeneous-tabs">gtk_notebook_set_homogeneous_tabs</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
165
gboolean homogeneous);
166
void <a href="GtkNotebook.html#gtk-notebook-set-menu-label">gtk_notebook_set_menu_label</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
167
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
168
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);
169
void <a href="GtkNotebook.html#gtk-notebook-set-menu-label-text">gtk_notebook_set_menu_label_text</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
170
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
171
const gchar *menu_text);
172
void <a href="GtkNotebook.html#gtk-notebook-set-tab-hborder">gtk_notebook_set_tab_hborder</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
174
void <a href="GtkNotebook.html#gtk-notebook-set-tab-label">gtk_notebook_set_tab_label</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
175
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
176
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);
177
void <a href="GtkNotebook.html#gtk-notebook-set-tab-label-packing">gtk_notebook_set_tab_label_packing</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
178
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
181
<a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> pack_type);
182
void <a href="GtkNotebook.html#gtk-notebook-set-tab-label-text">gtk_notebook_set_tab_label_text</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
183
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
184
const gchar *tab_text);
185
void <a href="GtkNotebook.html#gtk-notebook-set-tab-vborder">gtk_notebook_set_tab_vborder</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
187
void <a href="GtkNotebook.html#gtk-notebook-set-tab-reorderable">gtk_notebook_set_tab_reorderable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
188
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
189
gboolean reorderable);
190
void <a href="GtkNotebook.html#gtk-notebook-set-tab-detachable">gtk_notebook_set_tab_detachable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
191
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
192
gboolean detachable);
193
const gchar* <a href="GtkNotebook.html#gtk-notebook-get-menu-label-text">gtk_notebook_get_menu_label_text</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
194
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
195
gboolean <a href="GtkNotebook.html#gtk-notebook-get-scrollable">gtk_notebook_get_scrollable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
196
gboolean <a href="GtkNotebook.html#gtk-notebook-get-show-border">gtk_notebook_get_show_border</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
197
gboolean <a href="GtkNotebook.html#gtk-notebook-get-show-tabs">gtk_notebook_get_show_tabs</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
198
const gchar* <a href="GtkNotebook.html#gtk-notebook-get-tab-label-text">gtk_notebook_get_tab_label_text</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
199
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
200
<a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> <a href="GtkNotebook.html#gtk-notebook-get-tab-pos">gtk_notebook_get_tab_pos</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
201
gboolean <a href="GtkNotebook.html#gtk-notebook-get-tab-reorderable">gtk_notebook_get_tab_reorderable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
202
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
203
gboolean <a href="GtkNotebook.html#gtk-notebook-get-tab-detachable">gtk_notebook_get_tab_detachable</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
204
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
205
void <a href="GtkNotebook.html#gtk-notebook-set-current-page">gtk_notebook_set_current_page</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
207
void <a href="GtkNotebook.html#gtk-notebook-set-group-id">gtk_notebook_set_group_id</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
209
gint <a href="GtkNotebook.html#gtk-notebook-get-group-id">gtk_notebook_get_group_id</a> (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);
210
<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a>* (<a href="GtkNotebook.html#GtkNotebookWindowCreationFunc">*GtkNotebookWindowCreationFunc</a>) (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *source,
211
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *page,
215
void <a href="GtkNotebook.html#gtk-notebook-set-window-creation-hook">gtk_notebook_set_window_creation_hook</a>
216
(<a href="GtkNotebook.html#GtkNotebookWindowCreationFunc">GtkNotebookWindowCreationFunc</a> func,
218
GDestroyNotify destroy);
223
<div class="refsect1" lang="en">
224
<a name="id3532668"></a><h2>Object Hierarchy</h2>
225
<pre class="synopsis">
228
+----GInitiallyUnowned
229
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
230
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
231
+----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
235
<div class="refsect1" lang="en">
236
<a name="id3532722"></a><h2>Implemented Interfaces</h2>
238
GtkNotebook implements
239
AtkImplementorIface.</p>
241
<div class="refsect1" lang="en">
242
<a name="id3532745"></a><h2>Properties</h2>
243
<pre class="synopsis">
245
"<a href="GtkNotebook.html#GtkNotebook--enable-popup">enable-popup</a>" gboolean : Read / Write
246
"<a href="GtkNotebook.html#GtkNotebook--group-id">group-id</a>" gint : Read / Write
247
"<a href="GtkNotebook.html#GtkNotebook--homogeneous">homogeneous</a>" gboolean : Read / Write
248
"<a href="GtkNotebook.html#GtkNotebook--page">page</a>" gint : Read / Write
249
"<a href="GtkNotebook.html#GtkNotebook--scrollable">scrollable</a>" gboolean : Read / Write
250
"<a href="GtkNotebook.html#GtkNotebook--show-border">show-border</a>" gboolean : Read / Write
251
"<a href="GtkNotebook.html#GtkNotebook--show-tabs">show-tabs</a>" gboolean : Read / Write
252
"<a href="GtkNotebook.html#GtkNotebook--tab-border">tab-border</a>" guint : Write
253
"<a href="GtkNotebook.html#GtkNotebook--tab-hborder">tab-hborder</a>" guint : Read / Write
254
"<a href="GtkNotebook.html#GtkNotebook--tab-pos">tab-pos</a>" <a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> : Read / Write
255
"<a href="GtkNotebook.html#GtkNotebook--tab-vborder">tab-vborder</a>" guint : Read / Write
258
<div class="refsect1" lang="en">
259
<a name="id3532952"></a><h2>Child Properties</h2>
260
<pre class="synopsis">
262
"<a href="GtkNotebook.html#GtkNotebook--detachable">detachable</a>" gboolean : Read / Write
263
"<a href="GtkNotebook.html#GtkNotebook--menu-label">menu-label</a>" gchararray : Read / Write
264
"<a href="GtkNotebook.html#GtkNotebook--position">position</a>" gint : Read / Write
265
"<a href="GtkNotebook.html#GtkNotebook--reorderable">reorderable</a>" gboolean : Read / Write
266
"<a href="GtkNotebook.html#GtkNotebook--tab-expand">tab-expand</a>" gboolean : Read / Write
267
"<a href="GtkNotebook.html#GtkNotebook--tab-fill">tab-fill</a>" gboolean : Read / Write
268
"<a href="GtkNotebook.html#GtkNotebook--tab-label">tab-label</a>" gchararray : Read / Write
269
"<a href="GtkNotebook.html#GtkNotebook--tab-pack">tab-pack</a>" <a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> : Read / Write
272
<div class="refsect1" lang="en">
273
<a name="id3533106"></a><h2>Style Properties</h2>
274
<pre class="synopsis">
276
"<a href="GtkNotebook.html#GtkNotebook--arrow-spacing">arrow-spacing</a>" gint : Read
277
"<a href="GtkNotebook.html#GtkNotebook--has-backward-stepper">has-backward-stepper</a>" gboolean : Read
278
"<a href="GtkNotebook.html#GtkNotebook--has-forward-stepper">has-forward-stepper</a>" gboolean : Read
279
"<a href="GtkNotebook.html#GtkNotebook--has-secondary-backward-stepper">has-secondary-backward-stepper</a>" gboolean : Read
280
"<a href="GtkNotebook.html#GtkNotebook--has-secondary-forward-stepper">has-secondary-forward-stepper</a>" gboolean : Read
281
"<a href="GtkNotebook.html#GtkNotebook--tab-curvature">tab-curvature</a>" gint : Read
282
"<a href="GtkNotebook.html#GtkNotebook--tab-overlap">tab-overlap</a>" gint : Read
285
<div class="refsect1" lang="en">
286
<a name="id3533243"></a><h2>Signals</h2>
287
<pre class="synopsis">
289
"<a href="GtkNotebook.html#GtkNotebook-change-current-page">change-current-page</a>" : Run Last / Action
290
"<a href="GtkNotebook.html#GtkNotebook-focus-tab">focus-tab</a>" : Run Last / Action
291
"<a href="GtkNotebook.html#GtkNotebook-move-focus-out">move-focus-out</a>" : Run Last / Action
292
"<a href="GtkNotebook.html#GtkNotebook-page-added">page-added</a>" : Run Last
293
"<a href="GtkNotebook.html#GtkNotebook-page-removed">page-removed</a>" : Run Last
294
"<a href="GtkNotebook.html#GtkNotebook-page-reordered">page-reordered</a>" : Run Last
295
"<a href="GtkNotebook.html#GtkNotebook-reorder-tab">reorder-tab</a>" : Run Last / Action
296
"<a href="GtkNotebook.html#GtkNotebook-select-page">select-page</a>" : Run Last / Action
297
"<a href="GtkNotebook.html#GtkNotebook-switch-page">switch-page</a>" : Run Last
300
<div class="refsect1" lang="en">
301
<a name="id3533358"></a><h2>Description</h2>
303
The <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget is a <a href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> whose children are pages that
304
can be switched between using tab labels along one edge.
307
There are many configuration options for <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>. Among other
308
things, you can choose on which edge the tabs appear
309
(see <a href="GtkNotebook.html#gtk-notebook-set-tab-pos"><code class="function">gtk_notebook_set_tab_pos()</code></a>), whether, if there are too many
310
tabs to fit the noteobook should be made bigger or scrolling
311
arrows added (see gtk_notebook_set_scrollable), and whether there
312
will be a popup menu allowing the users to switch pages.
313
(see <code class="function">gtk_notebook_enable_popup()</code>, <code class="function">gtk_noteobook_disable_popup()</code>)
316
<div class="refsect1" lang="en">
317
<a name="id3533442"></a><h2>Details</h2>
318
<div class="refsect2" lang="en">
319
<a name="id3533452"></a><h3>
320
<a name="GtkNotebook-struct"></a>GtkNotebook</h3>
321
<a class="indexterm" name="id3533464"></a><pre class="programlisting">typedef struct _GtkNotebook GtkNotebook;</pre>
327
<div class="refsect2" lang="en">
328
<a name="id3533479"></a><h3>
329
<a name="GtkNotebookPage"></a>GtkNotebookPage</h3>
330
<a class="indexterm" name="id3533492"></a><pre class="programlisting">typedef struct _GtkNotebookPage GtkNotebookPage;</pre>
332
The <a href="GtkNotebook.html#GtkNotebookPage"><span class="type">GtkNotebookPage</span></a> is an opaque implementation detail of <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>.
336
<div class="refsect2" lang="en">
337
<a name="id3533525"></a><h3>
338
<a name="gtk-notebook-new"></a>gtk_notebook_new ()</h3>
339
<a class="indexterm" name="id3533538"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_notebook_new (void);</pre>
341
Creates a new <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget with no pages.</p>
344
<div class="variablelist"><table border="0">
345
<col align="left" valign="top">
347
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
348
<td> the newly created <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
354
<div class="refsect2" lang="en">
355
<a name="id3533594"></a><h3>
356
<a name="gtk-notebook-append-page"></a>gtk_notebook_append_page ()</h3>
357
<a class="indexterm" name="id3533607"></a><pre class="programlisting">gint gtk_notebook_append_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
358
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
359
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);</pre>
361
Appends a page to <em class="parameter"><code>notebook</code></em>.</p>
364
<div class="variablelist"><table border="0">
365
<col align="left" valign="top">
368
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
369
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
373
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
374
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
378
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
379
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
381
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
382
><code class="literal">NULL</code></a> to use the default label, 'page N'.
386
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
387
<td> the index (starting from 0) of the appended
388
page in the notebook, or -1 if function fails
395
<div class="refsect2" lang="en">
396
<a name="id3533754"></a><h3>
397
<a name="gtk-notebook-append-page-menu"></a>gtk_notebook_append_page_menu ()</h3>
398
<a class="indexterm" name="id3533767"></a><pre class="programlisting">gint gtk_notebook_append_page_menu (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
399
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
400
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
401
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);</pre>
403
Appends a page to <em class="parameter"><code>notebook</code></em>, specifying the widget to use as the
404
label in the popup menu.</p>
407
<div class="variablelist"><table border="0">
408
<col align="left" valign="top">
411
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
412
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
416
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
417
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
421
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
422
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
424
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
425
><code class="literal">NULL</code></a> to use the default label, 'page N'.
429
<td><span class="term"><em class="parameter"><code>menu_label</code></em> :</span></td>
430
<td> the widget to use as a label for the page-switch
431
menu, if that is enabled. If <a
432
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
433
><code class="literal">NULL</code></a>, and <em class="parameter"><code>tab_label</code></em>
434
is a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <a
435
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
436
><code class="literal">NULL</code></a>, then the menu label will be
437
a newly created label with the same text as <em class="parameter"><code>tab_label</code></em>;
438
If <em class="parameter"><code>tab_label</code></em> is not a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em> must be
439
specified if the page-switch menu is to be used.
443
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
444
<td> the index (starting from 0) of the appended
445
page in the notebook, or -1 if function fails
452
<div class="refsect2" lang="en">
453
<a name="id3534002"></a><h3>
454
<a name="gtk-notebook-prepend-page"></a>gtk_notebook_prepend_page ()</h3>
455
<a class="indexterm" name="id3534016"></a><pre class="programlisting">gint gtk_notebook_prepend_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
456
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
457
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);</pre>
459
Prepends a page to <em class="parameter"><code>notebook</code></em>.</p>
462
<div class="variablelist"><table border="0">
463
<col align="left" valign="top">
466
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
467
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
471
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
472
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
476
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
477
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
479
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
480
><code class="literal">NULL</code></a> to use the default label, 'page N'.
484
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
485
<td> the index (starting from 0) of the prepended
486
page in the notebook, or -1 if function fails
493
<div class="refsect2" lang="en">
494
<a name="id3534162"></a><h3>
495
<a name="gtk-notebook-prepend-page-menu"></a>gtk_notebook_prepend_page_menu ()</h3>
496
<a class="indexterm" name="id3534176"></a><pre class="programlisting">gint gtk_notebook_prepend_page_menu (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
497
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
498
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
499
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);</pre>
501
Prepends a page to <em class="parameter"><code>notebook</code></em>, specifying the widget to use as the
502
label in the popup menu.</p>
505
<div class="variablelist"><table border="0">
506
<col align="left" valign="top">
509
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
510
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
514
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
515
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
519
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
520
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
522
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
523
><code class="literal">NULL</code></a> to use the default label, 'page N'.
527
<td><span class="term"><em class="parameter"><code>menu_label</code></em> :</span></td>
528
<td> the widget to use as a label for the page-switch
529
menu, if that is enabled. If <a
530
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
531
><code class="literal">NULL</code></a>, and <em class="parameter"><code>tab_label</code></em>
532
is a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <a
533
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
534
><code class="literal">NULL</code></a>, then the menu label will be
535
a newly created label with the same text as <em class="parameter"><code>tab_label</code></em>;
536
If <em class="parameter"><code>tab_label</code></em> is not a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em> must be
537
specified if the page-switch menu is to be used.
541
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
542
<td> the index (starting from 0) of the prepended
543
page in the notebook, or -1 if function fails
550
<div class="refsect2" lang="en">
551
<a name="id3534410"></a><h3>
552
<a name="gtk-notebook-insert-page"></a>gtk_notebook_insert_page ()</h3>
553
<a class="indexterm" name="id3534423"></a><pre class="programlisting">gint gtk_notebook_insert_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
554
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
555
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
556
gint position);</pre>
558
Insert a page into <em class="parameter"><code>notebook</code></em> at the given position.</p>
561
<div class="variablelist"><table border="0">
562
<col align="left" valign="top">
565
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
566
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
570
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
571
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
575
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
576
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
578
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
579
><code class="literal">NULL</code></a> to use the default label, 'page N'.
583
<td><span class="term"><em class="parameter"><code>position</code></em> :</span></td>
584
<td> the index (starting at 0) at which to insert the page,
585
or -1 to append the page after all other pages.
589
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
590
<td> the index (starting from 0) of the inserted
591
page in the notebook, or -1 if function fails
598
<div class="refsect2" lang="en">
599
<a name="id3534594"></a><h3>
600
<a name="gtk-notebook-insert-page-menu"></a>gtk_notebook_insert_page_menu ()</h3>
601
<a class="indexterm" name="id3534608"></a><pre class="programlisting">gint gtk_notebook_insert_page_menu (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
602
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
603
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label,
604
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label,
605
gint position);</pre>
607
Insert a page into <em class="parameter"><code>notebook</code></em> at the given position, specifying
608
the widget to use as the label in the popup menu.</p>
611
<div class="variablelist"><table border="0">
612
<col align="left" valign="top">
615
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
616
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
620
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
621
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page.
625
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
626
<td> the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label for the page,
628
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
629
><code class="literal">NULL</code></a> to use the default label, 'page N'.
633
<td><span class="term"><em class="parameter"><code>menu_label</code></em> :</span></td>
634
<td> the widget to use as a label for the page-switch
635
menu, if that is enabled. If <a
636
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
637
><code class="literal">NULL</code></a>, and <em class="parameter"><code>tab_label</code></em>
638
is a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <a
639
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
640
><code class="literal">NULL</code></a>, then the menu label will be
641
a newly created label with the same text as <em class="parameter"><code>tab_label</code></em>;
642
If <em class="parameter"><code>tab_label</code></em> is not a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em> must be
643
specified if the page-switch menu is to be used.
647
<td><span class="term"><em class="parameter"><code>position</code></em> :</span></td>
648
<td> the index (starting at 0) at which to insert the page,
649
or -1 to append the page after all other pages.
653
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
654
<td> the index (starting from 0) of the inserted
662
<div class="refsect2" lang="en">
663
<a name="id3534865"></a><h3>
664
<a name="gtk-notebook-remove-page"></a>gtk_notebook_remove_page ()</h3>
665
<a class="indexterm" name="id3534879"></a><pre class="programlisting">void gtk_notebook_remove_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
666
gint page_num);</pre>
668
Removes a page from the notebook given its index
672
<div class="variablelist"><table border="0">
673
<col align="left" valign="top">
676
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
677
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>.
681
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
682
<td> the index of a notebook page, starting
683
from 0. If -1, the last page will
691
<div class="refsect2" lang="en">
692
<a name="id3534961"></a><h3>
693
<a name="gtk-notebook-current-page"></a>gtk_notebook_current_page</h3>
694
<a class="indexterm" name="id3534976"></a><pre class="programlisting">#define gtk_notebook_current_page gtk_notebook_get_current_page
696
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
697
<h3 class="title">Warning</h3>
698
<p><code class="literal">gtk_notebook_current_page</code> is deprecated and should not be used in newly-written code.</p>
701
Deprecated compatibility macro. Use
702
<a href="GtkNotebook.html#gtk-notebook-get-current-page"><code class="function">gtk_notebook_get_current_page()</code></a> instead.
706
<div class="refsect2" lang="en">
707
<a name="id3535017"></a><h3>
708
<a name="gtk-notebook-page-num"></a>gtk_notebook_page_num ()</h3>
709
<a class="indexterm" name="id3535031"></a><pre class="programlisting">gint gtk_notebook_page_num (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
710
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
712
Finds the index of the page which contains the given child
716
<div class="variablelist"><table border="0">
717
<col align="left" valign="top">
720
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
721
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
725
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
726
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
730
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
731
<td> the index of the page containing <em class="parameter"><code>child</code></em>, or
732
-1 if <em class="parameter"><code>child</code></em> is not in the notebook.
739
<div class="refsect2" lang="en">
740
<a name="id3535142"></a><h3>
741
<a name="gtk-notebook-set-page"></a>gtk_notebook_set_page</h3>
742
<a class="indexterm" name="id3535157"></a><pre class="programlisting">#define gtk_notebook_set_page gtk_notebook_set_current_page
744
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
745
<h3 class="title">Warning</h3>
746
<p><code class="literal">gtk_notebook_set_page</code> is deprecated and should not be used in newly-written code.</p>
749
Deprecated compatibility macro. Use
750
<a href="GtkNotebook.html#gtk-notebook-set-current-page"><code class="function">gtk_notebook_set_current_page()</code></a> instead.
754
<div class="refsect2" lang="en">
755
<a name="id3535198"></a><h3>
756
<a name="gtk-notebook-next-page"></a>gtk_notebook_next_page ()</h3>
757
<a class="indexterm" name="id3535212"></a><pre class="programlisting">void gtk_notebook_next_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
759
Switches to the next page. Nothing happens if the current page is
763
<div class="variablelist"><table border="0">
764
<col align="left" valign="top">
766
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
767
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
773
<div class="refsect2" lang="en">
774
<a name="id3535270"></a><h3>
775
<a name="gtk-notebook-prev-page"></a>gtk_notebook_prev_page ()</h3>
776
<a class="indexterm" name="id3535284"></a><pre class="programlisting">void gtk_notebook_prev_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
778
Switches to the previous page. Nothing happens if the current page
779
is the first page.</p>
782
<div class="variablelist"><table border="0">
783
<col align="left" valign="top">
785
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
786
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
792
<div class="refsect2" lang="en">
793
<a name="id3535343"></a><h3>
794
<a name="gtk-notebook-reorder-child"></a>gtk_notebook_reorder_child ()</h3>
795
<a class="indexterm" name="id3535357"></a><pre class="programlisting">void gtk_notebook_reorder_child (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
796
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
797
gint position);</pre>
799
Reorders the page containing <em class="parameter"><code>child</code></em>, so that it appears in position
800
<em class="parameter"><code>position</code></em>. If <em class="parameter"><code>position</code></em> is greater than or equal to the number of
801
children in the list or negative, <em class="parameter"><code>child</code></em> will be moved to the end
805
<div class="variablelist"><table border="0">
806
<col align="left" valign="top">
809
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
810
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
814
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
815
<td> the child to move
819
<td><span class="term"><em class="parameter"><code>position</code></em> :</span></td>
820
<td> the new position, or -1 to move to the end
827
<div class="refsect2" lang="en">
828
<a name="id3535484"></a><h3>
829
<a name="gtk-notebook-set-tab-pos"></a>gtk_notebook_set_tab_pos ()</h3>
830
<a class="indexterm" name="id3535498"></a><pre class="programlisting">void gtk_notebook_set_tab_pos (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
831
<a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> pos);</pre>
833
Sets the edge at which the tabs for switching pages in the
834
notebook are drawn.</p>
837
<div class="variablelist"><table border="0">
838
<col align="left" valign="top">
841
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
842
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>.
846
<td><span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
847
<td> the edge to draw the tabs at.
854
<div class="refsect2" lang="en">
855
<a name="id3535579"></a><h3>
856
<a name="gtk-notebook-set-show-tabs"></a>gtk_notebook_set_show_tabs ()</h3>
857
<a class="indexterm" name="id3535593"></a><pre class="programlisting">void gtk_notebook_set_show_tabs (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
858
gboolean show_tabs);</pre>
860
Sets whether to show the tabs for the notebook or not.</p>
863
<div class="variablelist"><table border="0">
864
<col align="left" valign="top">
867
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
868
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
872
<td><span class="term"><em class="parameter"><code>show_tabs</code></em> :</span></td>
873
<td> <code class="literal">TRUE</code> if the tabs should be shown.
880
<div class="refsect2" lang="en">
881
<a name="id3535683"></a><h3>
882
<a name="gtk-notebook-set-show-border"></a>gtk_notebook_set_show_border ()</h3>
883
<a class="indexterm" name="id3535696"></a><pre class="programlisting">void gtk_notebook_set_show_border (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
884
gboolean show_border);</pre>
886
Sets whether a bevel will be drawn around the notebook pages.
887
This only has a visual effect when the tabs are not shown.
888
See <a href="GtkNotebook.html#gtk-notebook-set-show-tabs"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
891
<div class="variablelist"><table border="0">
892
<col align="left" valign="top">
895
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
896
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
900
<td><span class="term"><em class="parameter"><code>show_border</code></em> :</span></td>
901
<td> <code class="literal">TRUE</code> if a bevel should be drawn around the notebook.
908
<div class="refsect2" lang="en">
909
<a name="id3535800"></a><h3>
910
<a name="gtk-notebook-set-scrollable"></a>gtk_notebook_set_scrollable ()</h3>
911
<a class="indexterm" name="id3535813"></a><pre class="programlisting">void gtk_notebook_set_scrollable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
912
gboolean scrollable);</pre>
914
Sets whether the tab label area will have arrows for scrolling if
915
there are too many tabs to fit in the area.</p>
918
<div class="variablelist"><table border="0">
919
<col align="left" valign="top">
922
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
923
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
927
<td><span class="term"><em class="parameter"><code>scrollable</code></em> :</span></td>
928
<td> <code class="literal">TRUE</code> if scroll arrows should be added
935
<div class="refsect2" lang="en">
936
<a name="id3535904"></a><h3>
937
<a name="gtk-notebook-set-tab-border"></a>gtk_notebook_set_tab_border ()</h3>
938
<a class="indexterm" name="id3535920"></a><pre class="programlisting">void gtk_notebook_set_tab_border (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
939
guint border_width);</pre>
940
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
941
<h3 class="title">Warning</h3>
942
<p><code class="literal">gtk_notebook_set_tab_border</code> is deprecated and should not be used in newly-written code.</p>
945
Sets the width the border around the tab labels
946
in a notebook. This is equivalent to calling
947
gtk_notebook_set_tab_hborder (<em class="parameter"><code>notebook</code></em>, <em class="parameter"><code>border_width</code></em>) followed
948
by gtk_notebook_set_tab_vborder (<em class="parameter"><code>notebook</code></em>, <em class="parameter"><code>border_width</code></em>).</p>
951
<div class="variablelist"><table border="0">
952
<col align="left" valign="top">
955
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
956
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
960
<td><span class="term"><em class="parameter"><code>border_width</code></em> :</span></td>
961
<td> width of the border around the tab labels.
968
<div class="refsect2" lang="en">
969
<a name="id3536038"></a><h3>
970
<a name="gtk-notebook-popup-enable"></a>gtk_notebook_popup_enable ()</h3>
971
<a class="indexterm" name="id3536052"></a><pre class="programlisting">void gtk_notebook_popup_enable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
973
Enables the popup menu: if the user clicks with the right mouse button on
974
the bookmarks, a menu with all the pages will be popped up.</p>
977
<div class="variablelist"><table border="0">
978
<col align="left" valign="top">
980
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
981
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
987
<div class="refsect2" lang="en">
988
<a name="id3536112"></a><h3>
989
<a name="gtk-notebook-popup-disable"></a>gtk_notebook_popup_disable ()</h3>
990
<a class="indexterm" name="id3536126"></a><pre class="programlisting">void gtk_notebook_popup_disable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
992
Disables the popup menu.</p>
995
<div class="variablelist"><table border="0">
996
<col align="left" valign="top">
998
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
999
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1005
<div class="refsect2" lang="en">
1006
<a name="id3536183"></a><h3>
1007
<a name="gtk-notebook-get-current-page"></a>gtk_notebook_get_current_page ()</h3>
1008
<a class="indexterm" name="id3536197"></a><pre class="programlisting">gint gtk_notebook_get_current_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1010
Returns the page number of the current page.</p>
1013
<div class="variablelist"><table border="0">
1014
<col align="left" valign="top">
1017
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1018
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1022
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1023
<td> the index (starting from 0) of the current
1024
page in the notebook. If the notebook has no pages, then
1025
-1 will be returned.
1032
<div class="refsect2" lang="en">
1033
<a name="id3536267"></a><h3>
1034
<a name="gtk-notebook-get-menu-label"></a>gtk_notebook_get_menu_label ()</h3>
1035
<a class="indexterm" name="id3536281"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_notebook_get_menu_label (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1036
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1038
Retrieves the menu label widget of the page containing <em class="parameter"><code>child</code></em>.</p>
1041
<div class="variablelist"><table border="0">
1042
<col align="left" valign="top">
1045
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1046
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1050
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1051
<td> a widget contained in a page of <em class="parameter"><code>notebook</code></em>
1055
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1056
<td> the menu label, or <a
1057
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1058
><code class="literal">NULL</code></a> if the
1059
notebook page does not have a menu label other
1060
than the default (the tab label).
1067
<div class="refsect2" lang="en">
1068
<a name="id3536395"></a><h3>
1069
<a name="gtk-notebook-get-nth-page"></a>gtk_notebook_get_nth_page ()</h3>
1070
<a class="indexterm" name="id3536409"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_notebook_get_nth_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1071
gint page_num);</pre>
1073
Returns the child widget contained in page number <em class="parameter"><code>page_num</code></em>.</p>
1076
<div class="variablelist"><table border="0">
1077
<col align="left" valign="top">
1080
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1081
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1085
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
1086
<td> the index of a page in the noteobok, or -1
1087
to get the last page.
1091
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1092
<td> the child widget, or <a
1093
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1094
><code class="literal">NULL</code></a> if <em class="parameter"><code>page_num</code></em> is
1102
<div class="refsect2" lang="en">
1103
<a name="id3536522"></a><h3>
1104
<a name="gtk-notebook-get-n-pages"></a>gtk_notebook_get_n_pages ()</h3>
1105
<a class="indexterm" name="id3536538"></a><pre class="programlisting">gint gtk_notebook_get_n_pages (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1107
Gets the number of pages in a notebook.</p>
1111
<div class="variablelist"><table border="0">
1112
<col align="left" valign="top">
1115
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1116
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1120
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1121
<td> the number of pages in the notebook.
1127
<p class="since">Since 2.2
1131
<div class="refsect2" lang="en">
1132
<a name="id3536613"></a><h3>
1133
<a name="gtk-notebook-get-tab-label"></a>gtk_notebook_get_tab_label ()</h3>
1134
<a class="indexterm" name="id3536627"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_notebook_get_tab_label (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1135
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1137
Returns the tab label widget for the page <em class="parameter"><code>child</code></em>. <a
1138
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1139
><code class="literal">NULL</code></a> is returned
1140
if <em class="parameter"><code>child</code></em> is not in <em class="parameter"><code>notebook</code></em> or if no tab label has specifically
1141
been set for <em class="parameter"><code>child</code></em>.</p>
1144
<div class="variablelist"><table border="0">
1145
<col align="left" valign="top">
1148
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1149
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1153
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1158
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1166
<div class="refsect2" lang="en">
1167
<a name="id3536752"></a><h3>
1168
<a name="gtk-notebook-query-tab-label-packing"></a>gtk_notebook_query_tab_label_packing ()</h3>
1169
<a class="indexterm" name="id3536766"></a><pre class="programlisting">void gtk_notebook_query_tab_label_packing
1170
(<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1171
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1174
<a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> *pack_type);</pre>
1176
Query the packing attributes for the tab label of the page
1177
containing <em class="parameter"><code>child</code></em>.</p>
1180
<div class="variablelist"><table border="0">
1181
<col align="left" valign="top">
1184
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1185
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1189
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1194
<td><span class="term"><em class="parameter"><code>expand</code></em> :</span></td>
1195
<td> location to store the expand value (or NULL)
1199
<td><span class="term"><em class="parameter"><code>fill</code></em> :</span></td>
1200
<td> location to store the fill value (or NULL)
1204
<td><span class="term"><em class="parameter"><code>pack_type</code></em> :</span></td>
1205
<td> location to store the pack_type (or NULL)
1212
<div class="refsect2" lang="en">
1213
<a name="id3536920"></a><h3>
1214
<a name="gtk-notebook-set-homogeneous-tabs"></a>gtk_notebook_set_homogeneous_tabs ()</h3>
1215
<a class="indexterm" name="id3536936"></a><pre class="programlisting">void gtk_notebook_set_homogeneous_tabs (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1216
gboolean homogeneous);</pre>
1217
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1218
<h3 class="title">Warning</h3>
1219
<p><code class="literal">gtk_notebook_set_homogeneous_tabs</code> is deprecated and should not be used in newly-written code.</p>
1222
Sets whether the tabs must have all the same size or not.</p>
1225
<div class="variablelist"><table border="0">
1226
<col align="left" valign="top">
1229
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1230
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1234
<td><span class="term"><em class="parameter"><code>homogeneous</code></em> :</span></td>
1235
<td> <code class="literal">TRUE</code> if all tabs should be the same size.
1242
<div class="refsect2" lang="en">
1243
<a name="id3537039"></a><h3>
1244
<a name="gtk-notebook-set-menu-label"></a>gtk_notebook_set_menu_label ()</h3>
1245
<a class="indexterm" name="id3537053"></a><pre class="programlisting">void gtk_notebook_set_menu_label (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1246
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1247
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_label);</pre>
1249
Changes the menu label for the page containing <em class="parameter"><code>child</code></em>.</p>
1252
<div class="variablelist"><table border="0">
1253
<col align="left" valign="top">
1256
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1257
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1261
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1262
<td> the child widget
1266
<td><span class="term"><em class="parameter"><code>menu_label</code></em> :</span></td>
1267
<td> the menu label, or NULL for default
1274
<div class="refsect2" lang="en">
1275
<a name="id3537161"></a><h3>
1276
<a name="gtk-notebook-set-menu-label-text"></a>gtk_notebook_set_menu_label_text ()</h3>
1277
<a class="indexterm" name="id3537175"></a><pre class="programlisting">void gtk_notebook_set_menu_label_text (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1278
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1279
const gchar *menu_text);</pre>
1281
Creates a new label and sets it as the menu label of <em class="parameter"><code>child</code></em>.</p>
1284
<div class="variablelist"><table border="0">
1285
<col align="left" valign="top">
1288
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1289
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1293
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1294
<td> the child widget
1298
<td><span class="term"><em class="parameter"><code>menu_text</code></em> :</span></td>
1306
<div class="refsect2" lang="en">
1307
<a name="id3537283"></a><h3>
1308
<a name="gtk-notebook-set-tab-hborder"></a>gtk_notebook_set_tab_hborder ()</h3>
1309
<a class="indexterm" name="id3537298"></a><pre class="programlisting">void gtk_notebook_set_tab_hborder (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1310
guint tab_hborder);</pre>
1311
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1312
<h3 class="title">Warning</h3>
1313
<p><code class="literal">gtk_notebook_set_tab_hborder</code> is deprecated and should not be used in newly-written code.</p>
1316
Sets the width of the horizontal border of tab labels.</p>
1319
<div class="variablelist"><table border="0">
1320
<col align="left" valign="top">
1323
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1324
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1328
<td><span class="term"><em class="parameter"><code>tab_hborder</code></em> :</span></td>
1329
<td> width of the horizontal border of tab labels.
1336
<div class="refsect2" lang="en">
1337
<a name="id3537392"></a><h3>
1338
<a name="gtk-notebook-set-tab-label"></a>gtk_notebook_set_tab_label ()</h3>
1339
<a class="indexterm" name="id3537406"></a><pre class="programlisting">void gtk_notebook_set_tab_label (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1340
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1341
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tab_label);</pre>
1343
Changes the tab label for <em class="parameter"><code>child</code></em>. If <a
1344
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1345
><code class="literal">NULL</code></a> is specified
1346
for <em class="parameter"><code>tab_label</code></em>, then the page will have the label 'page N'.</p>
1349
<div class="variablelist"><table border="0">
1350
<col align="left" valign="top">
1353
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1354
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1358
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1363
<td><span class="term"><em class="parameter"><code>tab_label</code></em> :</span></td>
1364
<td> the tab label widget to use, or <a
1365
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1366
><code class="literal">NULL</code></a> for default tab
1374
<div class="refsect2" lang="en">
1375
<a name="id3537541"></a><h3>
1376
<a name="gtk-notebook-set-tab-label-packing"></a>gtk_notebook_set_tab_label_packing ()</h3>
1377
<a class="indexterm" name="id3537555"></a><pre class="programlisting">void gtk_notebook_set_tab_label_packing (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1378
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1381
<a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> pack_type);</pre>
1383
Sets the packing parameters for the tab label of the page
1384
containing <em class="parameter"><code>child</code></em>. See <a href="GtkBox.html#gtk-box-pack-start"><code class="function">gtk_box_pack_start()</code></a> for the exact meaning
1385
of the parameters.</p>
1388
<div class="variablelist"><table border="0">
1389
<col align="left" valign="top">
1392
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1393
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1397
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1398
<td> the child widget
1402
<td><span class="term"><em class="parameter"><code>expand</code></em> :</span></td>
1403
<td> whether to expand the bookmark or not
1407
<td><span class="term"><em class="parameter"><code>fill</code></em> :</span></td>
1408
<td> whether the bookmark should fill the allocated area or not
1412
<td><span class="term"><em class="parameter"><code>pack_type</code></em> :</span></td>
1413
<td> the position of the bookmark
1420
<div class="refsect2" lang="en">
1421
<a name="id3537719"></a><h3>
1422
<a name="gtk-notebook-set-tab-label-text"></a>gtk_notebook_set_tab_label_text ()</h3>
1423
<a class="indexterm" name="id3537733"></a><pre class="programlisting">void gtk_notebook_set_tab_label_text (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1424
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1425
const gchar *tab_text);</pre>
1427
Creates a new label and sets it as the tab label for the page
1428
containing <em class="parameter"><code>child</code></em>.</p>
1431
<div class="variablelist"><table border="0">
1432
<col align="left" valign="top">
1435
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1436
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1440
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1445
<td><span class="term"><em class="parameter"><code>tab_text</code></em> :</span></td>
1453
<div class="refsect2" lang="en">
1454
<a name="id3537841"></a><h3>
1455
<a name="gtk-notebook-set-tab-vborder"></a>gtk_notebook_set_tab_vborder ()</h3>
1456
<a class="indexterm" name="id3537857"></a><pre class="programlisting">void gtk_notebook_set_tab_vborder (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1457
guint tab_vborder);</pre>
1458
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1459
<h3 class="title">Warning</h3>
1460
<p><code class="literal">gtk_notebook_set_tab_vborder</code> is deprecated and should not be used in newly-written code.</p>
1463
Sets the width of the vertical border of tab labels.</p>
1466
<div class="variablelist"><table border="0">
1467
<col align="left" valign="top">
1470
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1471
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1475
<td><span class="term"><em class="parameter"><code>tab_vborder</code></em> :</span></td>
1476
<td> width of the vertical border of tab labels.
1483
<div class="refsect2" lang="en">
1484
<a name="id3537951"></a><h3>
1485
<a name="gtk-notebook-set-tab-reorderable"></a>gtk_notebook_set_tab_reorderable ()</h3>
1486
<a class="indexterm" name="id3537966"></a><pre class="programlisting">void gtk_notebook_set_tab_reorderable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1487
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1488
gboolean reorderable);</pre>
1490
Sets whether the notebook tab can be reordered
1491
via drag and drop or not.</p>
1495
<div class="variablelist"><table border="0">
1496
<col align="left" valign="top">
1499
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1500
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1504
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1505
<td> a child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
1509
<td><span class="term"><em class="parameter"><code>reorderable</code></em> :</span></td>
1510
<td> whether the tab is reorderable or not.
1515
<p class="since">Since 2.10
1519
<div class="refsect2" lang="en">
1520
<a name="id3538084"></a><h3>
1521
<a name="gtk-notebook-set-tab-detachable"></a>gtk_notebook_set_tab_detachable ()</h3>
1522
<a class="indexterm" name="id3538100"></a><pre class="programlisting">void gtk_notebook_set_tab_detachable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1523
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
1524
gboolean detachable);</pre>
1526
Sets whether the tab can be detached from <em class="parameter"><code>notebook</code></em> to another
1530
Note that 2 notebooks must share a common group identificator
1531
(see <a href="GtkNotebook.html#gtk-notebook-set-group-id"><code class="function">gtk_notebook_set_group_id()</code></a>) to allow automatic tabs
1532
interchange between them.
1535
If you want a widget to interact with a notebook through DnD
1536
(i.e.: accept dragged tabs from it) it must be set as a drop
1537
destination and accept the target "GTK_NOTEBOOK_TAB". The notebook
1538
will fill the selection with a GtkWidget** pointing to the child
1539
widget that corresponds to the dropped tab.
1543
<div class="informalexample"><pre class="programlisting">
1545
on_drop_zone_drag_data_received (GtkWidget *widget,
1546
GdkDragContext *context,
1549
GtkSelectionData *selection_data,
1554
GtkWidget *notebook;
1557
notebook = gtk_drag_get_source_widget (context);
1558
child = (void*) selection_data->data;
1560
process_widget (*child);
1561
gtk_container_remove (GTK_CONTAINER (notebook), *child);
1567
If you want a notebook to accept drags from other widgets,
1568
you will have to set your own DnD code to do it.</p>
1572
<div class="variablelist"><table border="0">
1573
<col align="left" valign="top">
1576
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1577
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1581
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1582
<td> a child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
1586
<td><span class="term"><em class="parameter"><code>detachable</code></em> :</span></td>
1587
<td> whether the tab is detachable or not
1592
<p class="since">Since 2.10
1596
<div class="refsect2" lang="en">
1597
<a name="id3538275"></a><h3>
1598
<a name="gtk-notebook-get-menu-label-text"></a>gtk_notebook_get_menu_label_text ()</h3>
1599
<a class="indexterm" name="id3538289"></a><pre class="programlisting">const gchar* gtk_notebook_get_menu_label_text (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1600
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1602
Retrieves the text of the menu label for the page containing
1603
<em class="parameter"><code>child</code></em>.</p>
1607
<div class="variablelist"><table border="0">
1608
<col align="left" valign="top">
1611
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1612
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1616
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1617
<td> the child widget of a page of the notebook.
1621
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1622
<td>value: the text of the tab label, or <a
1623
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1624
><code class="literal">NULL</code></a> if the
1625
widget does not have a menu label other than
1626
the default menu label, or the menu label widget
1627
is not a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The string is owned by
1628
the widget and must not be freed.
1635
<div class="refsect2" lang="en">
1636
<a name="id3538410"></a><h3>
1637
<a name="gtk-notebook-get-scrollable"></a>gtk_notebook_get_scrollable ()</h3>
1638
<a class="indexterm" name="id3538424"></a><pre class="programlisting">gboolean gtk_notebook_get_scrollable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1640
Returns whether the tab label area has arrows for scrolling. See
1641
<a href="GtkNotebook.html#gtk-notebook-set-scrollable"><code class="function">gtk_notebook_set_scrollable()</code></a>.</p>
1645
<div class="variablelist"><table border="0">
1646
<col align="left" valign="top">
1649
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1650
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1654
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1655
<td> <code class="literal">TRUE</code> if arrows for scrolling are present
1662
<div class="refsect2" lang="en">
1663
<a name="id3538514"></a><h3>
1664
<a name="gtk-notebook-get-show-border"></a>gtk_notebook_get_show_border ()</h3>
1665
<a class="indexterm" name="id3538527"></a><pre class="programlisting">gboolean gtk_notebook_get_show_border (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1667
Returns whether a bevel will be drawn around the notebook pages. See
1668
<a href="GtkNotebook.html#gtk-notebook-set-show-border"><code class="function">gtk_notebook_set_show_border()</code></a>.</p>
1672
<div class="variablelist"><table border="0">
1673
<col align="left" valign="top">
1676
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1677
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1681
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1682
<td> <code class="literal">TRUE</code> if the bevel is drawn
1689
<div class="refsect2" lang="en">
1690
<a name="id3538617"></a><h3>
1691
<a name="gtk-notebook-get-show-tabs"></a>gtk_notebook_get_show_tabs ()</h3>
1692
<a class="indexterm" name="id3538631"></a><pre class="programlisting">gboolean gtk_notebook_get_show_tabs (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1694
Returns whether the tabs of the notebook are shown. See
1695
<a href="GtkNotebook.html#gtk-notebook-set-show-tabs"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
1699
<div class="variablelist"><table border="0">
1700
<col align="left" valign="top">
1703
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1704
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1708
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1709
<td> <code class="literal">TRUE</code> if the tabs are shown
1716
<div class="refsect2" lang="en">
1717
<a name="id3538720"></a><h3>
1718
<a name="gtk-notebook-get-tab-label-text"></a>gtk_notebook_get_tab_label_text ()</h3>
1719
<a class="indexterm" name="id3538734"></a><pre class="programlisting">const gchar* gtk_notebook_get_tab_label_text (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1720
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1722
Retrieves the text of the tab label for the page containing
1723
<em class="parameter"><code>child</code></em>.</p>
1727
<div class="variablelist"><table border="0">
1728
<col align="left" valign="top">
1731
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1732
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1736
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1737
<td> a widget contained in a page of <em class="parameter"><code>notebook</code></em>
1741
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1742
<td>value: the text of the tab label, or <a
1743
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1744
><code class="literal">NULL</code></a> if the
1745
tab label widget is not a <a href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The
1746
string is owned by the widget and must not
1754
<div class="refsect2" lang="en">
1755
<a name="id3538859"></a><h3>
1756
<a name="gtk-notebook-get-tab-pos"></a>gtk_notebook_get_tab_pos ()</h3>
1757
<a class="indexterm" name="id3538872"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> gtk_notebook_get_tab_pos (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1759
Gets the edge at which the tabs for switching pages in the
1760
notebook are drawn.</p>
1764
<div class="variablelist"><table border="0">
1765
<col align="left" valign="top">
1768
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1769
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1773
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1774
<td> the edge at which the tabs are drawn
1781
<div class="refsect2" lang="en">
1782
<a name="id3538942"></a><h3>
1783
<a name="gtk-notebook-get-tab-reorderable"></a>gtk_notebook_get_tab_reorderable ()</h3>
1784
<a class="indexterm" name="id3538958"></a><pre class="programlisting">gboolean gtk_notebook_get_tab_reorderable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1785
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1787
Gets whether the tab can be reordered via drag and drop or not.</p>
1791
<div class="variablelist"><table border="0">
1792
<col align="left" valign="top">
1795
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1796
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1800
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1801
<td> a child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
1805
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1806
<td> <code class="literal">TRUE</code> if the tab is reorderable.
1812
<p class="since">Since 2.10
1816
<div class="refsect2" lang="en">
1817
<a name="id3539074"></a><h3>
1818
<a name="gtk-notebook-get-tab-detachable"></a>gtk_notebook_get_tab_detachable ()</h3>
1819
<a class="indexterm" name="id3539090"></a><pre class="programlisting">gboolean gtk_notebook_get_tab_detachable (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1820
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
1822
Returns whether the tab contents can be detached from <em class="parameter"><code>notebook</code></em>.</p>
1826
<div class="variablelist"><table border="0">
1827
<col align="left" valign="top">
1830
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1831
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1835
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
1836
<td> a child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
1840
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1841
<td> TRUE if the tab is detachable.
1847
<p class="since">Since 2.10
1851
<div class="refsect2" lang="en">
1852
<a name="id3539201"></a><h3>
1853
<a name="gtk-notebook-set-current-page"></a>gtk_notebook_set_current_page ()</h3>
1854
<a class="indexterm" name="id3539215"></a><pre class="programlisting">void gtk_notebook_set_current_page (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1855
gint page_num);</pre>
1857
Switches to the page number <em class="parameter"><code>page_num</code></em>.
1860
Note that due to historical reasons, GtkNotebook refuses
1861
to switch to a page unless the child widget is visible.
1862
Therefore, it is recommended to show child widgets before
1863
adding them to a notebook.</p>
1867
<div class="variablelist"><table border="0">
1868
<col align="left" valign="top">
1871
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1872
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1876
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
1877
<td> index of the page to switch to, starting from 0.
1878
If negative, the last page will be used. If greater
1879
than the number of pages in the notebook, nothing
1887
<div class="refsect2" lang="en">
1888
<a name="id3539310"></a><h3>
1889
<a name="gtk-notebook-set-group-id"></a>gtk_notebook_set_group_id ()</h3>
1890
<a class="indexterm" name="id3539326"></a><pre class="programlisting">void gtk_notebook_set_group_id (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
1891
gint group_id);</pre>
1893
Sets an group identificator for <em class="parameter"><code>notebook</code></em>, notebooks sharing
1894
the same group identificator will be able to exchange tabs
1895
via drag and drop. A notebook with group identificator -1 will
1896
not be able to exchange tabs with any other notebook.</p>
1900
<div class="variablelist"><table border="0">
1901
<col align="left" valign="top">
1904
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1905
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1909
<td><span class="term"><em class="parameter"><code>group_id</code></em> :</span></td>
1910
<td> a group identificator, or -1 to unset it
1915
<p class="since">Since 2.10
1919
<div class="refsect2" lang="en">
1920
<a name="id3539422"></a><h3>
1921
<a name="gtk-notebook-get-group-id"></a>gtk_notebook_get_group_id ()</h3>
1922
<a class="indexterm" name="id3539438"></a><pre class="programlisting">gint gtk_notebook_get_group_id (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook);</pre>
1924
Gets the current group identificator for <em class="parameter"><code>notebook</code></em>.</p>
1928
<div class="variablelist"><table border="0">
1929
<col align="left" valign="top">
1932
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
1933
<td> a <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
1937
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1938
<td> the group identificator, or -1 if none is set.
1944
<p class="since">Since 2.10
1948
<div class="refsect2" lang="en">
1949
<a name="id3539520"></a><h3>
1950
<a name="GtkNotebookWindowCreationFunc"></a>GtkNotebookWindowCreationFunc ()</h3>
1951
<a class="indexterm" name="id3539534"></a><pre class="programlisting"><a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a>* (*GtkNotebookWindowCreationFunc) (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *source,
1952
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *page,
1955
gpointer data);</pre>
1957
A function used by GtkNotebook when a detachable tab is dropped
1958
in the root window, it's used to create a window containing a notebook
1959
where the tab will be attached. This function will also be responsible
1960
of moving/resizing the window and adding the necessary properties to
1961
the notebook (i.e.: group-id).
1963
If the function returns <a
1964
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
1965
><code class="literal">NULL</code></a>, the drag will be cancelled.
1967
<div class="variablelist"><table border="0">
1968
<col align="left" valign="top">
1971
<td><span class="term"><em class="parameter"><code>source</code></em> :</span></td>
1972
<td>The source <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> of the drag operation
1976
<td><span class="term"><em class="parameter"><code>page</code></em> :</span></td>
1977
<td>the child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected
1981
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
1982
<td>the X coordinate where the drop happens
1986
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
1987
<td>the Y coordinate where the drop happens
1991
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
1996
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1997
<td>The created <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> where the tab will be attached, or NULL to cancel the drag
2006
<div class="refsect2" lang="en">
2007
<a name="id3539719"></a><h3>
2008
<a name="gtk-notebook-set-window-creation-hook"></a>gtk_notebook_set_window_creation_hook ()</h3>
2009
<a class="indexterm" name="id3539736"></a><pre class="programlisting">void gtk_notebook_set_window_creation_hook
2010
(<a href="GtkNotebook.html#GtkNotebookWindowCreationFunc">GtkNotebookWindowCreationFunc</a> func,
2012
GDestroyNotify destroy);</pre>
2014
Installs a global function used to create a window
2015
when a detached tab is dropped in an empty area.</p>
2019
<div class="variablelist"><table border="0">
2020
<col align="left" valign="top">
2023
<td><span class="term"><em class="parameter"><code>func</code></em> :</span></td>
2024
<td> the <a href="GtkNotebook.html#GtkNotebookWindowCreationFunc"><span class="type">GtkNotebookWindowCreationFunc</span></a>, or <a
2025
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
2026
><code class="literal">NULL</code></a>
2030
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
2031
<td> user data for <em class="parameter"><code>func</code></em>
2035
<td><span class="term"><em class="parameter"><code>destroy</code></em> :</span></td>
2036
<td> Destroy notifier for <em class="parameter"><code>data</code></em>, or <a
2037
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
2038
><code class="literal">NULL</code></a>
2043
<p class="since">Since 2.10
2047
<div class="refsect1" lang="en">
2048
<a name="id3539883"></a><h2>Property Details</h2>
2049
<div class="refsect2" lang="en">
2050
<a name="id3539893"></a><h3>
2051
<a name="GtkNotebook--enable-popup"></a>The "<code class="literal">enable-popup</code>" property</h3>
2052
<a class="indexterm" name="id3539910"></a><pre class="programlisting"> "enable-popup" gboolean : Read / Write</pre>
2053
<p>If TRUE, pressing the right mouse button on the notebook pops up a menu that you can use to go to a page.</p>
2054
<p>Default value: FALSE</p>
2057
<div class="refsect2" lang="en">
2058
<a name="id3539938"></a><h3>
2059
<a name="GtkNotebook--group-id"></a>The "<code class="literal">group-id</code>" property</h3>
2060
<a class="indexterm" name="id3539954"></a><pre class="programlisting"> "group-id" gint : Read / Write</pre>
2061
<p>Group ID for tabs drag and drop.</p>
2062
<p>Allowed values: >= -1</p>
2063
<p>Default value: -1</p>
2066
<div class="refsect2" lang="en">
2067
<a name="id3539985"></a><h3>
2068
<a name="GtkNotebook--homogeneous"></a>The "<code class="literal">homogeneous</code>" property</h3>
2069
<a class="indexterm" name="id3540001"></a><pre class="programlisting"> "homogeneous" gboolean : Read / Write</pre>
2070
<p>Whether tabs should have homogeneous sizes.</p>
2071
<p>Default value: FALSE</p>
2074
<div class="refsect2" lang="en">
2075
<a name="id3540028"></a><h3>
2076
<a name="GtkNotebook--page"></a>The "<code class="literal">page</code>" property</h3>
2077
<a class="indexterm" name="id3540044"></a><pre class="programlisting"> "page" gint : Read / Write</pre>
2078
<p>The index of the current page.</p>
2079
<p>Allowed values: >= 0</p>
2080
<p>Default value: 0</p>
2083
<div class="refsect2" lang="en">
2084
<a name="id3540076"></a><h3>
2085
<a name="GtkNotebook--scrollable"></a>The "<code class="literal">scrollable</code>" property</h3>
2086
<a class="indexterm" name="id3540092"></a><pre class="programlisting"> "scrollable" gboolean : Read / Write</pre>
2087
<p>If TRUE, scroll arrows are added if there are too many tabs to fit.</p>
2088
<p>Default value: FALSE</p>
2091
<div class="refsect2" lang="en">
2092
<a name="id3540119"></a><h3>
2093
<a name="GtkNotebook--show-border"></a>The "<code class="literal">show-border</code>" property</h3>
2094
<a class="indexterm" name="id3540135"></a><pre class="programlisting"> "show-border" gboolean : Read / Write</pre>
2095
<p>Whether the border should be shown or not.</p>
2096
<p>Default value: TRUE</p>
2099
<div class="refsect2" lang="en">
2100
<a name="id3540162"></a><h3>
2101
<a name="GtkNotebook--show-tabs"></a>The "<code class="literal">show-tabs</code>" property</h3>
2102
<a class="indexterm" name="id3540179"></a><pre class="programlisting"> "show-tabs" gboolean : Read / Write</pre>
2103
<p>Whether tabs should be shown or not.</p>
2104
<p>Default value: TRUE</p>
2107
<div class="refsect2" lang="en">
2108
<a name="id3540205"></a><h3>
2109
<a name="GtkNotebook--tab-border"></a>The "<code class="literal">tab-border</code>" property</h3>
2110
<a class="indexterm" name="id3540222"></a><pre class="programlisting"> "tab-border" guint : Write</pre>
2111
<p>Width of the border around the tab labels.</p>
2112
<p>Default value: 2</p>
2115
<div class="refsect2" lang="en">
2116
<a name="id3540248"></a><h3>
2117
<a name="GtkNotebook--tab-hborder"></a>The "<code class="literal">tab-hborder</code>" property</h3>
2118
<a class="indexterm" name="id3540265"></a><pre class="programlisting"> "tab-hborder" guint : Read / Write</pre>
2119
<p>Width of the horizontal border of tab labels.</p>
2120
<p>Default value: 2</p>
2123
<div class="refsect2" lang="en">
2124
<a name="id3540292"></a><h3>
2125
<a name="GtkNotebook--tab-pos"></a>The "<code class="literal">tab-pos</code>" property</h3>
2126
<a class="indexterm" name="id3540308"></a><pre class="programlisting"> "tab-pos" <a href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a> : Read / Write</pre>
2127
<p>Which side of the notebook holds the tabs.</p>
2128
<p>Default value: GTK_POS_TOP</p>
2131
<div class="refsect2" lang="en">
2132
<a name="id3540335"></a><h3>
2133
<a name="GtkNotebook--tab-vborder"></a>The "<code class="literal">tab-vborder</code>" property</h3>
2134
<a class="indexterm" name="id3540352"></a><pre class="programlisting"> "tab-vborder" guint : Read / Write</pre>
2135
<p>Width of the vertical border of tab labels.</p>
2136
<p>Default value: 2</p>
2139
<div class="refsect1" lang="en">
2140
<a name="id3540380"></a><h2>Child Property Details</h2>
2141
<div class="refsect2" lang="en">
2142
<a name="id3540391"></a><h3>
2143
<a name="GtkNotebook--detachable"></a>The "<code class="literal">detachable</code>" child property</h3>
2144
<a class="indexterm" name="id3540408"></a><pre class="programlisting"> "detachable" gboolean : Read / Write</pre>
2145
<p>Whether the tab is detachable.</p>
2146
<p>Default value: FALSE</p>
2149
<div class="refsect2" lang="en">
2150
<a name="id3540434"></a><h3>
2151
<a name="GtkNotebook--menu-label"></a>The "<code class="literal">menu-label</code>" child property</h3>
2152
<a class="indexterm" name="id3540450"></a><pre class="programlisting"> "menu-label" gchararray : Read / Write</pre>
2153
<p>The string displayed in the child's menu entry.</p>
2154
<p>Default value: NULL</p>
2157
<div class="refsect2" lang="en">
2158
<a name="id3540477"></a><h3>
2159
<a name="GtkNotebook--position"></a>The "<code class="literal">position</code>" child property</h3>
2160
<a class="indexterm" name="id3540494"></a><pre class="programlisting"> "position" gint : Read / Write</pre>
2161
<p>The index of the child in the parent.</p>
2162
<p>Allowed values: >= -1</p>
2163
<p>Default value: 0</p>
2166
<div class="refsect2" lang="en">
2167
<a name="id3540524"></a><h3>
2168
<a name="GtkNotebook--reorderable"></a>The "<code class="literal">reorderable</code>" child property</h3>
2169
<a class="indexterm" name="id3540541"></a><pre class="programlisting"> "reorderable" gboolean : Read / Write</pre>
2170
<p>Whether the tab is reorderable by user action or not.</p>
2171
<p>Default value: FALSE</p>
2174
<div class="refsect2" lang="en">
2175
<a name="id3540568"></a><h3>
2176
<a name="GtkNotebook--tab-expand"></a>The "<code class="literal">tab-expand</code>" child property</h3>
2177
<a class="indexterm" name="id3540585"></a><pre class="programlisting"> "tab-expand" gboolean : Read / Write</pre>
2178
<p>Whether to expand the child's tab or not.</p>
2179
<p>Default value: TRUE</p>
2182
<div class="refsect2" lang="en">
2183
<a name="id3540611"></a><h3>
2184
<a name="GtkNotebook--tab-fill"></a>The "<code class="literal">tab-fill</code>" child property</h3>
2185
<a class="indexterm" name="id3540628"></a><pre class="programlisting"> "tab-fill" gboolean : Read / Write</pre>
2186
<p>Whether the child's tab should fill the allocated area or not.</p>
2187
<p>Default value: TRUE</p>
2190
<div class="refsect2" lang="en">
2191
<a name="id3540655"></a><h3>
2192
<a name="GtkNotebook--tab-label"></a>The "<code class="literal">tab-label</code>" child property</h3>
2193
<a class="indexterm" name="id3540672"></a><pre class="programlisting"> "tab-label" gchararray : Read / Write</pre>
2194
<p>The string displayed on the child's tab label.</p>
2195
<p>Default value: NULL</p>
2198
<div class="refsect2" lang="en">
2199
<a name="id3540698"></a><h3>
2200
<a name="GtkNotebook--tab-pack"></a>The "<code class="literal">tab-pack</code>" child property</h3>
2201
<a class="indexterm" name="id3540715"></a><pre class="programlisting"> "tab-pack" <a href="gtk-Standard-Enumerations.html#GtkPackType">GtkPackType</a> : Read / Write</pre>
2202
<p>A GtkPackType indicating whether the child is packed with reference to the start or end of the parent.</p>
2203
<p>Default value: GTK_PACK_START</p>
2206
<div class="refsect1" lang="en">
2207
<a name="id3540744"></a><h2>Style Property Details</h2>
2208
<div class="refsect2" lang="en">
2209
<a name="id3540755"></a><h3>
2210
<a name="GtkNotebook--arrow-spacing"></a>The "<code class="literal">arrow-spacing</code>" style property</h3>
2211
<a class="indexterm" name="id3540771"></a><pre class="programlisting"> "arrow-spacing" gint : Read</pre>
2213
The "arrow-size" property defines the spacing between the scroll
2214
arrows and the tabs.</p>
2218
<p>Allowed values: >= 0</p>
2219
<p>Default value: 0</p>
2224
<div class="refsect2" lang="en">
2225
<a name="id3540812"></a><h3>
2226
<a name="GtkNotebook--has-backward-stepper"></a>The "<code class="literal">has-backward-stepper</code>" style property</h3>
2227
<a class="indexterm" name="id3540829"></a><pre class="programlisting"> "has-backward-stepper" gboolean : Read</pre>
2229
The "has-backward-stepper" property determines whether
2230
the standard backward arrow button is displayed.</p>
2234
<p>Default value: TRUE</p>
2239
<div class="refsect2" lang="en">
2240
<a name="id3540866"></a><h3>
2241
<a name="GtkNotebook--has-forward-stepper"></a>The "<code class="literal">has-forward-stepper</code>" style property</h3>
2242
<a class="indexterm" name="id3540883"></a><pre class="programlisting"> "has-forward-stepper" gboolean : Read</pre>
2244
The "has-forward-stepper" property determines whether
2245
the standard forward arrow button is displayed.</p>
2249
<p>Default value: TRUE</p>
2254
<div class="refsect2" lang="en">
2255
<a name="id3540920"></a><h3>
2256
<a name="GtkNotebook--has-secondary-backward-stepper"></a>The "<code class="literal">has-secondary-backward-stepper</code>" style property</h3>
2257
<a class="indexterm" name="id3540937"></a><pre class="programlisting"> "has-secondary-backward-stepper" gboolean : Read</pre>
2259
The "has-secondary-backward-stepper" property determines whether
2260
a second backward arrow button is displayed on the opposite end
2261
of the tab area.</p>
2265
<p>Default value: FALSE</p>
2270
<div class="refsect2" lang="en">
2271
<a name="id3540975"></a><h3>
2272
<a name="GtkNotebook--has-secondary-forward-stepper"></a>The "<code class="literal">has-secondary-forward-stepper</code>" style property</h3>
2273
<a class="indexterm" name="id3540993"></a><pre class="programlisting"> "has-secondary-forward-stepper" gboolean : Read</pre>
2275
The "has-secondary-forward-stepper" property determines whether
2276
a second forward arrow button is displayed on the opposite end
2277
of the tab area.</p>
2281
<p>Default value: FALSE</p>
2286
<div class="refsect2" lang="en">
2287
<a name="id3541030"></a><h3>
2288
<a name="GtkNotebook--tab-curvature"></a>The "<code class="literal">tab-curvature</code>" style property</h3>
2289
<a class="indexterm" name="id3541047"></a><pre class="programlisting"> "tab-curvature" gint : Read</pre>
2291
The "tab-curvature" property defines size of tab curvature.</p>
2295
<p>Allowed values: >= 0</p>
2296
<p>Default value: 1</p>
2301
<div class="refsect2" lang="en">
2302
<a name="id3541087"></a><h3>
2303
<a name="GtkNotebook--tab-overlap"></a>The "<code class="literal">tab-overlap</code>" style property</h3>
2304
<a class="indexterm" name="id3541104"></a><pre class="programlisting"> "tab-overlap" gint : Read</pre>
2306
The "tab-overlap" property defines size of tab overlap
2311
<p>Default value: 2</p>
2316
<div class="refsect1" lang="en">
2317
<a name="id3541141"></a><h2>Signal Details</h2>
2318
<div class="refsect2" lang="en">
2319
<a name="id3541152"></a><h3>
2320
<a name="GtkNotebook-change-current-page"></a>The "change-current-page" signal</h3>
2321
<a class="indexterm" name="id3541163"></a><pre class="programlisting">gboolean user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2323
gpointer user_data) : Run Last / Action</pre>
2327
<div class="variablelist"><table border="0">
2328
<col align="left" valign="top">
2331
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2332
<td>the object which received the signal.
2336
<td><span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
2341
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2342
<td>user data set when the signal handler was connected.</td>
2345
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2354
<div class="refsect2" lang="en">
2355
<a name="id3541263"></a><h3>
2356
<a name="GtkNotebook-focus-tab"></a>The "focus-tab" signal</h3>
2357
<a class="indexterm" name="id3541274"></a><pre class="programlisting">gboolean user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2358
GtkNotebookTab arg1,
2359
gpointer user_data) : Run Last / Action</pre>
2363
<div class="variablelist"><table border="0">
2364
<col align="left" valign="top">
2367
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2368
<td>the object which received the signal.
2372
<td><span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
2377
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2378
<td>user data set when the signal handler was connected.</td>
2381
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2390
<div class="refsect2" lang="en">
2391
<a name="id3541376"></a><h3>
2392
<a name="GtkNotebook-move-focus-out"></a>The "move-focus-out" signal</h3>
2393
<a class="indexterm" name="id3541387"></a><pre class="programlisting">void user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2394
<a href="gtk-Standard-Enumerations.html#GtkDirectionType">GtkDirectionType</a> arg1,
2395
gpointer user_data) : Run Last / Action</pre>
2399
<div class="variablelist"><table border="0">
2400
<col align="left" valign="top">
2403
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2404
<td>the object which received the signal.
2408
<td><span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
2414
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2415
<td>user data set when the signal handler was connected.</td>
2421
<div class="refsect2" lang="en">
2422
<a name="id3541477"></a><h3>
2423
<a name="GtkNotebook-page-added"></a>The "page-added" signal</h3>
2424
<a class="indexterm" name="id3541488"></a><pre class="programlisting">void user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2425
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
2427
gpointer user_data) : Run Last</pre>
2429
the ::page-added signal is emitted in the notebook
2430
right after a page is added to the notebook.</p>
2434
<div class="variablelist"><table border="0">
2435
<col align="left" valign="top">
2438
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2439
<td> the <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
2443
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
2444
<td> the child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected
2448
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
2449
<td> the new page number for <em class="parameter"><code>child</code></em>
2453
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2454
<td>user data set when the signal handler was connected.</td>
2462
<div class="refsect2" lang="en">
2463
<a name="id3541630"></a><h3>
2464
<a name="GtkNotebook-page-removed"></a>The "page-removed" signal</h3>
2465
<a class="indexterm" name="id3541641"></a><pre class="programlisting">void user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2466
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
2468
gpointer user_data) : Run Last</pre>
2470
the ::page-removed signal is emitted in the notebook
2471
right after a page is removed from the notebook.</p>
2475
<div class="variablelist"><table border="0">
2476
<col align="left" valign="top">
2479
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2480
<td> the <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
2484
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
2485
<td> the child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected
2489
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
2490
<td> the <em class="parameter"><code>child</code></em> page number
2494
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2495
<td>user data set when the signal handler was connected.</td>
2503
<div class="refsect2" lang="en">
2504
<a name="id3541784"></a><h3>
2505
<a name="GtkNotebook-page-reordered"></a>The "page-reordered" signal</h3>
2506
<a class="indexterm" name="id3541795"></a><pre class="programlisting">void user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2507
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child,
2509
gpointer user_data) : Run Last</pre>
2511
the ::page-reordered signal is emitted in the notebook
2512
right after a page has been reordered.</p>
2516
<div class="variablelist"><table border="0">
2517
<col align="left" valign="top">
2520
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2521
<td> the <a href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>
2525
<td><span class="term"><em class="parameter"><code>child</code></em> :</span></td>
2526
<td> the child <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected
2530
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
2531
<td> the new page number for <em class="parameter"><code>child</code></em>
2535
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2536
<td>user data set when the signal handler was connected.</td>
2544
<div class="refsect2" lang="en">
2545
<a name="id3541938"></a><h3>
2546
<a name="GtkNotebook-reorder-tab"></a>The "reorder-tab" signal</h3>
2547
<a class="indexterm" name="id3541949"></a><pre class="programlisting">gboolean user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2548
<a href="gtk-Standard-Enumerations.html#GtkDirectionType">GtkDirectionType</a> arg1,
2550
gpointer user_data) : Run Last / Action</pre>
2554
<div class="variablelist"><table border="0">
2555
<col align="left" valign="top">
2558
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2559
<td>the object which received the signal.
2563
<td><span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
2568
<td><span class="term"><em class="parameter"><code>Param3</code></em> :</span></td>
2573
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2574
<td>user data set when the signal handler was connected.</td>
2577
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2586
<div class="refsect2" lang="en">
2587
<a name="id3542071"></a><h3>
2588
<a name="GtkNotebook-select-page"></a>The "select-page" signal</h3>
2589
<a class="indexterm" name="id3542082"></a><pre class="programlisting">gboolean user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2591
gpointer user_data) : Run Last / Action</pre>
2595
<div class="variablelist"><table border="0">
2596
<col align="left" valign="top">
2599
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2600
<td>the object which received the signal.
2604
<td><span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
2609
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2610
<td>user data set when the signal handler was connected.</td>
2613
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
2622
<div class="refsect2" lang="en">
2623
<a name="id3542182"></a><h3>
2624
<a name="GtkNotebook-switch-page"></a>The "switch-page" signal</h3>
2625
<a class="indexterm" name="id3542192"></a><pre class="programlisting">void user_function (<a href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a> *notebook,
2626
<a href="GtkNotebook.html#GtkNotebookPage">GtkNotebookPage</a> *page,
2628
gpointer user_data) : Run Last</pre>
2630
Emitted when the user or a function changes the current page.
2632
<div class="variablelist"><table border="0">
2633
<col align="left" valign="top">
2636
<td><span class="term"><em class="parameter"><code>notebook</code></em> :</span></td>
2637
<td>the object which received the signal.
2641
<td><span class="term"><em class="parameter"><code>page</code></em> :</span></td>
2642
<td>the new current page
2646
<td><span class="term"><em class="parameter"><code>page_num</code></em> :</span></td>
2647
<td>the index of the page
2652
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2653
<td>user data set when the signal handler was connected.</td>
2659
<div class="refsect1" lang="en">
2660
<a name="id3542309"></a><h2>See Also</h2>
2663
<div class="variablelist"><table border="0">
2664
<col align="left" valign="top">
2666
<td><span class="term"><a href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></span></td>
2667
<td><p>For functions that apply to every <a href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>
2668
(like <a href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a>).</p></td>