New upstream version 3.24.14
This commit is contained in:
@ -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">"Invert selection"</span><span class="p">,</span> <span class="s">"pad-actions.invert-selection"</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">"pad-actions.invert-selection"</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">"activate"</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>
|
Reference in New Issue
Block a user