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="Application.html" title="Application support">
<link rel="prev" href="GtkApplicationWindow.html" title="GtkApplicationWindow">
<link rel="next" href="Builder.html" title="Interface builder">
<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">
@ -45,7 +45,7 @@
</colgroup>
<tbody>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkActionable.html#gtk-actionable-get-action-name" title="gtk_actionable_get_action_name ()">gtk_actionable_get_action_name</a> <span class="c_punctuation">()</span>
@ -61,7 +61,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
<span class="returnvalue">GVariant</span> *
</td>
<td class="function_name">
<a class="link" href="GtkActionable.html#gtk-actionable-get-action-target-value" title="gtk_actionable_get_action_target_value ()">gtk_actionable_get_action_target_value</a> <span class="c_punctuation">()</span>
@ -105,13 +105,13 @@
<tbody>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkActionable.html#GtkActionable--action-name" title="The “action-name” property">action-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *</td>
<span class="type">GVariant</span> *</td>
<td class="property_name"><a class="link" href="GtkActionable.html#GtkActionable--action-target" title="The “action-target” property">action-target</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -139,7 +139,7 @@
</div>
<div class="refsect1">
<a name="GtkActionable.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="/home/mclasen/gnome/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
<pre class="screen"> GInterface
<span class="lineart">╰──</span> GtkActionable
</pre>
</div>
@ -153,11 +153,11 @@ GtkActionable requires
<a name="GtkActionable.implementations"></a><h2>Known Implementations</h2>
<p>
GtkActionable is implemented by
<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>, <a class="link" href="GtkCheckButton.html" title="GtkCheckButton">GtkCheckButton</a>, <a class="link" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">GtkCheckMenuItem</a>, <a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a>, <a class="link" href="GtkFontButton.html" title="GtkFontButton">GtkFontButton</a>, <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem">GtkImageMenuItem</a>, <a class="link" href="GtkLinkButton.html" title="GtkLinkButton">GtkLinkButton</a>, <a class="link" href="GtkLockButton.html" title="GtkLockButton">GtkLockButton</a>, <a class="link" href="GtkMenuButton.html" title="GtkMenuButton">GtkMenuButton</a>, <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>, <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>, <a class="link" href="GtkModelButton.html" title="GtkModelButton">GtkModelButton</a>, <a class="link" href="GtkRadioButton.html" title="GtkRadioButton">GtkRadioButton</a>, <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>, <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton">GtkRadioToolButton</a>, <a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a>, <a class="link" href="GtkSeparatorMenuItem.html" title="GtkSeparatorMenuItem">GtkSeparatorMenuItem</a>, <a class="link" href="GtkSwitch.html" title="GtkSwitch">GtkSwitch</a>, <a class="link" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">GtkTearoffMenuItem</a>, <a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a>, <a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>, <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> and <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>.</p>
<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>, <a class="link" href="GtkCheckButton.html" title="GtkCheckButton">GtkCheckButton</a>, <a class="link" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">GtkCheckMenuItem</a>, <a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a>, <a class="link" href="GtkFontButton.html" title="GtkFontButton">GtkFontButton</a>, <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem">GtkImageMenuItem</a>, <a class="link" href="GtkLinkButton.html" title="GtkLinkButton">GtkLinkButton</a>, <a class="link" href="GtkListBox.html#GtkListBoxRow">GtkListBoxRow</a>, <a class="link" href="GtkLockButton.html" title="GtkLockButton">GtkLockButton</a>, <a class="link" href="GtkMenuButton.html" title="GtkMenuButton">GtkMenuButton</a>, <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>, <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>, <a class="link" href="GtkModelButton.html" title="GtkModelButton">GtkModelButton</a>, <a class="link" href="GtkRadioButton.html" title="GtkRadioButton">GtkRadioButton</a>, <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>, <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton">GtkRadioToolButton</a>, <a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a>, <a class="link" href="GtkSeparatorMenuItem.html" title="GtkSeparatorMenuItem">GtkSeparatorMenuItem</a>, <a class="link" href="GtkSwitch.html" title="GtkSwitch">GtkSwitch</a>, <a class="link" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">GtkTearoffMenuItem</a>, <a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a>, <a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>, <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> and <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>.</p>
</div>
<div class="refsect1">
<a name="GtkActionable.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
<pre class="synopsis">#include &lt;gtk/gtkunixprint.h&gt;
</pre>
</div>
<div class="refsect1">
@ -177,7 +177,7 @@ or <a class="link" href="GtkApplication.html" title="GtkApplication"><span class
<a name="GtkActionable.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-actionable-get-action-name"></a><h3>gtk_actionable_get_action_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_actionable_get_action_name (<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>);</pre>
<p>Gets the action name for <em class="parameter"><code>actionable</code></em>
.</p>
@ -199,7 +199,7 @@ gtk_actionable_get_action_name (<em class="parameter"><code><a class="link" href
</div>
<div class="refsect3">
<a name="gtk-actionable-get-action-name.returns"></a><h4>Returns</h4>
<p> the action name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is set. </p>
<p>the action name, or <code class="literal">NULL</code> if none is set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
@ -209,16 +209,16 @@ gtk_actionable_get_action_name (<em class="parameter"><code><a class="link" href
<a name="gtk-actionable-set-action-name"></a><h3>gtk_actionable_set_action_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_actionable_set_action_name (<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action_name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *action_name</code></em>);</pre>
<p>Specifies the name of the action with which this widget should be
associated. If <em class="parameter"><code>action_name</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the widget will be
is <code class="literal">NULL</code> then the widget will be
unassociated from any previous action.</p>
<p>Usually this function is used when the widget is located (or will be
located) within the hierarchy of a <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow"><span class="type">GtkApplicationWindow</span></a>.</p>
<p>Names are of the form “win.save” or “app.quit” for actions on the
containing <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow"><span class="type">GtkApplicationWindow</span></a> or its associated <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>,
respectively. This is the same form used for actions in the <a href="../gio/GMenu.html#GMenu-struct"><span class="type">GMenu</span></a>
respectively. This is the same form used for actions in the <span class="type">GMenu</span>
associated with the window.</p>
<div class="refsect3">
<a name="gtk-actionable-set-action-name.parameters"></a><h4>Parameters</h4>
@ -236,7 +236,7 @@ associated with the window.</p>
</tr>
<tr>
<td class="parameter_name"><p>action_name</p></td>
<td class="parameter_description"><p> an action name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>an action name, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@ -247,7 +247,7 @@ associated with the window.</p>
<hr>
<div class="refsect2">
<a name="gtk-actionable-get-action-target-value"></a><h3>gtk_actionable_get_action_target_value ()</h3>
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
<pre class="programlisting"><span class="returnvalue">GVariant</span> *
gtk_actionable_get_action_target_value
(<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>);</pre>
<p>Gets the current target value of <em class="parameter"><code>actionable</code></em>
@ -270,7 +270,7 @@ gtk_actionable_get_action_target_value
</div>
<div class="refsect3">
<a name="gtk-actionable-get-action-target-value.returns"></a><h4>Returns</h4>
<p> the current target value. </p>
<p>the current target value. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
@ -281,16 +281,16 @@ gtk_actionable_get_action_target_value
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_actionable_set_action_target_value
(<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>,
<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *target_value</code></em>);</pre>
<em class="parameter"><code><span class="type">GVariant</span> *target_value</code></em>);</pre>
<p>Sets the target value of an actionable widget.</p>
<p>If <em class="parameter"><code>target_value</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the target value is unset.</p>
is <code class="literal">NULL</code> then the target value is unset.</p>
<p>The target value has two purposes. First, it is used as the
parameter to activation of the action associated with the
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widget. Second, it is used to determine if the widget
should be rendered as “active” — the widget is active if the state
is equal to the given target.</p>
<p>Consider the example of associating a set of buttons with a <a href="../gio/GAction.html#GAction-struct"><span class="type">GAction</span></a>
<p>Consider the example of associating a set of buttons with a <span class="type">GAction</span>
with string state in a typical “radio button” situation. Each button
will be associated with the same action, but with a different target
value for that action. Clicking on a particular button will activate
@ -315,7 +315,7 @@ rendered inactive).</p>
</tr>
<tr>
<td class="parameter_name"><p>target_value</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to set as the target 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 <span class="type">GVariant</span> to set as the target value, or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -328,10 +328,10 @@ rendered inactive).</p>
<a name="gtk-actionable-set-action-target"></a><h3>gtk_actionable_set_action_target ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_actionable_set_action_target (<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format_string</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *format_string</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Sets the target of an actionable widget.</p>
<p>This is a convenience function that calls <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a> for
<p>This is a convenience function that calls <code class="function">g_variant_new()</code> for
<em class="parameter"><code>format_string</code></em>
and uses the result to call
<a class="link" href="GtkActionable.html#gtk-actionable-set-action-target-value" title="gtk_actionable_set_action_target_value ()"><code class="function">gtk_actionable_set_action_target_value()</code></a>.</p>
@ -374,12 +374,12 @@ name at the same time, you can use
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_actionable_set_detailed_action_name
(<em class="parameter"><code><a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> *actionable</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_action_name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *detailed_action_name</code></em>);</pre>
<p>Sets the action-name and associated string target value of an
actionable widget.</p>
<p><em class="parameter"><code>detailed_action_name</code></em>
is a string in the format accepted by
<a href="../gio/GAction.html#g-action-parse-detailed-name"><code class="function">g_action_parse_detailed_name()</code></a>.</p>
<code class="function">g_action_parse_detailed_name()</code>.</p>
<p>(Note that prior to version 3.22.25,
this function is only usable for actions with a simple "s" target, and
<em class="parameter"><code>detailed_action_name</code></em>
@ -469,7 +469,7 @@ as the target.)</p>
<a name="GtkActionable.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkActionable--action-name"></a><h3>The <code class="literal">“action-name”</code> property</h3>
<pre class="programlisting"> “action-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “action-name” <span class="type">gchar</span> *</pre>
<p>The name of the associated action, like 'app.quit'.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -477,7 +477,7 @@ as the target.)</p>
<hr>
<div class="refsect2">
<a name="GtkActionable--action-target"></a><h3>The <code class="literal">“action-target”</code> property</h3>
<pre class="programlisting"> “action-target” <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *</pre>
<pre class="programlisting"> “action-target” <span class="type">GVariant</span> *</pre>
<p>The parameter for action invocations.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: GVariant&lt;*&gt;</p>
@ -486,6 +486,6 @@ as the target.)</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>