3014 lines
150 KiB
HTML
3014 lines
150 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkNotebook: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="LayoutContainers.html" title="Layout Containers">
|
||
<link rel="prev" href="GtkLayout.html" title="GtkLayout">
|
||
<link rel="next" href="GtkExpander.html" title="GtkExpander">
|
||
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.properties" class="shortcut">Properties</a></span><span id="nav_child_properties"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.child-properties" class="shortcut">Child Properties</a></span><span id="nav_style_properties"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkNotebook.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="GtkLayout.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkExpander.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkNotebook"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkNotebook.top_of_page"></a>GtkNotebook</span></h2>
|
||
<p>GtkNotebook — A tabbed notebook container</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"><img src="notebook.png"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-new" title="gtk_notebook_new ()">gtk_notebook_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-append-page" title="gtk_notebook_append_page ()">gtk_notebook_append_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-append-page-menu" title="gtk_notebook_append_page_menu ()">gtk_notebook_append_page_menu</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-prepend-page" title="gtk_notebook_prepend_page ()">gtk_notebook_prepend_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-prepend-page-menu" title="gtk_notebook_prepend_page_menu ()">gtk_notebook_prepend_page_menu</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-insert-page" title="gtk_notebook_insert_page ()">gtk_notebook_insert_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-insert-page-menu" title="gtk_notebook_insert_page_menu ()">gtk_notebook_insert_page_menu</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-remove-page" title="gtk_notebook_remove_page ()">gtk_notebook_remove_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-detach-tab" title="gtk_notebook_detach_tab ()">gtk_notebook_detach_tab</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-page-num" title="gtk_notebook_page_num ()">gtk_notebook_page_num</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-next-page" title="gtk_notebook_next_page ()">gtk_notebook_next_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-prev-page" title="gtk_notebook_prev_page ()">gtk_notebook_prev_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-reorder-child" title="gtk_notebook_reorder_child ()">gtk_notebook_reorder_child</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-pos" title="gtk_notebook_set_tab_pos ()">gtk_notebook_set_tab_pos</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()">gtk_notebook_set_show_tabs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()">gtk_notebook_set_show_border</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()">gtk_notebook_set_scrollable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-popup-enable" title="gtk_notebook_popup_enable ()">gtk_notebook_popup_enable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-popup-disable" title="gtk_notebook_popup_disable ()">gtk_notebook_popup_disable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-current-page" title="gtk_notebook_get_current_page ()">gtk_notebook_get_current_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-menu-label" title="gtk_notebook_get_menu_label ()">gtk_notebook_get_menu_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-nth-page" title="gtk_notebook_get_nth_page ()">gtk_notebook_get_nth_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-n-pages" title="gtk_notebook_get_n_pages ()">gtk_notebook_get_n_pages</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-label" title="gtk_notebook_get_tab_label ()">gtk_notebook_get_tab_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-menu-label" title="gtk_notebook_set_menu_label ()">gtk_notebook_set_menu_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-menu-label-text" title="gtk_notebook_set_menu_label_text ()">gtk_notebook_set_menu_label_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-label" title="gtk_notebook_set_tab_label ()">gtk_notebook_set_tab_label</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-label-text" title="gtk_notebook_set_tab_label_text ()">gtk_notebook_set_tab_label_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-reorderable" title="gtk_notebook_set_tab_reorderable ()">gtk_notebook_set_tab_reorderable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-detachable" title="gtk_notebook_set_tab_detachable ()">gtk_notebook_set_tab_detachable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-menu-label-text" title="gtk_notebook_get_menu_label_text ()">gtk_notebook_get_menu_label_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-scrollable" title="gtk_notebook_get_scrollable ()">gtk_notebook_get_scrollable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-show-border" title="gtk_notebook_get_show_border ()">gtk_notebook_get_show_border</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-show-tabs" title="gtk_notebook_get_show_tabs ()">gtk_notebook_get_show_tabs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-label-text" title="gtk_notebook_get_tab_label_text ()">gtk_notebook_get_tab_label_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="returnvalue">GtkPositionType</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-pos" title="gtk_notebook_get_tab_pos ()">gtk_notebook_get_tab_pos</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-reorderable" title="gtk_notebook_get_tab_reorderable ()">gtk_notebook_get_tab_reorderable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-detachable" title="gtk_notebook_get_tab_detachable ()">gtk_notebook_get_tab_detachable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">guint16</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-hborder" title="gtk_notebook_get_tab_hborder ()">gtk_notebook_get_tab_hborder</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">guint16</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-tab-vborder" title="gtk_notebook_get_tab_vborder ()">gtk_notebook_get_tab_vborder</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-current-page" title="gtk_notebook_set_current_page ()">gtk_notebook_set_current_page</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-group-name" title="gtk_notebook_set_group_name ()">gtk_notebook_set_group_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-group-name" title="gtk_notebook_get_group_name ()">gtk_notebook_get_group_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-set-action-widget" title="gtk_notebook_set_action_widget ()">gtk_notebook_set_action_widget</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkNotebook.html#gtk-notebook-get-action-widget" title="gtk_notebook_get_action_widget ()">gtk_notebook_get_action_widget</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--enable-popup" title="The “enable-popup” property">enable-popup</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--group-name" title="The “group-name” property">group-name</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--page" title="The “page” property">page</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--scrollable" title="The “scrollable” property">scrollable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--show-border" title="The “show-border” property">show-border</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--show-tabs" title="The “show-tabs” property">show-tabs</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--tab-pos" title="The “tab-pos” property">tab-pos</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.child-properties"></a><h2>Child Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="child_properties_type">
|
||
<col width="300px" class="child_properties_name">
|
||
<col width="200px" class="child_properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-detachable" title="The “detachable” child property">detachable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-menu-label" title="The “menu-label” child property">menu-label</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-position" title="The “position” child property">position</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-reorderable" title="The “reorderable” child property">reorderable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-expand" title="The “tab-expand” child property">tab-expand</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-fill" title="The “tab-fill” child property">tab-fill</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--c-tab-label" title="The “tab-label” child property">tab-label</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.style-properties"></a><h2>Style Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="style_properties_type">
|
||
<col width="300px" class="style_properties_name">
|
||
<col width="200px" class="style_properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-arrow-spacing" title="The “arrow-spacing” style property">arrow-spacing</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-backward-stepper" title="The “has-backward-stepper” style property">has-backward-stepper</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-forward-stepper" title="The “has-forward-stepper” style property">has-forward-stepper</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-secondary-backward-stepper" title="The “has-secondary-backward-stepper” style property">has-secondary-backward-stepper</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-secondary-forward-stepper" title="The “has-secondary-forward-stepper” style property">has-secondary-forward-stepper</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-has-tab-gap" title="The “has-tab-gap” style property">has-tab-gap</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-initial-gap" title="The “initial-gap” style property">initial-gap</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-tab-curvature" title="The “tab-curvature” style property">tab-curvature</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkNotebook.html#GtkNotebook--s-tab-overlap" title="The “tab-overlap” style property">tab-overlap</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signal_proto_type">
|
||
<col width="300px" class="signal_proto_name">
|
||
<col width="200px" class="signal_proto_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-change-current-page" title="The “change-current-page” signal">change-current-page</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type">
|
||
<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="returnvalue">GtkNotebook</span></a>*</td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-create-window" title="The “create-window” signal">create-window</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-focus-tab" title="The “focus-tab” signal">focus-tab</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-move-focus-out" title="The “move-focus-out” signal">move-focus-out</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-added" title="The “page-added” signal">page-added</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-removed" title="The “page-removed” signal">page-removed</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-page-reordered" title="The “page-reordered” signal">page-reordered</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-reorder-tab" title="The “reorder-tab” signal">reorder-tab</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-select-page" title="The “select-page” signal">select-page</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkNotebook.html#GtkNotebook-switch-page" title="The “switch-page” signal">switch-page</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkNotebook.html#GtkNotebook-struct" title="struct GtkNotebook">GtkNotebook</a></td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
|
||
<span class="lineart">╰──</span> GtkNotebook
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GtkNotebook implements
|
||
AtkImplementorIface and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.description"></a><h2>Description</h2>
|
||
<p>The <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget is a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> whose children are pages that
|
||
can be switched between using tab labels along one edge.</p>
|
||
<p>There are many configuration options for GtkNotebook. Among other
|
||
things, you can choose on which edge the tabs appear
|
||
(see <a class="link" href="GtkNotebook.html#gtk-notebook-set-tab-pos" title="gtk_notebook_set_tab_pos ()"><code class="function">gtk_notebook_set_tab_pos()</code></a>), whether, if there are too many
|
||
tabs to fit the notebook should be made bigger or scrolling
|
||
arrows added (see <a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()"><code class="function">gtk_notebook_set_scrollable()</code></a>), and whether there
|
||
will be a popup menu allowing the users to switch pages.
|
||
(see <a class="link" href="GtkNotebook.html#gtk-notebook-popup-enable" title="gtk_notebook_popup_enable ()"><code class="function">gtk_notebook_popup_enable()</code></a>, <a class="link" href="GtkNotebook.html#gtk-notebook-popup-disable" title="gtk_notebook_popup_disable ()"><code class="function">gtk_notebook_popup_disable()</code></a>)</p>
|
||
<div class="refsect2">
|
||
<a name="id-1.3.7.16.12.4"></a><h3>GtkNotebook as GtkBuildable</h3>
|
||
<p>The GtkNotebook implementation of the <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="type">GtkBuildable</span></a> interface
|
||
supports placing children into tabs by specifying “tab” as the
|
||
“type” attribute of a <code class="literal"><child></code> element. Note that the content
|
||
of the tab must be created before the tab can be filled.
|
||
A tab child can be specified without specifying a <code class="literal"><child></code>
|
||
type attribute.</p>
|
||
<p>To add a child widget in the notebooks action area, specify
|
||
"action-start" or “action-end” as the “type” attribute of the
|
||
<code class="literal"><child></code> element.</p>
|
||
<p>An example of a UI definition fragment with GtkNotebook:</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10
|
||
11
|
||
12</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="o"><</span><span class="n">object</span><span class="w"> </span><span class="n">class</span><span class="o">=</span><span class="s">"GtkNotebook"</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">child</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">object</span><span class="w"> </span><span class="n">class</span><span class="o">=</span><span class="s">"GtkLabel"</span><span class="w"> </span><span class="n">id</span><span class="o">=</span><span class="s">"notebook-content"</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">property</span><span class="w"> </span><span class="n">name</span><span class="o">=</span><span class="s">"label"</span><span class="o">></span><span class="n">Content</span><span class="o"></</span><span class="n">property</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"></</span><span class="n">object</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"></</span><span class="n">child</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">child</span><span class="w"> </span><span class="n">type</span><span class="o">=</span><span class="s">"tab"</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">object</span><span class="w"> </span><span class="n">class</span><span class="o">=</span><span class="s">"GtkLabel"</span><span class="w"> </span><span class="n">id</span><span class="o">=</span><span class="s">"notebook-tab"</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"><</span><span class="n">property</span><span class="w"> </span><span class="n">name</span><span class="o">=</span><span class="s">"label"</span><span class="o">></span><span class="n">Tab</span><span class="o"></</span><span class="n">property</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"></</span><span class="n">object</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="o"></</span><span class="n">child</span><span class="o">></span><span class="w"></span>
|
||
<span class="o"></</span><span class="n">object</span><span class="o">></span><span class="w"></span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="id-1.3.7.16.12.5"></a><h3>CSS nodes</h3>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10
|
||
11
|
||
12
|
||
13
|
||
14
|
||
15
|
||
16
|
||
17</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="n">notebook</span><span class="w"></span>
|
||
<span class="err">├──</span><span class="w"> </span><span class="n">header</span><span class="p">.</span><span class="n">top</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="p">[</span><span class="o"><</span><span class="n">action</span><span class="w"> </span><span class="n">widget</span><span class="o">></span><span class="p">]</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="n">tabs</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="p">[</span><span class="n">arrow</span><span class="p">]</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="n">tab</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="o"><</span><span class="n">tab</span><span class="w"> </span><span class="n">label</span><span class="o">></span><span class="w"></span>
|
||
<span class="err">┊</span><span class="w"> </span><span class="err">┊</span><span class="w"> </span><span class="err">┊</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="n">tab</span><span class="p">[.</span><span class="n">reorderable</span><span class="o">-</span><span class="n">page</span><span class="p">]</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="o"><</span><span class="n">tab</span><span class="w"> </span><span class="n">label</span><span class="o">></span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="p">[</span><span class="n">arrow</span><span class="p">]</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="p">[</span><span class="o"><</span><span class="n">action</span><span class="w"> </span><span class="n">widget</span><span class="o">></span><span class="p">]</span><span class="w"></span>
|
||
<span class="err">│</span><span class="w"></span>
|
||
<span class="err">╰──</span><span class="w"> </span><span class="n">stack</span><span class="w"></span>
|
||
<span class="w"> </span><span class="err">├──</span><span class="w"> </span><span class="o"><</span><span class="n">child</span><span class="o">></span><span class="w"></span>
|
||
<span class="w"> </span><span class="err">┊</span><span class="w"></span>
|
||
<span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="o"><</span><span class="n">child</span><span class="o">></span><span class="w"></span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>GtkNotebook has a main CSS node with name notebook, a subnode
|
||
with name header and below that a subnode with name tabs which
|
||
contains one subnode per tab with name tab.</p>
|
||
<p>If action widgets are present, their CSS nodes are placed next
|
||
to the tabs node. If the notebook is scrollable, CSS nodes with
|
||
name arrow are placed as first and last child of the tabs node.</p>
|
||
<p>The main node gets the .frame style class when the notebook
|
||
has a border (see <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()"><code class="function">gtk_notebook_set_show_border()</code></a>).</p>
|
||
<p>The header node gets one of the style class .top, .bottom,
|
||
.left or .right, depending on where the tabs are placed. For
|
||
reorderable pages, the tab node gets the .reorderable-page class.</p>
|
||
<p>A tab node gets the .dnd style class while it is moved with drag-and-drop.</p>
|
||
<p>The nodes are always arranged from left-to-right, regarldess of text direction.</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-new"></a><h3>gtk_notebook_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_notebook_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> widget with no pages.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-new.returns"></a><h4>Returns</h4>
|
||
<p> the newly created <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-append-page"></a><h3>gtk_notebook_append_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_append_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
|
||
<p>Appends a page to <em class="parameter"><code>notebook</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-append-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-append-page.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the appended
|
||
page in the notebook, or -1 if function fails</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-append-page-menu"></a><h3>gtk_notebook_append_page_menu ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_append_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
|
||
<p>Appends a page to <em class="parameter"><code>notebook</code></em>
|
||
, specifying the widget to use as the
|
||
label in the popup menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-append-page-menu.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_label</p></td>
|
||
<td class="parameter_description"><p>the widget to use as a label for the
|
||
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
|
||
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
|
||
created label with the same text as <em class="parameter"><code>tab_label</code></em>
|
||
; if <em class="parameter"><code>tab_label</code></em>
|
||
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
|
||
must be specified if the
|
||
page-switch menu is to be used. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-append-page-menu.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the appended
|
||
page in the notebook, or -1 if function fails</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-prepend-page"></a><h3>gtk_notebook_prepend_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_prepend_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
|
||
<p>Prepends a page to <em class="parameter"><code>notebook</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-prepend-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-prepend-page.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the prepended
|
||
page in the notebook, or -1 if function fails</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-prepend-page-menu"></a><h3>gtk_notebook_prepend_page_menu ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_prepend_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
|
||
<p>Prepends a page to <em class="parameter"><code>notebook</code></em>
|
||
, specifying the widget to use as the
|
||
label in the popup menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-prepend-page-menu.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_label</p></td>
|
||
<td class="parameter_description"><p>the widget to use as a label for the
|
||
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
|
||
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
|
||
created label with the same text as <em class="parameter"><code>tab_label</code></em>
|
||
; if <em class="parameter"><code>tab_label</code></em>
|
||
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
|
||
must be specified if the
|
||
page-switch menu is to be used. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-prepend-page-menu.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the prepended
|
||
page in the notebook, or -1 if function fails</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-insert-page"></a><h3>gtk_notebook_insert_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_insert_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
|
||
<p>Insert a page into <em class="parameter"><code>notebook</code></em>
|
||
at the given position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-insert-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>position</p></td>
|
||
<td class="parameter_description"><p>the index (starting at 0) at which to insert the page,
|
||
or -1 to append the page after all other pages</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-insert-page.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the inserted
|
||
page in the notebook, or -1 if function fails</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-insert-page-menu"></a><h3>gtk_notebook_insert_page_menu ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_insert_page_menu (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
|
||
<p>Insert a page into <em class="parameter"><code>notebook</code></em>
|
||
at the given position, specifying
|
||
the widget to use as the label in the popup menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-insert-page-menu.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to use as the contents of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to be used as the label
|
||
for the page, or <code class="literal">NULL</code> to use the default label, “page N”. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_label</p></td>
|
||
<td class="parameter_description"><p>the widget to use as a label for the
|
||
page-switch menu, if that is enabled. If <code class="literal">NULL</code>, and <em class="parameter"><code>tab_label</code></em>
|
||
is a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> or <code class="literal">NULL</code>, then the menu label will be a newly
|
||
created label with the same text as <em class="parameter"><code>tab_label</code></em>
|
||
; if <em class="parameter"><code>tab_label</code></em>
|
||
is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, <em class="parameter"><code>menu_label</code></em>
|
||
must be specified if the
|
||
page-switch menu is to be used. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>position</p></td>
|
||
<td class="parameter_description"><p>the index (starting at 0) at which to insert the page,
|
||
or -1 to append the page after all other pages.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-insert-page-menu.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the inserted
|
||
page in the notebook</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-remove-page"></a><h3>gtk_notebook_remove_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_remove_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
|
||
<p>Removes a page from the notebook given its index
|
||
in the notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-remove-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the index of a notebook page, starting
|
||
from 0. If -1, the last page will be removed.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-detach-tab"></a><h3>gtk_notebook_detach_tab ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_detach_tab (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Removes the child from the notebook.</p>
|
||
<p>This function is very similar to <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a>,
|
||
but additionally informs the notebook that the removal
|
||
is happening as part of a tab DND operation, which should
|
||
not be cancelled.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-detach-tab.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a child</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-page-num"></a><h3>gtk_notebook_page_num ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_page_num (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Finds the index of the page which contains the given child
|
||
widget.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-page-num.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-page-num.returns"></a><h4>Returns</h4>
|
||
<p> the index of the page containing <em class="parameter"><code>child</code></em>
|
||
, or
|
||
-1 if <em class="parameter"><code>child</code></em>
|
||
is not in the notebook</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-next-page"></a><h3>gtk_notebook_next_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_next_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Switches to the next page. Nothing happens if the current page is
|
||
the last page.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-next-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-prev-page"></a><h3>gtk_notebook_prev_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_prev_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Switches to the previous page. Nothing happens if the current page
|
||
is the first page.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-prev-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-reorder-child"></a><h3>gtk_notebook_reorder_child ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_reorder_child (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
|
||
<p>Reorders the page containing <em class="parameter"><code>child</code></em>
|
||
, so that it appears in position
|
||
<em class="parameter"><code>position</code></em>
|
||
. If <em class="parameter"><code>position</code></em>
|
||
is greater than or equal to the number of
|
||
children in the list or negative, <em class="parameter"><code>child</code></em>
|
||
will be moved to the end
|
||
of the list.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-reorder-child.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>position</p></td>
|
||
<td class="parameter_description"><p>the new position, or -1 to move to the end</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-tab-pos"></a><h3>gtk_notebook_set_tab_pos ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_tab_pos (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a> pos</code></em>);</pre>
|
||
<p>Sets the edge at which the tabs for switching pages in the
|
||
notebook are drawn.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-tab-pos.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pos</p></td>
|
||
<td class="parameter_description"><p>the edge to draw the tabs at</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-show-tabs"></a><h3>gtk_notebook_set_show_tabs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_show_tabs (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> show_tabs</code></em>);</pre>
|
||
<p>Sets whether to show the tabs for the notebook or not.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-show-tabs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>show_tabs</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the tabs should be shown</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-show-border"></a><h3>gtk_notebook_set_show_border ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_show_border (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> show_border</code></em>);</pre>
|
||
<p>Sets whether a bevel will be drawn around the notebook pages.
|
||
This only has a visual effect when the tabs are not shown.
|
||
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-show-border.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>show_border</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if a bevel should be drawn around the notebook</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-scrollable"></a><h3>gtk_notebook_set_scrollable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_scrollable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> scrollable</code></em>);</pre>
|
||
<p>Sets whether the tab label area will have arrows for
|
||
scrolling if there are too many tabs to fit in the area.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-scrollable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>scrollable</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if scroll arrows should be added</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-popup-enable"></a><h3>gtk_notebook_popup_enable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_popup_enable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Enables the popup menu: if the user clicks with the right
|
||
mouse button on the tab labels, a menu with all the pages
|
||
will be popped up.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-popup-enable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-popup-disable"></a><h3>gtk_notebook_popup_disable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_popup_disable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Disables the popup menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-popup-disable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-current-page"></a><h3>gtk_notebook_get_current_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_get_current_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Returns the page number of the current page.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-current-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-current-page.returns"></a><h4>Returns</h4>
|
||
<p> the index (starting from 0) of the current
|
||
page in the notebook. If the notebook has no pages,
|
||
then -1 will be returned.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-menu-label"></a><h3>gtk_notebook_get_menu_label ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_notebook_get_menu_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Retrieves the menu label widget of the page containing <em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-menu-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a widget contained in a page of <em class="parameter"><code>notebook</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-menu-label.returns"></a><h4>Returns</h4>
|
||
<p>the menu label, or <code class="literal">NULL</code> if the
|
||
notebook page does not have a menu label other than the default (the tab
|
||
label). </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-nth-page"></a><h3>gtk_notebook_get_nth_page ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_notebook_get_nth_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
|
||
<p>Returns the child widget contained in page number <em class="parameter"><code>page_num</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-nth-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the index of a page in the notebook, or -1
|
||
to get the last page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-nth-page.returns"></a><h4>Returns</h4>
|
||
<p>the child widget, or <code class="literal">NULL</code> if <em class="parameter"><code>page_num</code></em>
|
||
is out of bounds. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-n-pages"></a><h3>gtk_notebook_get_n_pages ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_notebook_get_n_pages (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Gets the number of pages in a notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-n-pages.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-n-pages.returns"></a><h4>Returns</h4>
|
||
<p> the number of pages in the notebook</p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-label"></a><h3>gtk_notebook_get_tab_label ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_notebook_get_tab_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Returns the tab label widget for the page <em class="parameter"><code>child</code></em>
|
||
.
|
||
<code class="literal">NULL</code> is returned 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 been set for <em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-label.returns"></a><h4>Returns</h4>
|
||
<p>the tab label. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-menu-label"></a><h3>gtk_notebook_set_menu_label ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_menu_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_label</code></em>);</pre>
|
||
<p>Changes the menu label for the page containing <em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-menu-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child widget</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_label</p></td>
|
||
<td class="parameter_description"><p>the menu label, or <code class="literal">NULL</code> for default. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-menu-label-text"></a><h3>gtk_notebook_set_menu_label_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_menu_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *menu_text</code></em>);</pre>
|
||
<p>Creates a new label and sets it as the menu label of <em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-menu-label-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child widget</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_text</p></td>
|
||
<td class="parameter_description"><p>the label text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-tab-label"></a><h3>gtk_notebook_set_tab_label ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_tab_label (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *tab_label</code></em>);</pre>
|
||
<p>Changes the tab label for <em class="parameter"><code>child</code></em>
|
||
.
|
||
If <code class="literal">NULL</code> is specified for <em class="parameter"><code>tab_label</code></em>
|
||
, then the page will
|
||
have the label “page N”.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-tab-label.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_label</p></td>
|
||
<td class="parameter_description"><p>the tab label widget to use, or <code class="literal">NULL</code>
|
||
for default tab label. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-tab-label-text"></a><h3>gtk_notebook_set_tab_label_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_tab_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tab_text</code></em>);</pre>
|
||
<p>Creates a new label and sets it as the tab label for the page
|
||
containing <em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-tab-label-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tab_text</p></td>
|
||
<td class="parameter_description"><p>the label text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-tab-reorderable"></a><h3>gtk_notebook_set_tab_reorderable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_tab_reorderable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> reorderable</code></em>);</pre>
|
||
<p>Sets whether the notebook tab can be reordered
|
||
via drag and drop or not.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-tab-reorderable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>reorderable</p></td>
|
||
<td class="parameter_description"><p>whether the tab is reorderable or not</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-tab-detachable"></a><h3>gtk_notebook_set_tab_detachable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_tab_detachable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> detachable</code></em>);</pre>
|
||
<p>Sets whether the tab can be detached from <em class="parameter"><code>notebook</code></em>
|
||
to another
|
||
notebook or widget.</p>
|
||
<p>Note that 2 notebooks must share a common group identificator
|
||
(see <a class="link" href="GtkNotebook.html#gtk-notebook-set-group-name" title="gtk_notebook_set_group_name ()"><code class="function">gtk_notebook_set_group_name()</code></a>) to allow automatic tabs
|
||
interchange between them.</p>
|
||
<p>If you want a widget to interact with a notebook through DnD
|
||
(i.e.: accept dragged tabs from it) it must be set as a drop
|
||
destination and accept the target “GTK_NOTEBOOK_TAB”. The notebook
|
||
will fill the selection with a GtkWidget** pointing to the child
|
||
widget that corresponds to the dropped tab.</p>
|
||
<p>Note that you should use <a class="link" href="GtkNotebook.html#gtk-notebook-detach-tab" title="gtk_notebook_detach_tab ()"><code class="function">gtk_notebook_detach_tab()</code></a> instead
|
||
of <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a> if you want to remove the tab from
|
||
the source notebook as part of accepting a drop. Otherwise,
|
||
the source notebook will think that the dragged tab was
|
||
removed from underneath the ongoing drag operation, and
|
||
will initiate a drag cancel animation.</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10
|
||
11
|
||
12
|
||
13
|
||
14
|
||
15
|
||
16
|
||
17
|
||
18
|
||
19
|
||
20</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span><span class="w"> </span><span class="kt">void</span><span class="w"></span>
|
||
<span class="nf">on_drag_data_received</span><span class="w"> </span><span class="p">(</span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">*</span><span class="n">widget</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">GdkDragContext</span><span class="w"> </span><span class="o">*</span><span class="n">context</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gint</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gint</span><span class="w"> </span><span class="n">y</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">GtkSelectionData</span><span class="w"> </span><span class="o">*</span><span class="n">data</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">guint</span><span class="w"> </span><span class="n">info</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">guint</span><span class="w"> </span><span class="n">time</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">gpointer</span><span class="w"> </span><span class="n">user_data</span><span class="p">)</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">*</span><span class="n">notebook</span><span class="p">;</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">**</span><span class="n">child</span><span class="p">;</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="n">notebook</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">gtk_drag_get_source_widget</span><span class="w"> </span><span class="p">(</span><span class="n">context</span><span class="p">);</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">child</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="kt">void</span><span class="o">*</span><span class="p">)</span><span class="w"> </span><span class="n">gtk_selection_data_get_data</span><span class="w"> </span><span class="p">(</span><span class="n">data</span><span class="p">);</span><span class="w"></span>
|
||
|
||
<span class="w"> </span><span class="c1">// process_widget (*child);</span>
|
||
|
||
<span class="w"> </span><span class="n">gtk_notebook_detach_tab</span><span class="w"> </span><span class="p">(</span><span class="n">GTK_NOTEBOOK</span><span class="w"> </span><span class="p">(</span><span class="n">notebook</span><span class="p">),</span><span class="w"> </span><span class="o">*</span><span class="n">child</span><span class="p">);</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>If you want a notebook to accept drags from other widgets,
|
||
you will have to set your own DnD code to do it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-tab-detachable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>detachable</p></td>
|
||
<td class="parameter_description"><p>whether the tab is detachable or not</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-menu-label-text"></a><h3>gtk_notebook_get_menu_label_text ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_notebook_get_menu_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Retrieves the text of the menu label for the page containing
|
||
<em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-menu-label-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child widget of a page of the notebook.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-menu-label-text.returns"></a><h4>Returns</h4>
|
||
<p>the text of the tab label, or <code class="literal">NULL</code> if the widget does
|
||
not have a menu label other than the default menu label, or the menu label
|
||
widget is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The string is owned by the widget and must not be
|
||
freed. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-scrollable"></a><h3>gtk_notebook_get_scrollable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_notebook_get_scrollable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Returns whether the tab label area has arrows for scrolling.
|
||
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-scrollable" title="gtk_notebook_set_scrollable ()"><code class="function">gtk_notebook_set_scrollable()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-scrollable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-scrollable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if arrows for scrolling are present</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-show-border"></a><h3>gtk_notebook_get_show_border ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_notebook_get_show_border (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Returns whether a bevel will be drawn around the notebook pages.
|
||
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-border" title="gtk_notebook_set_show_border ()"><code class="function">gtk_notebook_set_show_border()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-show-border.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-show-border.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the bevel is drawn</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-show-tabs"></a><h3>gtk_notebook_get_show_tabs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_notebook_get_show_tabs (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Returns whether the tabs of the notebook are shown.
|
||
See <a class="link" href="GtkNotebook.html#gtk-notebook-set-show-tabs" title="gtk_notebook_set_show_tabs ()"><code class="function">gtk_notebook_set_show_tabs()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-show-tabs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-show-tabs.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the tabs are shown</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-label-text"></a><h3>gtk_notebook_get_tab_label_text ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_notebook_get_tab_label_text (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Retrieves the text of the tab label for the page containing
|
||
<em class="parameter"><code>child</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-label-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a widget contained in a page of <em class="parameter"><code>notebook</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-label-text.returns"></a><h4>Returns</h4>
|
||
<p>the text of the tab label, or <code class="literal">NULL</code> if the tab label
|
||
widget is not a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>. The string is owned by the widget and must not be
|
||
freed. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-pos"></a><h3>gtk_notebook_get_tab_pos ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="returnvalue">GtkPositionType</span></a>
|
||
gtk_notebook_get_tab_pos (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Gets the edge at which the tabs for switching pages in the
|
||
notebook are drawn.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-pos.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-pos.returns"></a><h4>Returns</h4>
|
||
<p> the edge at which the tabs are drawn</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-reorderable"></a><h3>gtk_notebook_get_tab_reorderable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_notebook_get_tab_reorderable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Gets whether the tab can be reordered via drag and drop or not.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-reorderable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-reorderable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the tab is reorderable.</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-detachable"></a><h3>gtk_notebook_get_tab_detachable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_notebook_get_tab_detachable (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
|
||
<p>Returns whether the tab contents can be detached from <em class="parameter"><code>notebook</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-detachable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>a child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-detachable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the tab is detachable.</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-hborder"></a><h3>gtk_notebook_get_tab_hborder ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">guint16</span>
|
||
gtk_notebook_get_tab_hborder (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_notebook_get_tab_hborder</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>this function returns zero</p>
|
||
</div>
|
||
<p>Returns the horizontal width of a tab border.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-hborder.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-hborder.returns"></a><h4>Returns</h4>
|
||
<p> horizontal width of a tab border</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-tab-vborder"></a><h3>gtk_notebook_get_tab_vborder ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">guint16</span>
|
||
gtk_notebook_get_tab_vborder (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_notebook_get_tab_vborder</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>this function returns zero</p>
|
||
</div>
|
||
<p>Returns the vertical width of a tab border.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-vborder.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-tab-vborder.returns"></a><h4>Returns</h4>
|
||
<p> vertical width of a tab border</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-current-page"></a><h3>gtk_notebook_set_current_page ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_current_page (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> page_num</code></em>);</pre>
|
||
<p>Switches to the page number <em class="parameter"><code>page_num</code></em>
|
||
.</p>
|
||
<p>Note that due to historical reasons, GtkNotebook refuses
|
||
to switch to a page unless the child widget is visible.
|
||
Therefore, it is recommended to show child widgets before
|
||
adding them to a notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-current-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>index of the page to switch to, starting from 0.
|
||
If negative, the last page will be used. If greater
|
||
than the number of pages in the notebook, nothing
|
||
will be done.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-group-name"></a><h3>gtk_notebook_set_group_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_group_name (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *group_name</code></em>);</pre>
|
||
<p>Sets a group name for <em class="parameter"><code>notebook</code></em>
|
||
.</p>
|
||
<p>Notebooks with the same name will be able to exchange tabs
|
||
via drag and drop. A notebook with a <code class="literal">NULL</code> group name will
|
||
not be able to exchange tabs with any other notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-group-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>group_name</p></td>
|
||
<td class="parameter_description"><p>the name of the notebook group,
|
||
or <code class="literal">NULL</code> to unset it. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-group-name"></a><h3>gtk_notebook_get_group_name ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_notebook_get_group_name (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>);</pre>
|
||
<p>Gets the current group name for <em class="parameter"><code>notebook</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-group-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-group-name.returns"></a><h4>Returns</h4>
|
||
<p>the group name, or <code class="literal">NULL</code> if none is set. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-set-action-widget"></a><h3>gtk_notebook_set_action_widget ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_notebook_set_action_widget (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
|
||
<p>Sets <em class="parameter"><code>widget</code></em>
|
||
as one of the action widgets. Depending on the pack type
|
||
the widget will be placed before or after the tabs. You can use
|
||
a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> if you need to pack more than one widget on the same side.</p>
|
||
<p>Note that action widgets are “internal” children of the notebook and thus
|
||
not included in the list returned from <a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-set-action-widget.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pack_type</p></td>
|
||
<td class="parameter_description"><p>pack type of the action widget</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-notebook-get-action-widget"></a><h3>gtk_notebook_get_action_widget ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_notebook_get_action_widget (<em class="parameter"><code><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);</pre>
|
||
<p>Gets one of the action widgets. See <a class="link" href="GtkNotebook.html#gtk-notebook-set-action-widget" title="gtk_notebook_set_action_widget ()"><code class="function">gtk_notebook_set_action_widget()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-action-widget.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pack_type</p></td>
|
||
<td class="parameter_description"><p>pack type of the action widget to receive</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-notebook-get-action-widget.returns"></a><h4>Returns</h4>
|
||
<p>The action widget with the given
|
||
<em class="parameter"><code>pack_type</code></em>
|
||
or <code class="literal">NULL</code> when this action widget has not been set. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-struct"></a><h3>struct GtkNotebook</h3>
|
||
<pre class="programlisting">struct GtkNotebook;</pre>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--enable-popup"></a><h3>The <code class="literal">“enable-popup”</code> property</h3>
|
||
<pre class="programlisting"> “enable-popup” <span class="type">gboolean</span></pre>
|
||
<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>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--group-name"></a><h3>The <code class="literal">“group-name”</code> property</h3>
|
||
<pre class="programlisting"> “group-name” <span class="type">char</span> *</pre>
|
||
<p>Group name for tab drag and drop.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--page"></a><h3>The <code class="literal">“page”</code> property</h3>
|
||
<pre class="programlisting"> “page” <span class="type">int</span></pre>
|
||
<p>The index of the current page.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--scrollable"></a><h3>The <code class="literal">“scrollable”</code> property</h3>
|
||
<pre class="programlisting"> “scrollable” <span class="type">gboolean</span></pre>
|
||
<p>If TRUE, scroll arrows are added if there are too many tabs to fit.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--show-border"></a><h3>The <code class="literal">“show-border”</code> property</h3>
|
||
<pre class="programlisting"> “show-border” <span class="type">gboolean</span></pre>
|
||
<p>Whether the border should be shown.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--show-tabs"></a><h3>The <code class="literal">“show-tabs”</code> property</h3>
|
||
<pre class="programlisting"> “show-tabs” <span class="type">gboolean</span></pre>
|
||
<p>Whether tabs should be shown.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--tab-pos"></a><h3>The <code class="literal">“tab-pos”</code> property</h3>
|
||
<pre class="programlisting"> “tab-pos” <a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a></pre>
|
||
<p>Which side of the notebook holds the tabs.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GTK_POS_TOP</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.child-property-details"></a><h2>Child Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-detachable"></a><h3>The <code class="literal">“detachable”</code> child property</h3>
|
||
<pre class="programlisting"> “detachable” <span class="type">gboolean</span></pre>
|
||
<p>Whether the tab is detachable.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-menu-label"></a><h3>The <code class="literal">“menu-label”</code> child property</h3>
|
||
<pre class="programlisting"> “menu-label” <span class="type">char</span> *</pre>
|
||
<p>The string displayed in the child's menu entry.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-position"></a><h3>The <code class="literal">“position”</code> child property</h3>
|
||
<pre class="programlisting"> “position” <span class="type">int</span></pre>
|
||
<p>The index of the child in the parent.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: 0</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-reorderable"></a><h3>The <code class="literal">“reorderable”</code> child property</h3>
|
||
<pre class="programlisting"> “reorderable” <span class="type">gboolean</span></pre>
|
||
<p>Whether the tab is reorderable by user action.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-tab-expand"></a><h3>The <code class="literal">“tab-expand”</code> child property</h3>
|
||
<pre class="programlisting"> “tab-expand” <span class="type">gboolean</span></pre>
|
||
<p>Whether to expand the child's tab.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-tab-fill"></a><h3>The <code class="literal">“tab-fill”</code> child property</h3>
|
||
<pre class="programlisting"> “tab-fill” <span class="type">gboolean</span></pre>
|
||
<p>Whether the child's tab should fill the allocated area.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--c-tab-label"></a><h3>The <code class="literal">“tab-label”</code> child property</h3>
|
||
<pre class="programlisting"> “tab-label” <span class="type">char</span> *</pre>
|
||
<p>The string displayed on the child's tab label.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.style-property-details"></a><h2>Style Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-arrow-spacing"></a><h3>The <code class="literal">“arrow-spacing”</code> style property</h3>
|
||
<pre class="programlisting"> “arrow-spacing” <span class="type">int</span></pre>
|
||
<p>The "arrow-spacing" property defines the spacing between the scroll
|
||
arrows and the tabs.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkNotebook:arrow-spacing</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This property is ignored. Use margins on arrows or
|
||
the "tabs" node to achieve the same effect.</p>
|
||
</div>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 0</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-has-backward-stepper"></a><h3>The <code class="literal">“has-backward-stepper”</code> style property</h3>
|
||
<pre class="programlisting"> “has-backward-stepper” <span class="type">gboolean</span></pre>
|
||
<p>The “has-backward-stepper” property determines whether
|
||
the standard backward arrow button is displayed.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-has-forward-stepper"></a><h3>The <code class="literal">“has-forward-stepper”</code> style property</h3>
|
||
<pre class="programlisting"> “has-forward-stepper” <span class="type">gboolean</span></pre>
|
||
<p>The “has-forward-stepper” property determines whether
|
||
the standard forward arrow button is displayed.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-has-secondary-backward-stepper"></a><h3>The <code class="literal">“has-secondary-backward-stepper”</code> style property</h3>
|
||
<pre class="programlisting"> “has-secondary-backward-stepper” <span class="type">gboolean</span></pre>
|
||
<p>The “has-secondary-backward-stepper” property determines whether
|
||
a second backward arrow button is displayed on the opposite end
|
||
of the tab area.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-has-secondary-forward-stepper"></a><h3>The <code class="literal">“has-secondary-forward-stepper”</code> style property</h3>
|
||
<pre class="programlisting"> “has-secondary-forward-stepper” <span class="type">gboolean</span></pre>
|
||
<p>The “has-secondary-forward-stepper” property determines whether
|
||
a second forward arrow button is displayed on the opposite end
|
||
of the tab area.</p>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-has-tab-gap"></a><h3>The <code class="literal">“has-tab-gap”</code> style property</h3>
|
||
<pre class="programlisting"> “has-tab-gap” <span class="type">gboolean</span></pre>
|
||
<p>The "has-tab-gap" property defines whether the active tab is draw
|
||
with a gap at the bottom. When <code class="literal">TRUE</code> the theme engine uses
|
||
gtk_render_extension to draw the active tab. When <code class="literal">FALSE</code>
|
||
gtk_render_background and gtk_render_frame are used.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkNotebook:has-tab-gap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This function always behaves as if it was set to <code class="literal">FALSE</code>.</p>
|
||
</div>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-initial-gap"></a><h3>The <code class="literal">“initial-gap”</code> style property</h3>
|
||
<pre class="programlisting"> “initial-gap” <span class="type">int</span></pre>
|
||
<p>The "initial-gap" property defines the minimum size for the initial
|
||
gap between the first tab.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkNotebook:initial-gap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>The intial gap is ignored. Use margins on the header node
|
||
to achieve the same effect.</p>
|
||
</div>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 0</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-tab-curvature"></a><h3>The <code class="literal">“tab-curvature”</code> style property</h3>
|
||
<pre class="programlisting"> “tab-curvature” <span class="type">int</span></pre>
|
||
<p>The “tab-curvature” property defines size of tab curvature.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkNotebook:tab-curvature</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This property is ignored. Use margins on tab nodes
|
||
to achieve the same effect.</p>
|
||
</div>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 1</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook--s-tab-overlap"></a><h3>The <code class="literal">“tab-overlap”</code> style property</h3>
|
||
<pre class="programlisting"> “tab-overlap” <span class="type">int</span></pre>
|
||
<p>The “tab-overlap” property defines size of tab overlap
|
||
area.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkNotebook:tab-overlap</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This property is ignored. Use margins on tab nodes
|
||
to achieve the same effect.</p>
|
||
</div>
|
||
<p>Owner: GtkNotebook</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: 2</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-change-current-page"></a><h3>The <code class="literal">“change-current-page”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<span class="type">int</span> arg1,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-create-window"></a><h3>The <code class="literal">“create-window”</code> signal</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="returnvalue">GtkNotebook</span></a>*
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page,
|
||
<span class="type">int</span> x,
|
||
<span class="type">int</span> y,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::create-window signal is emitted when a detachable
|
||
tab is dropped on the root window.</p>
|
||
<p>A handler for this signal can create a window containing
|
||
a notebook where the tab will be attached. It is also
|
||
responsible for moving/resizing the window and adding the
|
||
necessary properties to the notebook (e.g. the
|
||
<a class="link" href="GtkNotebook.html#GtkNotebook--group-name" title="The “group-name” property"><span class="type">“group-name”</span></a> ).</p>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-create-window.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> emitting the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page</p></td>
|
||
<td class="parameter_description"><p>the tab of <em class="parameter"><code>notebook</code></em>
|
||
that is being detached</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>the X coordinate where the drop happens</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>the Y coordinate where the drop happens</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-create-window.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> that <em class="parameter"><code>page</code></em>
|
||
should be
|
||
added to, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-focus-tab"></a><h3>The <code class="literal">“focus-tab”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<span class="type">GtkNotebookTab</span> arg1,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-move-focus-out"></a><h3>The <code class="literal">“move-focus-out”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> arg1,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-page-added"></a><h3>The <code class="literal">“page-added”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child,
|
||
<span class="type">guint</span> page_num,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>the ::page-added signal is emitted in the notebook
|
||
right after a page is added to the notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-page-added.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the new page number for <em class="parameter"><code>child</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-page-removed"></a><h3>The <code class="literal">“page-removed”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child,
|
||
<span class="type">guint</span> page_num,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>the ::page-removed signal is emitted in the notebook
|
||
right after a page is removed from the notebook.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-page-removed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the <em class="parameter"><code>child</code></em>
|
||
page number</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-page-reordered"></a><h3>The <code class="literal">“page-reordered”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child,
|
||
<span class="type">guint</span> page_num,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>the ::page-reordered signal is emitted in the notebook
|
||
right after a page has been reordered.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-page-reordered.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child</p></td>
|
||
<td class="parameter_description"><p>the child <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> affected</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the new page number for <em class="parameter"><code>child</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-reorder-tab"></a><h3>The <code class="literal">“reorder-tab”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkDirectionType" title="enum GtkDirectionType"><span class="type">GtkDirectionType</span></a> arg1,
|
||
<span class="type">gboolean</span> arg2,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-select-page"></a><h3>The <code class="literal">“select-page”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<span class="type">gboolean</span> arg1,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkNotebook-switch-page"></a><h3>The <code class="literal">“switch-page”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> *notebook,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page,
|
||
<span class="type">guint</span> page_num,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Emitted when the user or a function changes the current page.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkNotebook-switch-page.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>notebook</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page</p></td>
|
||
<td class="parameter_description"><p>the new current page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>page_num</p></td>
|
||
<td class="parameter_description"><p>the index of the page</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkNotebook.see-also"></a><h2>See Also</h2>
|
||
<p><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |