New upstream version 3.23.0

This commit is contained in:
Iain Lane
2018-07-18 14:06:19 +01:00
731 changed files with 556100 additions and 542972 deletions

View File

@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkComboBoxText: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="prev" href="GtkComboBox.html" title="GtkComboBox">
<link rel="next" href="GtkMenu.html" title="GtkMenu">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -191,53 +191,27 @@ elements for each item. Each &lt;item&gt; element can specify the “id”
corresponding to the appended text and also supports the regular
translation attributes “translatable”, “context” and “comments”.</p>
<p>Here is a UI definition fragment specifying GtkComboBoxText items:</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</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">"GtkComboBoxText"</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">items</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"factory"</span><span class="symbol">&gt;</span><span class="normal">Factory</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"home"</span><span class="symbol">&gt;</span><span class="normal">Home</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"subway"</span><span class="symbol">&gt;</span><span class="normal">Subway</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
<span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">items</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>
<div class="informalexample"><pre class="programlisting">
&lt;object class="GtkComboBoxText"&gt;
&lt;items&gt;
&lt;item translatable="yes" id="factory"&gt;Factory&lt;/item&gt;
&lt;item translatable="yes" id="home"&gt;Home&lt;/item&gt;
&lt;item translatable="yes" id="subway"&gt;Subway&lt;/item&gt;
&lt;/items&gt;
&lt;/object&gt;
</pre></div>
<p></p>
</div>
<hr>
<div class="refsect2">
<a name="id-1.3.13.3.8.8"></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</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="normal">combobox</span>
<span class="normal">╰── box</span><span class="symbol">.</span><span class="normal">linked</span>
<span class="normal"> ├── entry</span><span class="symbol">.</span><span class="normal">combo</span>
<span class="normal"> ├── button</span><span class="symbol">.</span><span class="normal">combo</span>
<span class="normal"> ╰── window</span><span class="symbol">.</span><span class="normal">popup</span></pre></td>
</tr>
</tbody>
</table>
</div>
<div class="informalexample"><pre class="programlisting">
combobox
╰── box.linked
├── entry.combo
├── button.combo
╰── window.popup
</pre></div>
<p></p>
<p>GtkComboBoxText has a single CSS node with name combobox. It adds
the style class .combo to the main CSS nodes of its entry and button
@ -301,7 +275,7 @@ position of -1.</p>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string ID for this value, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> a string ID for this value, or <code class="literal">NULL</code>. </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>
@ -344,7 +318,7 @@ position of 0.</p>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string ID for this value, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> a string ID for this value, or <code class="literal">NULL</code>. </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>
@ -397,7 +371,7 @@ If <em class="parameter"><code>id</code></em>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string ID for this value, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> a string ID for this value, or <code class="literal">NULL</code>. </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>
@ -610,7 +584,7 @@ be an item from the list).</p>
</div>
<div class="refsect3">
<a name="gtk-combo-box-text-get-active-text.returns"></a><h4>Returns</h4>
<p>a newly allocated string containing the
<p> a newly allocated string containing the
currently active text. Must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
@ -630,6 +604,6 @@ currently active text. Must be freed with <code class="function">g_free()</code>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>