callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.8

Browse Source
This commit is contained in:
Iain Lane
2019-04-11 09:41:47 +01:00
parent 1f6000bb1a 5428379fad
commit 2c2e749fa0
549 changed files with 776552 additions and 386298 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/reference/gtk/html/GtkPadController.html
View File

@ -85,7 +85,7 @@
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *</td>
<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>
</tr>
@ -117,14 +117,14 @@
</div>
<div class="refsect1">
<a name="GtkPadController.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> <a class="link" href="GtkEventController.html" title="GtkEventController">GtkEventController</a>
<span class="lineart">╰──</span> GtkPadController
</pre>
</div>
<div class="refsect1">
<a name="GtkPadController.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtkunixprint.h&gt;
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
@ -137,12 +137,12 @@ perform no action, this event controller is provided to map those to
<span class="type">GAction</span> objects, thus letting the application give those a more semantic
meaning.</p>
<p>Buttons and sensors are not constrained to triggering a single action, some
<a href="https://developer.gnome.org/gdk4/GdkDevice.html#GDK-SOURCE-TABLET-PAD:CAPS"><code class="literal">GDK_SOURCE_TABLET_PAD</code></a> devices feature multiple "modes", all these input
<code class="literal">GDK_SOURCE_TABLET_PAD</code> devices feature multiple "modes", all these input
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 <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>
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>
<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
will be looked up in the given <span class="type">GActionGroup</span> and activated whenever the
@ -172,11 +172,11 @@ modes and pad devices to an "invert-selection" action:</p>
<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"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
<span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></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"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></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"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
<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>
</tr>
</tbody>
</table>
@ -184,8 +184,8 @@ modes and pad devices to an "invert-selection" action:</p>
<p></p>
<p>The actions belonging to rings/strips will be activated with a parameter
of type <a href="https://developer.gnome.org/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-DOUBLE:CAPS"><code class="literal">G_VARIANT_TYPE_DOUBLE</code></a> bearing the value of the given axis, it
is required that those are made stateful and accepting this <a href="https://developer.gnome.org/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>.</p>
of type <code class="literal">G_VARIANT_TYPE_DOUBLE</code> bearing the value of the given axis, it
is required that those are made stateful and accepting this <span class="type">GVariantType</span>.</p>
</div>
<div class="refsect1">
<a name="GtkPadController.functions_details"></a><h2>Functions</h2>
@ -194,12 +194,12 @@ is required that those are made stateful and accepting this <a href="https://dev
<pre class="programlisting"><a class="link" href="GtkPadController.html" title="GtkPadController"><span class="returnvalue">GtkPadController</span></a> *
gtk_pad_controller_new (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GActionGroup</span> *group</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *pad</code></em>);</pre>
<em class="parameter"><code><span class="type">GdkDevice</span> *pad</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> that will associate events from <em class="parameter"><code>pad</code></em>
to
actions. A <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pad may be provided so the controller manages all pad devices
generically, it is discouraged to mix <a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> objects with <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
and non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <em class="parameter"><code>pad</code></em>
actions. A <code class="literal">NULL</code> pad may be provided so the controller manages all pad devices
generically, it is discouraged to mix <a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> objects with <code class="literal">NULL</code>
and non-<code class="literal">NULL</code> <em class="parameter"><code>pad</code></em>
argument on the same <em class="parameter"><code>window</code></em>
, as execution order is not
guaranteed.</p>
@ -227,7 +227,7 @@ events to actions, use <a class="link" href="GtkPadController.html#gtk-pad-contr
</tr>
<tr>
<td class="parameter_name"><p>pad</p></td>
<td class="parameter_description"><p>A <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GDK-SOURCE-TABLET-PAD:CAPS"><code class="literal">GDK_SOURCE_TABLET_PAD</code></a> device, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to handle all pads. </p></td>
<td class="parameter_description"><p>A <code class="literal">GDK_SOURCE_TABLET_PAD</code> device, or <code class="literal">NULL</code> to handle all pads. </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>
@ -245,7 +245,7 @@ events to actions, use <a class="link" href="GtkPadController.html#gtk-pad-contr
<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><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_entries</code></em>);</pre>
<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>
@ -286,10 +286,10 @@ gtk_pad_controller_set_action_entries (<em class="parameter"><code><a class="lin
<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/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action_name</code></em>);</pre>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *action_name</code></em>);</pre>
<p>Adds an individual action to <em class="parameter"><code>controller</code></em>
. This action will only be activated
if the given button/ring/strip number in <em class="parameter"><code>index</code></em>
@ -418,24 +418,24 @@ be deemed user-visible.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GtkPadActionEntry.index"></a>index</code></em>;</p></td>
<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><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GtkPadActionEntry.mode"></a>mode</code></em>;</p></td>
<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><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkPadActionEntry.label"></a>label</code></em>;</p></td>
<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><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkPadActionEntry.action-name"></a>action_name</code></em>;</p></td>
<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>
@ -455,14 +455,14 @@ be deemed user-visible.</p></td>
<hr>
<div class="refsect2">
<a name="GtkPadController--pad"></a><h3>The <code class="literal">“pad”</code> property</h3>
<pre class="programlisting"> “pad” <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *</pre>
<pre class="programlisting"> “pad” <span class="type">GdkDevice</span> *</pre>
<p>Pad device to control.</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
</div>
<div class="refsect1">
<a name="GtkPadController.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a>, <a href="https://developer.gnome.org/gdk4/GdkDevicePad.html#GdkDevicePad-struct"><span class="type">GdkDevicePad</span></a></p>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a>, <span class="type">GdkDevicePad</span></p>
</div>
</div>
<div class="footer">