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>GtkExpander: 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="GtkNotebook.html" title="GtkNotebook">
<link rel="next" href="gtk3-Orientable.html" title="GtkOrientable">
<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">
@ -314,7 +314,7 @@
<a name="GtkExpander.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkExpander 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="GtkExpander.includes"></a><h2>Includes</h2>
@ -338,36 +338,71 @@ but do not add a child to it. The expander widget has an
<a class="link" href="GtkExpander.html#GtkExpander--expanded" title="The “expanded” property"><span class="type">“expanded”</span></a> property which can be used to monitor
its expansion state. You should watch this property with a signal
connection as follows:</p>
<div class="informalexample"><pre class="programlisting">
static void
expander_callback (GObject *object,
GParamSpec *param_spec,
gpointer user_data)
{
GtkExpander *expander;
<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
21
22
23
24
25
26
27
28</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">expander_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">object</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">GParamSpec</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">param_spec</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">GtkExpander</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">expander</span><span class="symbol">;</span>
expander = GTK_EXPANDER (object);
<span class="normal"> expander </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_EXPANDER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
if (gtk_expander_get_expanded (expander))
{
// Show or create widgets
}
else
{
// Hide or destroy widgets
}
}
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkExpander.html#gtk-expander-get-expanded">gtk_expander_get_expanded</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">expander</span><span class="symbol">))</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="comment">// Show or create widgets</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="comment">// Hide or destroy widgets</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="cbracket">}</span>
static void
create_expander (void)
{
GtkWidget *expander = gtk_expander_new_with_mnemonic ("_More Options");
g_signal_connect (expander, "notify::expanded",
G_CALLBACK (expander_callback), NULL);
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<span class="function">create_expander</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</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">expander </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkExpander.html#gtk-expander-new-with-mnemonic">gtk_expander_new_with_mnemonic</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"_More Options"</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">expander</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"notify::expanded"</span><span class="symbol">,</span>
<span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">expander_callback</span><span class="symbol">),</span><span class="normal"> NULL</span><span class="symbol">);</span>
<span class="normal"> </span><span class="comment">// ...</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
</div>
// ...
}
</pre></div>
<p></p>
</div>
<hr>
@ -378,28 +413,55 @@ placing a child in the label position by specifying “label” as the
“type” attribute of a &lt;child&gt; element. A normal content child can be
specified without specifying a &lt;child&gt; type attribute.</p>
<p>An example of a UI definition fragment with GtkExpander:</p>
<div class="informalexample"><pre class="programlisting">
&lt;object class="GtkExpander"&gt;
&lt;child type="label"&gt;
&lt;object class="GtkLabel" id="expander-label"/&gt;
&lt;/child&gt;
&lt;child&gt;
&lt;object class="GtkEntry" id="expander-content"/&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</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">"GtkExpander"</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">"label"</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">"expander-label"</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="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">"GtkEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"expander-content"</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.17.11.6"></a><h3>CSS nodes</h3>
<div class="informalexample"><pre class="programlisting">
expander
├── title
├── arrow
╰── &lt;label widget&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</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="normal">expander</span>
<span class="normal">├── title</span>
<span class="normal">│ ├── arrow</span>
<span class="normal">│ ╰── </span><span class="symbol">&lt;</span><span class="usertype">label</span><span class="normal"> widget</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></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>GtkExpander has three CSS nodes, the main node with the name expander,
a subnode with name title and node below it with name arrow. The arrow of an
@ -1132,6 +1194,6 @@ user_function (<a class="link" href="GtkExpander.html" title="GtkExpander"><span
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
<hr>Generated by GTK-Doc V1.28</div>
</body>
</html>