New upstream version 3.23.2

This commit is contained in:
Andrea Azzarone
2018-08-09 13:46:53 +03:00
882 changed files with 323996 additions and 311120 deletions

View File

@ -3,12 +3,12 @@
<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 V1.79.1">
<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.27 (XML mode)">
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -648,7 +648,7 @@
<a name="GtkNotebook.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkNotebook implements
AtkImplementor and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
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>
@ -678,44 +678,87 @@ type attribute.</p>
"action-start" or “action-end” as the “type” attribute of the
&lt;child&gt; element.</p>
<p>An example of a UI definition fragment with GtkNotebook:</p>
<div class="informalexample"><pre class="programlisting">
&lt;object class="GtkNotebook"&gt;
&lt;child&gt;
&lt;object class="GtkLabel" id="notebook-content"&gt;
&lt;property name="label"&gt;Content&lt;/property&gt;
&lt;/object&gt;
&lt;/child&gt;
&lt;child type="tab"&gt;
&lt;object class="GtkLabel" id="notebook-tab"&gt;
&lt;property name="label"&gt;Tab&lt;/property&gt;
&lt;/object&gt;
&lt;/child&gt;
&lt;/object&gt;
</pre></div>
<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="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkNotebook"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"notebook-content"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">Content</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"tab"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"notebook-tab"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">Tab</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</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"><pre class="programlisting">
notebook
├── header.top
├── [&lt;action widget&gt;]
├── tabs
│ │ ├── [arrow]
│ │ ├── tab
│ │ │ ╰── &lt;tab label&gt;
┊ ┊ ┊
│ │ ├── tab[.reorderable-page]
│ │ │ ╰── &lt;tab label&gt;
│ │ ╰── [arrow]
│ ╰── [&lt;action widget&gt;]
╰── stack
├── &lt;child&gt;
╰── &lt;child&gt;
</pre></div>
<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="normal">notebook</span>
<span class="normal">├── header</span><span class="symbol">.</span><span class="normal">top</span>
<span class="normal">│ ├── </span><span class="symbol">[&lt;</span><span class="usertype">action</span><span class="normal"> widget</span><span class="symbol">&gt;]</span>
<span class="normal">│ ├── tabs</span>
<span class="normal">│ │ ├── </span><span class="symbol">[</span><span class="normal">arrow</span><span class="symbol">]</span>
<span class="normal">│ │ ├── tab</span>
<span class="normal">│ │ │ ╰── </span><span class="symbol">&lt;</span><span class="usertype">tab</span><span class="normal"> label</span><span class="symbol">&gt;</span>
<span class="normal">┊ ┊ ┊</span>
<span class="normal">│ │ ├── tab</span><span class="symbol">[.</span><span class="normal">reorderable</span><span class="symbol">-</span><span class="normal">page</span><span class="symbol">]</span>
<span class="normal">│ │ │ ╰── </span><span class="symbol">&lt;</span><span class="usertype">tab</span><span class="normal"> label</span><span class="symbol">&gt;</span>
<span class="normal">│ │ ╰── </span><span class="symbol">[</span><span class="normal">arrow</span><span class="symbol">]</span>
<span class="normal">│ ╰── </span><span class="symbol">[&lt;</span><span class="usertype">action</span><span class="normal"> widget</span><span class="symbol">&gt;]</span>
<span class="normal"></span>
<span class="normal">╰── stack</span>
<span class="normal"> ├── </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
<span class="normal"></span>
<span class="normal"> ╰── </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</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
@ -1810,28 +1853,55 @@ 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"><pre class="programlisting">
static void
on_drag_data_received (GtkWidget *widget,
GdkDragContext *context,
gint x,
gint y,
GtkSelectionData *data,
guint info,
guint time,
gpointer user_data)
{
GtkWidget *notebook;
GtkWidget **child;
<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="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<span class="function">on_drag_data_received</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">GdkDragContext</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> x</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> y</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">GtkSelectionData</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">guint</span><span class="normal"> info</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">guint</span><span class="normal"> time</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">notebook</span><span class="symbol">;</span>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">child</span><span class="symbol">;</span>
notebook = gtk_drag_get_source_widget (context);
child = (void*) gtk_selection_data_get_data (data);
<span class="normal"> notebook </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gtk3-Drag-and-Drop.html#gtk-drag-get-source-widget">gtk_drag_get_source_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span>
<span class="normal"> child </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">*)</span><span class="normal"> </span><span class="function"><a href="gtk3-Selections.html#gtk-selection-data-get-data">gtk_selection_data_get_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span>
// process_widget (*child);
<span class="normal"> </span><span class="comment">// process_widget (*child);</span>
<span class="normal"> </span><span class="function"><a href="GtkNotebook.html#gtk-notebook-detach-tab">gtk_notebook_detach_tab</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_NOTEBOOK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">notebook</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">child</span><span class="symbol">);</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
</div>
gtk_notebook_detach_tab (GTK_NOTEBOOK (notebook), *child);
}
</pre></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>
@ -2916,6 +2986,6 @@ user_function (<a class="link" href="GtkNotebook.html" title="GtkNotebook"><span
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
<hr>Generated by GTK-Doc V1.28</div>
</body>
</html>