New upstream version 3.22.28

This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
652 changed files with 498643 additions and 49781 deletions

View File

@ -8,7 +8,7 @@
<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.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -123,7 +123,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-get-active-text" title="gtk_combo_box_text_get_active_text ()">gtk_combo_box_text_get_active_text</a> <span class="c_punctuation">()</span>
@ -147,8 +147,8 @@
</div>
<div class="refsect1">
<a name="GtkComboBoxText.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<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> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
@ -202,13 +202,13 @@ translation attributes “translatable”, “context” and “comments”.</p>
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">&lt;</span>object <span class="gtkdoc kwc">class</span><span class="gtkdoc opt">=</span><span class="string">&quot;GtkComboBoxText&quot;</span><span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>items<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>item translatable<span class="gtkdoc opt">=</span><span class="string">&quot;yes&quot;</span> id<span class="gtkdoc opt">=</span><span class="string">&quot;factory&quot;</span><span class="gtkdoc opt">&gt;</span>Factory<span class="gtkdoc opt">&lt;/</span>item<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>item translatable<span class="gtkdoc opt">=</span><span class="string">&quot;yes&quot;</span> id<span class="gtkdoc opt">=</span><span class="string">&quot;home&quot;</span><span class="gtkdoc opt">&gt;</span>Home<span class="gtkdoc opt">&lt;/</span>item<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;</span>item translatable<span class="gtkdoc opt">=</span><span class="string">&quot;yes&quot;</span> id<span class="gtkdoc opt">=</span><span class="string">&quot;subway&quot;</span><span class="gtkdoc opt">&gt;</span>Subway<span class="gtkdoc opt">&lt;/</span>item<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;/</span>items<span class="gtkdoc opt">&gt;</span>
<span class="gtkdoc opt">&lt;/</span>object<span class="gtkdoc opt">&gt;</span></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>
@ -228,11 +228,11 @@ translation attributes “translatable”, “context” and “comments”.</p>
3
4
5</pre></td>
<td class="listing_code"><pre class="programlisting">combobox
╰── box<span class="gtkdoc opt">.</span>linked
├── entry<span class="gtkdoc opt">.</span>combo
├── button<span class="gtkdoc opt">.</span>combo
╰── window<span class="gtkdoc opt">.</span>popup</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>
@ -276,13 +276,13 @@ strings. The combo box created by this function has an entry.</p>
<a name="gtk-combo-box-text-append"></a><h3>gtk_combo_box_text_append ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_append (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Appends <em class="parameter"><code>text</code></em>
to the list of strings stored in <em class="parameter"><code>combo_box</code></em>
.
If <em class="parameter"><code>id</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is used as the ID of the row.</p>
is non-<code class="literal">NULL</code> then it is used as the ID of the row.</p>
<p>This is the same as calling <a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-insert" title="gtk_combo_box_text_insert ()"><code class="function">gtk_combo_box_text_insert()</code></a> with a
position of -1.</p>
<div class="refsect3">
@ -301,7 +301,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 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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>
@ -319,13 +319,13 @@ position of -1.</p>
<a name="gtk-combo-box-text-prepend"></a><h3>gtk_combo_box_text_prepend ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_prepend (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Prepends <em class="parameter"><code>text</code></em>
to the list of strings stored in <em class="parameter"><code>combo_box</code></em>
.
If <em class="parameter"><code>id</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is used as the ID of the row.</p>
is non-<code class="literal">NULL</code> then it is used as the ID of the row.</p>
<p>This is the same as calling <a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-insert" title="gtk_combo_box_text_insert ()"><code class="function">gtk_combo_box_text_insert()</code></a> with a
position of 0.</p>
<div class="refsect3">
@ -344,7 +344,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 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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>
@ -362,15 +362,15 @@ position of 0.</p>
<a name="gtk-combo-box-text-insert"></a><h3>gtk_combo_box_text_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_insert (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Inserts <em class="parameter"><code>text</code></em>
at <em class="parameter"><code>position</code></em>
in the list of strings stored in <em class="parameter"><code>combo_box</code></em>
.
If <em class="parameter"><code>id</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is used as the ID of the row. See
is non-<code class="literal">NULL</code> then it is used as the ID of the row. See
<a class="link" href="GtkComboBox.html#GtkComboBox--id-column" title="The “id-column” property"><span class="type">“id-column”</span></a>.</p>
<p>If <em class="parameter"><code>position</code></em>
is negative then <em class="parameter"><code>text</code></em>
@ -397,7 +397,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 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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>
@ -415,7 +415,7 @@ If <em class="parameter"><code>id</code></em>
<a name="gtk-combo-box-text-append-text"></a><h3>gtk_combo_box_text_append_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_append_text (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Appends <em class="parameter"><code>text</code></em>
to the list of strings stored in <em class="parameter"><code>combo_box</code></em>
.</p>
@ -450,7 +450,7 @@ position of -1.</p>
<a name="gtk-combo-box-text-prepend-text"></a><h3>gtk_combo_box_text_prepend_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_prepend_text (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Prepends <em class="parameter"><code>text</code></em>
to the list of strings stored in <em class="parameter"><code>combo_box</code></em>
.</p>
@ -485,8 +485,8 @@ position of 0.</p>
<a name="gtk-combo-box-text-insert-text"></a><h3>gtk_combo_box_text_insert_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_insert_text (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Inserts <em class="parameter"><code>text</code></em>
at <em class="parameter"><code>position</code></em>
in the list of strings stored in <em class="parameter"><code>combo_box</code></em>
@ -494,7 +494,7 @@ gtk_combo_box_text_insert_text (<em class="parameter"><code><a class="link" href
<p>If <em class="parameter"><code>position</code></em>
is negative then <em class="parameter"><code>text</code></em>
is appended.</p>
<p>This is the same as calling <a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-insert" title="gtk_combo_box_text_insert ()"><code class="function">gtk_combo_box_text_insert()</code></a> with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
<p>This is the same as calling <a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-insert" title="gtk_combo_box_text_insert ()"><code class="function">gtk_combo_box_text_insert()</code></a> with a <code class="literal">NULL</code>
ID string.</p>
<div class="refsect3">
<a name="gtk-combo-box-text-insert-text.parameters"></a><h4>Parameters</h4>
@ -531,7 +531,7 @@ ID string.</p>
<a name="gtk-combo-box-text-remove"></a><h3>gtk_combo_box_text_remove ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_text_remove (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Removes the string at <em class="parameter"><code>position</code></em>
from <em class="parameter"><code>combo_box</code></em>
.</p>
@ -585,10 +585,10 @@ gtk_combo_box_text_remove_all (<em class="parameter"><code><a class="link" href=
<hr>
<div class="refsect2">
<a name="gtk-combo-box-text-get-active-text"></a><h3>gtk_combo_box_text_get_active_text ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_combo_box_text_get_active_text (<em class="parameter"><code><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> *combo_box</code></em>);</pre>
<p>Returns the currently active string in <em class="parameter"><code>combo_box</code></em>
, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
, or <code class="literal">NULL</code>
if none is selected. If <em class="parameter"><code>combo_box</code></em>
contains an entry, this
function will return its contents (which will not necessarily
@ -610,8 +610,8 @@ 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
currently active text. Must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
<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>
<p class="since">Since: 2.24</p>
@ -630,6 +630,6 @@ currently active text. Must be freed with <a href="../glib/glib-Memory-Allocatio
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>