New upstream version 3.24.5

This commit is contained in:
Jeremy Bicha
2019-02-04 16:36:47 -05:00
512 changed files with 389739 additions and 466248 deletions

View File

@ -123,7 +123,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</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"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<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>
@ -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 <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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-<code class="literal">NULL</code> then it is used as the ID of the row.</p>
is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a string ID for this value, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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 <span class="type">gchar</span> *id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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-<code class="literal">NULL</code> then it is used as the ID of the row.</p>
is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a string ID for this value, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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><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>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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-<code class="literal">NULL</code> then it is used as the ID of the row. See
is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a string ID for this value, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </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 <span class="type">gchar</span> *text</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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 <span class="type">gchar</span> *text</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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><span class="type">gint</span> position</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *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 <code class="literal">NULL</code>
<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="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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><span class="type">gint</span> position</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> 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"><span class="returnvalue">gchar</span> *
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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 <code class="literal">NULL</code>
, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
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
@ -611,7 +611,7 @@ be an item from the list).</p>
<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 <code class="function">g_free()</code>. </p>
currently active text. Must be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </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>