New upstream version 3.24.14
This commit is contained in:
Simon McVittie
@ -8,7 +8,7 @@
|
||||
<link rel="up" href="DisplayWidgets.html" title="Display Widgets">
|
||||
<link rel="prev" href="GtkLabel.html" title="GtkLabel">
|
||||
<link rel="next" href="GtkSpinner.html" title="GtkSpinner">
|
||||
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
|
||||
<meta name="generator" content="GTK-Doc V1.32.1 (XML mode)">
|
||||
<link rel="stylesheet" href="style.css" type="text/css">
|
||||
</head>
|
||||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||||
@ -38,8 +38,8 @@
|
||||
<a name="GtkImage.functions"></a><h2>Functions</h2>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
<colgroup>
|
||||
<col width="150px" class="functions_return">
|
||||
<col class="functions_name">
|
||||
<col width="150px" class="functions_proto_type">
|
||||
<col class="functions_proto_name">
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
@ -92,7 +92,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="function_type">
|
||||
<a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a>
|
||||
<a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImageType"><span class="returnvalue">GtkImageType</span></a>
|
||||
</td>
|
||||
<td class="function_name">
|
||||
<a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()">gtk_image_get_storage_type</a> <span class="c_punctuation">()</span>
|
||||
@ -345,7 +345,7 @@
|
||||
<td class="property_flags">Read / Write</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="property_type"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></td>
|
||||
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImageType"><span class="type">GtkImageType</span></a></td>
|
||||
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--storage-type" title="The “storage-type” property">storage-type</a></td>
|
||||
<td class="property_flags">Read</td>
|
||||
</tr>
|
||||
@ -367,17 +367,17 @@
|
||||
<a name="GtkImage.other"></a><h2>Types and Values</h2>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
<colgroup>
|
||||
<col width="150px" class="name">
|
||||
<col class="description">
|
||||
<col width="150px" class="other_proto_type">
|
||||
<col class="other_proto_name">
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="datatype_keyword">struct</td>
|
||||
<td class="function_name"><a class="link" href="GtkImage.html#GtkImage-struct" title="struct GtkImage">GtkImage</a></td>
|
||||
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImage-struct">GtkImage</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="datatype_keyword">enum</td>
|
||||
<td class="function_name"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType">GtkImageType</a></td>
|
||||
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImageType">GtkImageType</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table></div>
|
||||
@ -415,8 +415,8 @@ used as follows:</p>
|
||||
<tr>
|
||||
<td class="listing_lines" align="right"><pre>1
|
||||
2</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">image</span><span class="symbol">;</span>
|
||||
<span class="normal">image </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"myfile.png"</span><span class="symbol">);</span></pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">image</span><span class="p">;</span>
|
||||
<span class="n">image</span> <span class="o">=</span> <span class="n">gtk_image_new_from_file</span> <span class="p">(</span><span class="s">"myfile.png"</span><span class="p">);</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -477,39 +477,39 @@ on the image, such as button clicks, place the image inside a
|
||||
31
|
||||
32
|
||||
33</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gboolean</span>
|
||||
<span class="function">button_press_callback</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">event_box</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">GdkEventButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
||||
<span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Event box clicked at coordinates %f,%f</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span>
|
||||
<span class="normal"> event</span><span class="symbol">-></span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-></span><span class="normal">y</span><span class="symbol">);</span>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="n">gboolean</span>
|
||||
<span class="nf">button_press_callback</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">event_box</span><span class="p">,</span>
|
||||
<span class="n">GdkEventButton</span> <span class="o">*</span><span class="n">event</span><span class="p">,</span>
|
||||
<span class="n">gpointer</span> <span class="n">data</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">g_print</span> <span class="p">(</span><span class="s">"Event box clicked at coordinates %f,%f</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span>
|
||||
<span class="n">event</span><span class="o">-></span><span class="n">x</span><span class="p">,</span> <span class="n">event</span><span class="o">-></span><span class="n">y</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> </span><span class="comment">// Returning TRUE means we handled the event, so the signal</span>
|
||||
<span class="normal"> </span><span class="comment">// emission should be stopped (don’t call any further callbacks</span>
|
||||
<span class="normal"> </span><span class="comment">// that may be connected). Return FALSE to continue invoking callbacks.</span>
|
||||
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> TRUE</span><span class="symbol">;</span>
|
||||
<span class="cbracket">}</span>
|
||||
<span class="c1">// Returning TRUE means we handled the event, so the signal</span>
|
||||
<span class="c1">// emission should be stopped (don’t call any further callbacks</span>
|
||||
<span class="c1">// that may be connected). Return FALSE to continue invoking callbacks.</span>
|
||||
<span class="k">return</span> <span class="n">TRUE</span><span class="p">;</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="keyword">static</span><span class="normal"> <a href="GtkWidget.html#GtkWidget-struct">GtkWidget</a></span><span class="symbol">*</span>
|
||||
<span class="function">create_image</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">image</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">event_box</span><span class="symbol">;</span>
|
||||
<span class="k">static</span> <span class="n">GtkWidget</span><span class="o">*</span>
|
||||
<span class="nf">create_image</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">image</span><span class="p">;</span>
|
||||
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">event_box</span><span class="p">;</span>
|
||||
|
||||
<span class="normal"> image </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"myfile.png"</span><span class="symbol">);</span>
|
||||
<span class="n">image</span> <span class="o">=</span> <span class="n">gtk_image_new_from_file</span> <span class="p">(</span><span class="s">"myfile.png"</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> event_box </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkEventBox.html#gtk-event-box-new">gtk_event_box_new</a></span><span class="normal"> </span><span class="symbol">();</span>
|
||||
<span class="n">event_box</span> <span class="o">=</span> <span class="n">gtk_event_box_new</span> <span class="p">();</span>
|
||||
|
||||
<span class="normal"> </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_box</span><span class="symbol">),</span><span class="normal"> image</span><span class="symbol">);</span>
|
||||
<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">event_box</span><span class="p">),</span> <span class="n">image</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_OBJECT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_box</span><span class="symbol">),</span>
|
||||
<span class="normal"> </span><span class="string">"button_press_event"</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">button_press_callback</span><span class="symbol">),</span>
|
||||
<span class="normal"> image</span><span class="symbol">);</span>
|
||||
<span class="n">g_signal_connect</span> <span class="p">(</span><span class="n">G_OBJECT</span> <span class="p">(</span><span class="n">event_box</span><span class="p">),</span>
|
||||
<span class="s">"button_press_event"</span><span class="p">,</span>
|
||||
<span class="n">G_CALLBACK</span> <span class="p">(</span><span class="n">button_press_callback</span><span class="p">),</span>
|
||||
<span class="n">image</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> image</span><span class="symbol">;</span>
|
||||
<span class="cbracket">}</span></pre></td>
|
||||
<span class="k">return</span> <span class="n">image</span><span class="p">;</span>
|
||||
<span class="p">}</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -542,14 +542,14 @@ may appear on image CSS nodes: .icon-dropshadow, .lowres-icon.</p>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_get_icon_set (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> **icon_set</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_get_icon_set</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-get-icon-name" title="gtk_image_get_icon_name ()"><code class="function">gtk_image_get_icon_name()</code></a> instead.</p>
|
||||
</div>
|
||||
<p>Gets the icon set and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-ICON-SET:CAPS"><code class="literal">GTK_IMAGE_ICON_SET</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).</p>
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<code class="literal">GTK_IMAGE_ICON_SET</code> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-image-get-icon-set.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -573,7 +573,7 @@ The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IM
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>location to store a stock
|
||||
icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -586,8 +586,8 @@ icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" t
|
||||
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="returnvalue">GdkPixbuf</span></a> *
|
||||
gtk_image_get_pixbuf (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
|
||||
<p>Gets the <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-PIXBUF:CAPS"><code class="literal">GTK_IMAGE_PIXBUF</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<code class="literal">GTK_IMAGE_PIXBUF</code> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The caller of this function does not own a reference to the
|
||||
returned pixbuf.</p>
|
||||
<div class="refsect3">
|
||||
@ -618,14 +618,14 @@ the image is empty. </p>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_get_stock (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code><span class="type">gchar</span> **stock_id</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_get_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-get-icon-name" title="gtk_image_get_icon_name ()"><code class="function">gtk_image_get_icon_name()</code></a> instead.</p>
|
||||
</div>
|
||||
<p>Gets the stock icon name and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-STOCK:CAPS"><code class="literal">GTK_IMAGE_STOCK</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<code class="literal">GTK_IMAGE_STOCK</code> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The returned string is owned by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> and should not
|
||||
be freed.</p>
|
||||
<div class="refsect3">
|
||||
@ -651,7 +651,7 @@ stock icon name, or <code class="literal">NULL</code>. </p></td>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>place to store a stock icon
|
||||
size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -664,8 +664,8 @@ size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title=
|
||||
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="returnvalue">GdkPixbufAnimation</span></a> *
|
||||
gtk_image_get_animation (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
|
||||
<p>Gets the <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-ANIMATION:CAPS"><code class="literal">GTK_IMAGE_ANIMATION</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<code class="literal">GTK_IMAGE_ANIMATION</code> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The caller of this function does not own a reference to the
|
||||
returned animation.</p>
|
||||
<div class="refsect3">
|
||||
@ -696,10 +696,10 @@ the image is empty. </p>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_get_icon_name (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> **icon_name</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<p>Gets the icon name and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The returned string is owned by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> and should not
|
||||
be freed.</p>
|
||||
<div class="refsect3">
|
||||
@ -725,7 +725,7 @@ icon name, or <code class="literal">NULL</code>. </p></td>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>place to store an icon size
|
||||
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
(<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -739,10 +739,10 @@ icon name, or <code class="literal">NULL</code>. </p></td>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_get_gicon (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code><span class="type">GIcon</span> **gicon</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
|
||||
<p>Gets the <span class="type">GIcon</span> and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
|
||||
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="literal">GTK_IMAGE_GICON</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The storage type of the image must be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
|
||||
<a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="literal">GTK_IMAGE_GICON</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
|
||||
The caller of this function does not own a reference to the
|
||||
returned <span class="type">GIcon</span>.</p>
|
||||
<div class="refsect3">
|
||||
@ -768,7 +768,7 @@ returned <span class="type">GIcon</span>.</p>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>place to store an icon size
|
||||
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
(<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -779,11 +779,11 @@ returned <span class="type">GIcon</span>.</p>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="gtk-image-get-storage-type"></a><h3>gtk_image_get_storage_type ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a>
|
||||
<pre class="programlisting"><a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImageType"><span class="returnvalue">GtkImageType</span></a>
|
||||
gtk_image_get_storage_type (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
|
||||
<p>Gets the type of representation being used by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>
|
||||
to store image data. If the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> has no image data,
|
||||
the return value will be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a>.</p>
|
||||
the return value will be <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a>.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-image-get-storage-type.parameters"></a><h4>Parameters</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
@ -848,13 +848,13 @@ displaying the file.</p>
|
||||
<a name="gtk-image-new-from-icon-set"></a><h3>gtk_image_new_from_icon_set ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||||
gtk_image_new_from_icon_set (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_new_from_icon_set</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name" title="gtk_image_new_from_icon_name ()"><code class="function">gtk_image_new_from_icon_name()</code></a> instead.</p>
|
||||
</div>
|
||||
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying an icon set. Sample stock sizes are
|
||||
<a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-MENU:CAPS"><span class="type">GTK_ICON_SIZE_MENU</span></a>, <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-SMALL-TOOLBAR:CAPS"><span class="type">GTK_ICON_SIZE_SMALL_TOOLBAR</span></a>. Instead of using
|
||||
<span class="type">GTK_ICON_SIZE_MENU</span>, <span class="type">GTK_ICON_SIZE_SMALL_TOOLBAR</span>. Instead of using
|
||||
this function, usually it’s better to create a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>, put
|
||||
your icon sets in the icon factory, add the icon factory to the
|
||||
list of default factories with <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a>, and
|
||||
@ -879,7 +879,7 @@ icon set; you still need to unref it if you own references.
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -928,14 +928,14 @@ you should use <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name"
|
||||
<a name="gtk-image-new-from-stock"></a><h3>gtk_image_new_from_stock ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||||
gtk_image_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_new_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name" title="gtk_image_new_from_icon_name ()"><code class="function">gtk_image_new_from_icon_name()</code></a> instead.</p>
|
||||
</div>
|
||||
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying a stock icon. Sample stock icon
|
||||
names are <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-OPEN:CAPS" title="GTK_STOCK_OPEN"><span class="type">GTK_STOCK_OPEN</span></a>, <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-QUIT:CAPS" title="GTK_STOCK_QUIT"><span class="type">GTK_STOCK_QUIT</span></a>. Sample stock sizes
|
||||
are <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-MENU:CAPS"><span class="type">GTK_ICON_SIZE_MENU</span></a>, <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-SMALL-TOOLBAR:CAPS"><span class="type">GTK_ICON_SIZE_SMALL_TOOLBAR</span></a>. If the stock
|
||||
names are <span class="type">GTK_STOCK_OPEN</span>, <span class="type">GTK_STOCK_QUIT</span>. Sample stock sizes
|
||||
are <span class="type">GTK_ICON_SIZE_MENU</span>, <span class="type">GTK_ICON_SIZE_SMALL_TOOLBAR</span>. If the stock
|
||||
icon name isn’t known, the image will be empty.
|
||||
You can register your own stock icon names, see
|
||||
<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a> and <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add" title="gtk_icon_factory_add ()"><code class="function">gtk_icon_factory_add()</code></a>.</p>
|
||||
@ -955,7 +955,7 @@ You can register your own stock icon names, see
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1004,7 +1004,7 @@ is not busy with something that has a higher priority.</p>
|
||||
<a name="gtk-image-new-from-icon-name"></a><h3>gtk_image_new_from_icon_name ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||||
gtk_image_new_from_icon_name (<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying an icon from the current icon theme.
|
||||
If the icon name isn’t known, a “broken image” icon will be
|
||||
displayed instead. If the current icon theme is changed, the icon
|
||||
@ -1025,7 +1025,7 @@ will be updated appropriately.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1042,7 +1042,7 @@ will be updated appropriately.</p>
|
||||
<a name="gtk-image-new-from-gicon"></a><h3>gtk_image_new_from_gicon ()</h3>
|
||||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||||
gtk_image_new_from_gicon (<em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying an icon from the current icon theme.
|
||||
If the icon name isn’t known, a “broken image” icon will be
|
||||
displayed instead. If the current icon theme is changed, the icon
|
||||
@ -1063,7 +1063,7 @@ will be updated appropriately.</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1182,7 +1182,7 @@ gtk_image_set_from_file (<em class="parameter"><code><a class="link" href="GtkIm
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_set_from_icon_set (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_set_from_icon_set</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-set-from-icon-name" title="gtk_image_set_from_icon_name ()"><code class="function">gtk_image_set_from_icon_name()</code></a> instead.</p>
|
||||
@ -1209,7 +1209,7 @@ gtk_image_set_from_icon_set (<em class="parameter"><code><a class="link" href="G
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1252,7 +1252,7 @@ gtk_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="Gtk
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_set_from_stock (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<div class="warning">
|
||||
<p><code class="literal">gtk_image_set_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#gtk-image-set-from-icon-name" title="gtk_image_set_from_icon_name ()"><code class="function">gtk_image_set_from_icon_name()</code></a> instead.</p>
|
||||
@ -1279,7 +1279,7 @@ gtk_image_set_from_stock (<em class="parameter"><code><a class="link" href="GtkI
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>a stock icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1323,7 +1323,7 @@ nothing, if you set the animation to <code class="literal">NULL</code>).</p>
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name" title="gtk_image_new_from_icon_name ()"><code class="function">gtk_image_new_from_icon_name()</code></a> for details.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-image-set-from-icon-name.parameters"></a><h4>Parameters</h4>
|
||||
@ -1346,7 +1346,7 @@ gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>an icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1360,7 +1360,7 @@ gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="
|
||||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||||
gtk_image_set_from_gicon (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
|
||||
<em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>,
|
||||
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
|
||||
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-gicon" title="gtk_image_new_from_gicon ()"><code class="function">gtk_image_new_from_gicon()</code></a> for details.</p>
|
||||
<div class="refsect3">
|
||||
<a name="gtk-image-set-from-gicon.parameters"></a><h4>Parameters</h4>
|
||||
@ -1383,7 +1383,7 @@ gtk_image_set_from_gicon (<em class="parameter"><code><a class="link" href="GtkI
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="parameter_name"><p>size</p></td>
|
||||
<td class="parameter_description"><p>an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_description"><p>an icon size (<a href="https://developer.gnome.org/gtk4/gtk4-Standard-Enumerations.html#GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
|
||||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
@ -1548,102 +1548,12 @@ gtk_image_get_pixel_size (<em class="parameter"><code><a class="link" href="GtkI
|
||||
</div>
|
||||
</div>
|
||||
<div class="refsect1">
|
||||
<a name="GtkImage.other_details"></a><h2>Types and Values</h2>
|
||||
<div class="refsect2">
|
||||
<a name="GtkImage-struct"></a><h3>struct GtkImage</h3>
|
||||
<pre class="programlisting">struct GtkImage;</pre>
|
||||
<p>This struct contain private data only and should be accessed by the functions
|
||||
below.</p>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="GtkImageType"></a><h3>enum GtkImageType</h3>
|
||||
<p>Describes the image data representation used by a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>. If you
|
||||
want to get the image from the widget, you can only get the
|
||||
currently-stored representation. e.g. if the
|
||||
<a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a> returns <a class="link" href="GtkImage.html#GTK-IMAGE-PIXBUF:CAPS"><span class="type">GTK_IMAGE_PIXBUF</span></a>, then you can
|
||||
call <a class="link" href="GtkImage.html#gtk-image-get-pixbuf" title="gtk_image_get_pixbuf ()"><code class="function">gtk_image_get_pixbuf()</code></a> but not <a class="link" href="GtkImage.html#gtk-image-get-stock" title="gtk_image_get_stock ()"><code class="function">gtk_image_get_stock()</code></a>. For empty
|
||||
images, you can request any storage type (call any of the "get"
|
||||
functions), but they will all return <code class="literal">NULL</code> values.</p>
|
||||
<div class="refsect3">
|
||||
<a name="GtkImageType.members"></a><h4>Members</h4>
|
||||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||||
<colgroup>
|
||||
<col width="300px" class="enum_members_name">
|
||||
<col class="enum_members_description">
|
||||
<col width="200px" class="enum_members_annotations">
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-EMPTY:CAPS"></a>GTK_IMAGE_EMPTY</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>there is no image displayed by the widget</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-PIXBUF:CAPS"></a>GTK_IMAGE_PIXBUF</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a></p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-STOCK:CAPS"></a>GTK_IMAGE_STOCK</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a stock item name</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-ICON-SET:CAPS"></a>GTK_IMAGE_ICON_SET</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a></p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-ANIMATION:CAPS"></a>GTK_IMAGE_ANIMATION</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a></p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-ICON-NAME:CAPS"></a>GTK_IMAGE_ICON_NAME</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a named icon.
|
||||
This image type was added in GTK+ 2.6</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-GICON:CAPS"></a>GTK_IMAGE_GICON</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a <span class="type">GIcon</span>.
|
||||
This image type was added in GTK+ 2.14</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="enum_member_name"><p><a name="GTK-IMAGE-SURFACE:CAPS"></a>GTK_IMAGE_SURFACE</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the widget contains a <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="type">cairo_surface_t</span></a>.
|
||||
This image type was added in GTK+ 3.10</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="refsect1">
|
||||
<a name="GtkImage.property-details"></a><h2>Property Details</h2>
|
||||
<div class="refsect2">
|
||||
<a name="GtkImage--file"></a><h3>The <code class="literal">“file”</code> property</h3>
|
||||
<pre class="programlisting"> “file” <span class="type">gchar</span> *</pre>
|
||||
<p>Filename to load and display.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: NULL</p>
|
||||
</div>
|
||||
@ -1654,6 +1564,7 @@ functions), but they will all return <code class="literal">NULL</code> values.</
|
||||
<p>The GIcon displayed in the GtkImage. For themed icons,
|
||||
If the icon theme is changed, the image will be updated
|
||||
automatically.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p class="since">Since: 2.14</p>
|
||||
</div>
|
||||
@ -1663,6 +1574,7 @@ automatically.</p>
|
||||
<pre class="programlisting"> “icon-name” <span class="type">gchar</span> *</pre>
|
||||
<p>The name of the icon in the icon theme. If the icon theme is
|
||||
changed, the image will be updated automatically.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: NULL</p>
|
||||
<p class="since">Since: 2.6</p>
|
||||
@ -1676,6 +1588,7 @@ changed, the image will be updated automatically.</p>
|
||||
<p><code class="literal">GtkImage:icon-set</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#GtkImage--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a> instead.</p>
|
||||
</div>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
</div>
|
||||
<hr>
|
||||
@ -1683,6 +1596,7 @@ changed, the image will be updated automatically.</p>
|
||||
<a name="GtkImage--icon-size"></a><h3>The <code class="literal">“icon-size”</code> property</h3>
|
||||
<pre class="programlisting"> “icon-size” <span class="type">gint</span></pre>
|
||||
<p>Symbolic size to use for stock icon, icon set or named icon.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Allowed values: >= 0</p>
|
||||
<p>Default value: 4</p>
|
||||
@ -1692,6 +1606,7 @@ changed, the image will be updated automatically.</p>
|
||||
<a name="GtkImage--pixbuf"></a><h3>The <code class="literal">“pixbuf”</code> property</h3>
|
||||
<pre class="programlisting"> “pixbuf” <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *</pre>
|
||||
<p>A GdkPixbuf to display.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
</div>
|
||||
<hr>
|
||||
@ -1699,6 +1614,7 @@ changed, the image will be updated automatically.</p>
|
||||
<a name="GtkImage--pixbuf-animation"></a><h3>The <code class="literal">“pixbuf-animation”</code> property</h3>
|
||||
<pre class="programlisting"> “pixbuf-animation” <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> *</pre>
|
||||
<p>GdkPixbufAnimation to display.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
</div>
|
||||
<hr>
|
||||
@ -1707,7 +1623,8 @@ changed, the image will be updated automatically.</p>
|
||||
<pre class="programlisting"> “pixel-size” <span class="type">gint</span></pre>
|
||||
<p>The "pixel-size" property can be used to specify a fixed size
|
||||
overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="The “icon-size” property"><span class="type">“icon-size”</span></a> property for images of type
|
||||
<a class="link" href="GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>.</p>
|
||||
<a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Allowed values: >= -1</p>
|
||||
<p>Default value: -1</p>
|
||||
@ -1718,6 +1635,7 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
|
||||
<a name="GtkImage--resource"></a><h3>The <code class="literal">“resource”</code> property</h3>
|
||||
<pre class="programlisting"> “resource” <span class="type">gchar</span> *</pre>
|
||||
<p>A path to a resource file to display.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: NULL</p>
|
||||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
|
||||
@ -1731,14 +1649,16 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
|
||||
<p><code class="literal">GtkImage:stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||||
<p>Use <a class="link" href="GtkImage.html#GtkImage--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a> instead.</p>
|
||||
</div>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: NULL</p>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="refsect2">
|
||||
<a name="GtkImage--storage-type"></a><h3>The <code class="literal">“storage-type”</code> property</h3>
|
||||
<pre class="programlisting"> “storage-type” <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></pre>
|
||||
<pre class="programlisting"> “storage-type” <a href="https://developer.gnome.org/gtk4/GtkImage.html#GtkImageType"><span class="type">GtkImageType</span></a></pre>
|
||||
<p>The representation being used for image data.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read</p>
|
||||
<p>Default value: GTK_IMAGE_EMPTY</p>
|
||||
</div>
|
||||
@ -1747,6 +1667,7 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
|
||||
<a name="GtkImage--surface"></a><h3>The <code class="literal">“surface”</code> property</h3>
|
||||
<pre class="programlisting"> “surface” <span class="type">CairoSurface</span> *</pre>
|
||||
<p>A cairo_surface_t to display.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
</div>
|
||||
<hr>
|
||||
@ -1755,8 +1676,9 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
|
||||
<pre class="programlisting"> “use-fallback” <span class="type">gboolean</span></pre>
|
||||
<p>Whether the icon displayed in the GtkImage will use
|
||||
standard icon names fallback. The value of this property
|
||||
is only relevant for images of type <a class="link" href="GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>
|
||||
and <a class="link" href="GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="literal">GTK_IMAGE_GICON</code></a>.</p>
|
||||
is only relevant for images of type <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>
|
||||
and <a href="https://developer.gnome.org/gtk4/GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="literal">GTK_IMAGE_GICON</code></a>.</p>
|
||||
<p>Owner: GtkImage</p>
|
||||
<p>Flags: Read / Write</p>
|
||||
<p>Default value: FALSE</p>
|
||||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||||
@ -1768,6 +1690,6 @@ and <a class="link" href="GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="liter
|
||||
</div>
|
||||
</div>
|
||||
<div class="footer">
|
||||
<hr>Generated by GTK-Doc V1.29</div>
|
||||
<hr>Generated by GTK-Doc V1.32.1</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user