New upstream version 3.24.14

This commit is contained in:
Simon McVittie
2020-02-29 14:17:40 +00:00
543 changed files with 330694 additions and 808714 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="Gestures.html" title="Gestures and event handling">
<link rel="prev" href="GtkGestureStylus.html" title="GtkGestureStylus">
<link rel="next" href="DeprecatedObjects.html" title="Deprecated">
<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">
@ -37,8 +37,8 @@
<a name="GtkPadController.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>
@ -81,13 +81,13 @@
<td class="property_type">
<span class="type">GActionGroup</span> *</td>
<td class="property_name"><a class="link" href="GtkPadController.html#GtkPadController--action-group" title="The “action-group” property">action-group</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkDevice</span> *</td>
<td class="property_name"><a class="link" href="GtkPadController.html#GtkPadController--pad" title="The “pad” property">pad</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
</tbody>
</table></div>
@ -96,21 +96,21 @@
<a name="GtkPadController.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"> </td>
<td class="function_name"><a class="link" href="GtkPadController.html#GtkPadController-struct" title="GtkPadController">GtkPadController</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadController-struct">GtkPadController</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkPadController.html#GtkPadActionType" title="enum GtkPadActionType">GtkPadActionType</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionType">GtkPadActionType</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkPadController.html#GtkPadActionEntry" title="struct GtkPadActionEntry">GtkPadActionEntry</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionEntry">GtkPadActionEntry</a></td>
</tr>
</tbody>
</table></div>
@ -141,10 +141,10 @@ meaning.</p>
elements have one current mode, which may determine the final action
being triggered. Pad devices often divide buttons and sensors into groups,
all elements in a group share the same current mode, but different groups
may have different modes. See <code class="function">gdk_device_pad_get_n_groups()</code> and
<code class="function">gdk_device_pad_get_group_n_modes()</code>.</p>
may have different modes. See <a href="https://developer.gnome.org/gdk4/GdkDevicePad.html#gdk-device-pad-get-n-groups"><code class="function">gdk_device_pad_get_n_groups()</code></a> and
<a href="https://developer.gnome.org/gdk4/GdkDevicePad.html#gdk-device-pad-get-group-n-modes"><code class="function">gdk_device_pad_get_group_n_modes()</code></a>.</p>
<p>Each of the actions that a given button/strip/ring performs for a given
mode is defined by <a class="link" href="GtkPadController.html#GtkPadActionEntry" title="struct GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a>, it contains an action name that
mode is defined by <a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a>, it contains an action name that
will be looked up in the given <span class="type">GActionGroup</span> and activated whenever the
specified input element and mode are triggered.</p>
<p>A simple example of <a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> usage, assigning button 1 in all
@ -165,18 +165,18 @@ modes and pad devices to an "invert-selection" action:</p>
10
11
12</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkPadActionEntry</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">pad_actions</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> <a href="GtkPadController.html#GTK-PAD-ACTION-BUTTON:CAPS">GTK_PAD_ACTION_BUTTON</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Invert selection"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"pad-actions.invert-selection"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
<span class="normal"> </span>
<span class="cbracket">}</span><span class="symbol">;</span>
<td class="listing_code"><pre class="programlisting"><span class="n">GtkPadActionEntry</span> <span class="o">*</span><span class="n">pad_actions</span><span class="p">[]</span> <span class="o">=</span> <span class="p">{</span>
<span class="p">{</span> <span class="n">GTK_PAD_ACTION_BUTTON</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="s">&quot;Invert selection&quot;</span><span class="p">,</span> <span class="s">&quot;pad-actions.invert-selection&quot;</span> <span class="p">},</span>
<span class="err"></span>
<span class="p">};</span>
<span class="normal"></span>
<span class="normal">action_group </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_simple_action_group_new</span><span class="normal"> </span><span class="symbol">();</span>
<span class="normal">action </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_simple_action_new</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"pad-actions.invert-selection"</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
<span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">action</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"activate"</span><span class="symbol">,</span><span class="normal"> on_invert_selection_activated</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
<span class="function">g_action_map_add_action</span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_ACTION_MAP</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">action_group</span><span class="symbol">),</span><span class="normal"> action</span><span class="symbol">);</span>
<span class="normal"></span>
<span class="normal">pad_controller </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkPadController.html#gtk-pad-controller-new">gtk_pad_controller_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> action_group</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
<span class="err"></span>
<span class="n">action_group</span> <span class="o">=</span> <span class="n">g_simple_action_group_new</span> <span class="p">();</span>
<span class="n">action</span> <span class="o">=</span> <span class="n">g_simple_action_new</span> <span class="p">(</span><span class="s">&quot;pad-actions.invert-selection&quot;</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span>
<span class="n">g_signal_connect</span> <span class="p">(</span><span class="n">action</span><span class="p">,</span> <span class="s">&quot;activate&quot;</span><span class="p">,</span> <span class="n">on_invert_selection_activated</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span>
<span class="n">g_action_map_add_action</span> <span class="p">(</span><span class="n">G_ACTION_MAP</span> <span class="p">(</span><span class="n">action_group</span><span class="p">),</span> <span class="n">action</span><span class="p">);</span>
<span class="err"></span>
<span class="n">pad_controller</span> <span class="o">=</span> <span class="n">gtk_pad_controller_new</span> <span class="p">(</span><span class="n">window</span><span class="p">,</span> <span class="n">action_group</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span></pre></td>
</tr>
</tbody>
</table>
@ -244,11 +244,11 @@ events to actions, use <a class="link" href="GtkPadController.html#gtk-pad-contr
<a name="gtk-pad-controller-set-action-entries"></a><h3>gtk_pad_controller_set_action_entries ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_pad_controller_set_action_entries (<em class="parameter"><code><a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> *controller</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkPadController.html#GtkPadActionEntry" title="struct GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a> *entries</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a> *entries</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_entries</code></em>);</pre>
<p>This is a convenience function to add a group of action entries on
<em class="parameter"><code>controller</code></em>
. See <a class="link" href="GtkPadController.html#GtkPadActionEntry" title="struct GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a> and <a class="link" href="GtkPadController.html#gtk-pad-controller-set-action" title="gtk_pad_controller_set_action ()"><code class="function">gtk_pad_controller_set_action()</code></a>.</p>
. See <a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a> and <a class="link" href="GtkPadController.html#gtk-pad-controller-set-action" title="gtk_pad_controller_set_action ()"><code class="function">gtk_pad_controller_set_action()</code></a>.</p>
<div class="refsect3">
<a name="gtk-pad-controller-set-action-entries.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -285,7 +285,7 @@ gtk_pad_controller_set_action_entries (<em class="parameter"><code><a class="lin
<a name="gtk-pad-controller-set-action"></a><h3>gtk_pad_controller_set_action ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_pad_controller_set_action (<em class="parameter"><code><a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> *controller</code></em>,
<em class="parameter"><code><a class="link" href="GtkPadController.html#GtkPadActionType" title="enum GtkPadActionType"><span class="type">GtkPadActionType</span></a> type</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkPadController.html#GtkPadActionType"><span class="type">GtkPadActionType</span></a> type</code></em>,
<em class="parameter"><code><span class="type">gint</span> index</code></em>,
<em class="parameter"><code><span class="type">gint</span> mode</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
@ -348,116 +348,21 @@ be deemed user-visible.</p></td>
</div>
</div>
<div class="refsect1">
<a name="GtkPadController.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkPadController-struct"></a><h3>GtkPadController</h3>
<pre class="programlisting">typedef struct _GtkPadController GtkPadController;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkPadActionType"></a><h3>enum GtkPadActionType</h3>
<p>The type of a pad action.</p>
<div class="refsect3">
<a name="GtkPadActionType.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-PAD-ACTION-BUTTON:CAPS"></a>GTK_PAD_ACTION_BUTTON</p></td>
<td class="enum_member_description">
<p>Action is triggered by a pad button</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-PAD-ACTION-RING:CAPS"></a>GTK_PAD_ACTION_RING</p></td>
<td class="enum_member_description">
<p>Action is triggered by a pad ring</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-PAD-ACTION-STRIP:CAPS"></a>GTK_PAD_ACTION_STRIP</p></td>
<td class="enum_member_description">
<p>Action is triggered by a pad strip</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkPadActionEntry"></a><h3>struct GtkPadActionEntry</h3>
<pre class="programlisting">struct GtkPadActionEntry {
GtkPadActionType type;
gint index;
gint mode;
gchar *label;
gchar *action_name;
};
</pre>
<p>Struct defining a pad action entry.</p>
<div class="refsect3">
<a name="GtkPadActionEntry.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><a class="link" href="GtkPadController.html#GtkPadActionType" title="enum GtkPadActionType"><span class="type">GtkPadActionType</span></a> <em class="structfield"><code><a name="GtkPadActionEntry.type"></a>type</code></em>;</p></td>
<td class="struct_member_description"><p>the type of pad feature that will trigger this action entry.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GtkPadActionEntry.index"></a>index</code></em>;</p></td>
<td class="struct_member_description"><p>the 0-indexed button/ring/strip number that will trigger this action
entry.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GtkPadActionEntry.mode"></a>mode</code></em>;</p></td>
<td class="struct_member_description"><p>the mode that will trigger this action entry, or -1 for all modes.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkPadActionEntry.label"></a>label</code></em>;</p></td>
<td class="struct_member_description"><p>Human readable description of this action entry, this string should
be deemed user-visible.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkPadActionEntry.action-name"></a>action_name</code></em>;</p></td>
<td class="struct_member_description"><p>action name that will be activated in the <span class="type">GActionGroup</span>.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkPadController.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkPadController--action-group"></a><h3>The <code class="literal">“action-group”</code> property</h3>
<pre class="programlisting"> “action-group” <span class="type">GActionGroup</span> *</pre>
<p>Action group to launch actions from.</p>
<p>Flags: Read / Write / Construct Only</p>
<p>Owner: GtkPadController</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkPadController--pad"></a><h3>The <code class="literal">“pad”</code> property</h3>
<pre class="programlisting"> “pad” <span class="type">GdkDevice</span> *</pre>
<p>Pad device to control.</p>
<p>Flags: Read / Write / Construct Only</p>
<p>Owner: GtkPadController</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
</div>
<div class="refsect1">
@ -466,6 +371,6 @@ be deemed user-visible.</p></td>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.29</div>
<hr>Generated by GTK-Doc V1.32.1</div>
</body>
</html>