~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Input-Devices.html

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="reference.html" title="API Reference">
9
9
<link rel="prev" href="gdk-Input.html" title="Input">
10
10
<link rel="next" href="gdk-Pango-Interaction.html" title="Pango Interaction">
11
 
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
46
46
struct              <a class="link" href="gdk-Input-Devices.html#GdkDeviceKey" title="struct GdkDeviceKey">GdkDeviceKey</a>;
47
47
struct              <a class="link" href="gdk-Input-Devices.html#GdkDeviceAxis" title="struct GdkDeviceAxis">GdkDeviceAxis</a>;
48
48
enum                <a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse">GdkAxisUse</a>;
49
 
<span class="returnvalue">GList</span> *             <a class="link" href="gdk-Input-Devices.html#gdk-devices-list" title="gdk_devices_list ()">gdk_devices_list</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
50
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="gdk-Input-Devices.html#gdk-device-get-name" title="gdk_device_get_name ()">gdk_device_get_name</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
 
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gdk-Input-Devices.html#gdk-devices-list" title="gdk_devices_list ()">gdk_devices_list</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
 
50
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *          <a class="link" href="gdk-Input-Devices.html#gdk-device-get-name" title="gdk_device_get_name ()">gdk_device_get_name</a>              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
51
51
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-set-source" title="gdk_device_set_source ()">gdk_device_set_source</a>               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
52
52
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>);
53
53
<a class="link" href="gdk-Input-Devices.html#GdkInputSource" title="enum GdkInputSource"><span class="returnvalue">GdkInputSource</span></a>      <a class="link" href="gdk-Input-Devices.html#gdk-device-get-source" title="gdk_device_get_source ()">gdk_device_get_source</a>               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
54
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gdk-Input-Devices.html#gdk-device-set-mode" title="gdk_device_set_mode ()">gdk_device_set_mode</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Input-Devices.html#gdk-device-set-mode" title="gdk_device_set_mode ()">gdk_device_set_mode</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
55
55
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkInputMode" title="enum GdkInputMode"><span class="type">GdkInputMode</span></a> mode</code></em>);
56
56
<a class="link" href="gdk-Input-Devices.html#GdkInputMode" title="enum GdkInputMode"><span class="returnvalue">GdkInputMode</span></a>        <a class="link" href="gdk-Input-Devices.html#gdk-device-get-mode" title="gdk_device_get_mode ()">gdk_device_get_mode</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
57
57
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-set-key" title="gdk_device_set_key ()">gdk_device_set_key</a>                  (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
58
 
                                                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>,
59
 
                                                         <em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
 
58
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
 
59
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>,
60
60
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-get-key" title="gdk_device_get_key ()">gdk_device_get_key</a>                  (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
62
 
                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>,
63
 
                                                         <em class="parameter"><code><span class="type">guint</span> *keyval</code></em>,
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *keyval</code></em>,
64
64
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *modifiers</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-set-axis-use" title="gdk_device_set_axis_use ()">gdk_device_set_axis_use</a>             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
66
 
                                                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>,
 
66
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
67
67
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="type">GdkAxisUse</span></a> use</code></em>);
68
68
<a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="returnvalue">GdkAxisUse</span></a>          <a class="link" href="gdk-Input-Devices.html#gdk-device-get-axis-use" title="gdk_device_get_axis_use ()">gdk_device_get_axis_use</a>             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
69
 
                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>);
 
69
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
70
70
<a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="returnvalue">GdkDevice</span></a> *         <a class="link" href="gdk-Input-Devices.html#gdk-device-get-core-pointer" title="gdk_device_get_core_pointer ()">gdk_device_get_core_pointer</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
71
71
 
72
72
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-get-state" title="gdk_device_get_state ()">gdk_device_get_state</a>                (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
73
73
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
74
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *axes</code></em>,
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *axes</code></em>,
75
75
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);
76
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gdk-Input-Devices.html#gdk-device-get-history" title="gdk_device_get_history ()">gdk_device_get_history</a>              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
76
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Input-Devices.html#gdk-device-get-history" title="gdk_device_get_history ()">gdk_device_get_history</a>              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
77
77
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
78
 
                                                         <em class="parameter"><code><span class="type">guint32</span> start</code></em>,
79
 
                                                         <em class="parameter"><code><span class="type">guint32</span> stop</code></em>,
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> start</code></em>,
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> stop</code></em>,
80
80
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a> ***events</code></em>,
81
 
                                                         <em class="parameter"><code><span class="type">gint</span> *n_events</code></em>);
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_events</code></em>);
82
82
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-free-history" title="gdk_device_free_history ()">gdk_device_free_history</a>             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a> **events</code></em>,
83
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_events</code></em>);
 
83
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_events</code></em>);
84
84
struct              <a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord">GdkTimeCoord</a>;
85
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gdk-Input-Devices.html#gdk-device-get-axis" title="gdk_device_get_axis ()">gdk_device_get_axis</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
86
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *axes</code></em>,
 
85
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Input-Devices.html#gdk-device-get-axis" title="gdk_device_get_axis ()">gdk_device_get_axis</a>                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
86
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *axes</code></em>,
87
87
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="type">GdkAxisUse</span></a> use</code></em>,
88
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *value</code></em>);
89
 
<span class="returnvalue">gint</span>                <a class="link" href="gdk-Input-Devices.html#gdk-device-get-n-axes" title="gdk_device_get_n_axes ()">gdk_device_get_n_axes</a>               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
 
88
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);
 
89
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Input-Devices.html#gdk-device-get-n-axes" title="gdk_device_get_n_axes ()">gdk_device_get_n_axes</a>               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);
90
90
 
91
91
<span class="returnvalue">void</span>                <a class="link" href="gdk-Input-Devices.html#gdk-input-set-extension-events" title="gdk_input_set_extension_events ()">gdk_input_set_extension_events</a>      (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
92
 
                                                         <em class="parameter"><code><span class="type">gint</span> mask</code></em>,
 
92
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> mask</code></em>,
93
93
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkExtensionMode" title="enum GdkExtensionMode"><span class="type">GdkExtensionMode</span></a> mode</code></em>);
94
94
enum                <a class="link" href="gdk-Input-Devices.html#GdkExtensionMode" title="enum GdkExtensionMode">GdkExtensionMode</a>;
95
95
</pre>
109
109
Because handling extended input devices may involve considerable
110
110
overhead, they need to be turned on for each <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>
111
111
individually using <a class="link" href="gdk-Input-Devices.html#gdk-input-set-extension-events" title="gdk_input_set_extension_events ()"><code class="function">gdk_input_set_extension_events()</code></a>.
112
 
(Or, more typically, for GtkWidgets, using <code class="function">gtk_widget_set_extension_events()</code>).
 
112
(Or, more typically, for GtkWidgets, using <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-set-extension-events"><code class="function">gtk_widget_set_extension_events()</code></a>).
113
113
As an additional complication, depending on the support from
114
114
the windowing system, its possible that a normal mouse
115
115
cursor will not be displayed for a particular extension
120
120
<a class="link" href="gdk-Input-Devices.html#gdk-input-set-extension-events" title="gdk_input_set_extension_events ()"><code class="function">gdk_input_set_extension_events()</code></a>. Otherwise, the application
121
121
must retrieve the device information using <a class="link" href="gdk-Input-Devices.html#gdk-devices-list" title="gdk_devices_list ()"><code class="function">gdk_devices_list()</code></a>,
122
122
check the <em class="structfield"><code>has_cursor</code></em> field, and,
123
 
if it is <code class="literal">FALSE</code>, draw a cursor itself when it receives
 
123
if it is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, draw a cursor itself when it receives
124
124
motion events.
125
125
</p>
126
126
<p>
200
200
<div class="variablelist"><table border="0">
201
201
<col align="left" valign="top">
202
202
<tbody><tr>
203
 
<td><p><span class="term"><span class="type">GObject</span> <em class="structfield"><code><a name="GdkDevice.parent-instance"></a>parent_instance</code></em>;</span></p></td>
 
203
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> <em class="structfield"><code><a name="GdkDevice.parent-instance"></a>parent_instance</code></em>;</span></p></td>
204
204
<td>the parent instance</td>
205
205
</tr></tbody>
206
206
</table></div>
303
303
<col align="left" valign="top">
304
304
<tbody>
305
305
<tr>
306
 
<td><p><span class="term"><span class="type">guint</span> <em class="structfield"><code><a name="GdkDeviceKey.keyval"></a>keyval</code></em>;</span></p></td>
 
306
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GdkDeviceKey.keyval"></a>keyval</code></em>;</span></p></td>
307
307
<td>the keyval to generate when the macro button is pressed.
308
308
If this is 0, no keypress will be generated.</td>
309
309
</tr>
335
335
<td>specifies how the axis is used.</td>
336
336
</tr>
337
337
<tr>
338
 
<td><p><span class="term"><span class="type">gdouble</span> <em class="structfield"><code><a name="GdkDeviceAxis.min"></a>min</code></em>;</span></p></td>
 
338
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="GdkDeviceAxis.min"></a>min</code></em>;</span></p></td>
339
339
<td>the minimal value that will be reported by this axis.</td>
340
340
</tr>
341
341
<tr>
342
 
<td><p><span class="term"><span class="type">gdouble</span> <em class="structfield"><code><a name="GdkDeviceAxis.max"></a>max</code></em>;</span></p></td>
 
342
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="GdkDeviceAxis.max"></a>max</code></em>;</span></p></td>
343
343
<td>the maximal value that will be reported by this axis.</td>
344
344
</tr>
345
345
</tbody>
414
414
<hr>
415
415
<div class="refsect2">
416
416
<a name="gdk-devices-list"></a><h3>gdk_devices_list ()</h3>
417
 
<pre class="programlisting"><span class="returnvalue">GList</span> *             gdk_devices_list                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
417
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gdk_devices_list                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
418
418
<p>
419
419
Returns the list of available input devices for the default display.
420
420
The list is statically allocated and should not be freed.
431
431
<hr>
432
432
<div class="refsect2">
433
433
<a name="gdk-device-get-name"></a><h3>gdk_device_get_name ()</h3>
434
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gdk_device_get_name                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
 
434
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *          gdk_device_get_name              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
435
435
<p>
436
436
Determines the name of the device.
437
437
</p>
500
500
<hr>
501
501
<div class="refsect2">
502
502
<a name="gdk-device-set-mode"></a><h3>gdk_device_set_mode ()</h3>
503
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_device_set_mode                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
503
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_device_set_mode                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
504
504
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkInputMode" title="enum GdkInputMode"><span class="type">GdkInputMode</span></a> mode</code></em>);</pre>
505
505
<p>
506
506
Sets a the mode of an input device. The mode controls if the
521
521
<tr>
522
522
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
523
523
<td>
524
 
<code class="literal">TRUE</code> if the mode was successfully changed.</td>
 
524
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mode was successfully changed.</td>
525
525
</tr>
526
526
</tbody>
527
527
</table></div>
554
554
<div class="refsect2">
555
555
<a name="gdk-device-set-key"></a><h3>gdk_device_set_key ()</h3>
556
556
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_device_set_key                  (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
557
 
                                                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>,
558
 
                                                         <em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
 
557
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
 
558
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>,
559
559
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>);</pre>
560
560
<p>
561
561
Specifies the X key event to generate when a macro button of a device
587
587
<div class="refsect2">
588
588
<a name="gdk-device-get-key"></a><h3>gdk_device_get_key ()</h3>
589
589
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_device_get_key                  (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
590
 
                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>,
591
 
                                                         <em class="parameter"><code><span class="type">guint</span> *keyval</code></em>,
 
590
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
 
591
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *keyval</code></em>,
592
592
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *modifiers</code></em>);</pre>
593
593
<p>
594
594
If <em class="parameter"><code>index</code></em> has a valid keyval, this function will
621
621
<div class="refsect2">
622
622
<a name="gdk-device-set-axis-use"></a><h3>gdk_device_set_axis_use ()</h3>
623
623
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_device_set_axis_use             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
624
 
                                                         <em class="parameter"><code><span class="type">guint</span> index_</code></em>,
 
624
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
625
625
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="type">GdkAxisUse</span></a> use</code></em>);</pre>
626
626
<p>
627
627
Specifies how an axis of a device is used.
648
648
<div class="refsect2">
649
649
<a name="gdk-device-get-axis-use"></a><h3>gdk_device_get_axis_use ()</h3>
650
650
<pre class="programlisting"><a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="returnvalue">GdkAxisUse</span></a>          gdk_device_get_axis_use             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
651
 
                                                         <em class="parameter"><code><span class="type">guint</span> index</code></em>);</pre>
 
651
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
652
652
<p>
653
653
Returns the axis use for <em class="parameter"><code>index</code></em>.
654
654
</p>
692
692
<a name="gdk-device-get-state"></a><h3>gdk_device_get_state ()</h3>
693
693
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_device_get_state                (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
694
694
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
695
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *axes</code></em>,
 
695
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *axes</code></em>,
696
696
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre>
697
697
<p>
698
698
Gets the current state of a device.
711
711
<tr>
712
712
<td><p><span class="term"><em class="parameter"><code>axes</code></em> :</span></p></td>
713
713
<td>an array of doubles to store the values of the axes of <em class="parameter"><code>device</code></em> in,
714
 
or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
 
714
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
715
715
</tr>
716
716
<tr>
717
717
<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
718
 
<td>location to store the modifiers, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
 
718
<td>location to store the modifiers, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
719
719
</tr>
720
720
</tbody>
721
721
</table></div>
723
723
<hr>
724
724
<div class="refsect2">
725
725
<a name="gdk-device-get-history"></a><h3>gdk_device_get_history ()</h3>
726
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_device_get_history              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
726
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_device_get_history              (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
727
727
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
728
 
                                                         <em class="parameter"><code><span class="type">guint32</span> start</code></em>,
729
 
                                                         <em class="parameter"><code><span class="type">guint32</span> stop</code></em>,
 
728
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> start</code></em>,
 
729
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> stop</code></em>,
730
730
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a> ***events</code></em>,
731
 
                                                         <em class="parameter"><code><span class="type">gint</span> *n_events</code></em>);</pre>
 
731
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_events</code></em>);</pre>
732
732
<p>
733
733
Obtains the motion history for a device; given a starting and
734
734
ending timestamp, return all events in the motion history for
735
735
the device in the given range of time. Some windowing systems
736
 
do not support motion history, in which case, <code class="literal">FALSE</code> will
 
736
do not support motion history, in which case, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will
737
737
be returned. (This is not distinguishable from the case where
738
738
motion history is supported and no events were found.)
739
739
</p>
759
759
</tr>
760
760
<tr>
761
761
<td><p><span class="term"><em class="parameter"><code>events</code></em> :</span></p></td>
762
 
<td>location to store a newly-allocated array of <a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_events][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
762
<td>location to store a newly-allocated array of <a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_events][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
763
763
</td>
764
764
</tr>
765
765
<tr>
766
766
<td><p><span class="term"><em class="parameter"><code>n_events</code></em> :</span></p></td>
767
 
<td>location to store the length of <em class="parameter"><code>events</code></em>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
 
767
<td>location to store the length of <em class="parameter"><code>events</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
768
768
</td>
769
769
</tr>
770
770
<tr>
771
771
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
772
772
<td>
773
 
<code class="literal">TRUE</code> if the windowing system supports motion history and
 
773
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the windowing system supports motion history and
774
774
at least one event was found.</td>
775
775
</tr>
776
776
</tbody>
780
780
<div class="refsect2">
781
781
<a name="gdk-device-free-history"></a><h3>gdk_device_free_history ()</h3>
782
782
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_device_free_history             (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a> **events</code></em>,
783
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_events</code></em>);</pre>
 
783
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_events</code></em>);</pre>
784
784
<p>
785
785
Frees an array of <a class="link" href="gdk-Input-Devices.html#GdkTimeCoord" title="struct GdkTimeCoord"><span class="type">GdkTimeCoord</span></a> that was returned by <a class="link" href="gdk-Input-Devices.html#gdk-device-get-history" title="gdk_device_get_history ()"><code class="function">gdk_device_get_history()</code></a>.
786
786
</p>
818
818
<col align="left" valign="top">
819
819
<tbody>
820
820
<tr>
821
 
<td><p><span class="term"><span class="type">guint32</span> <em class="structfield"><code><a name="GdkTimeCoord.time"></a>time</code></em>;</span></p></td>
 
821
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkTimeCoord.time"></a>time</code></em>;</span></p></td>
822
822
<td>The timestamp for this event.</td>
823
823
</tr>
824
824
<tr>
825
 
<td><p><span class="term"><span class="type">gdouble</span> <em class="structfield"><code><a name="GdkTimeCoord.axes"></a>axes</code></em>[GDK_MAX_TIMECOORD_AXES];</span></p></td>
 
825
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="GdkTimeCoord.axes"></a>axes</code></em>[GDK_MAX_TIMECOORD_AXES];</span></p></td>
826
826
<td>the values of the device's axes.</td>
827
827
</tr>
828
828
</tbody>
831
831
<hr>
832
832
<div class="refsect2">
833
833
<a name="gdk-device-get-axis"></a><h3>gdk_device_get_axis ()</h3>
834
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_device_get_axis                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
835
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *axes</code></em>,
 
834
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_device_get_axis                 (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
 
835
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *axes</code></em>,
836
836
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkAxisUse" title="enum GdkAxisUse"><span class="type">GdkAxisUse</span></a> use</code></em>,
837
 
                                                         <em class="parameter"><code><span class="type">gdouble</span> *value</code></em>);</pre>
 
837
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);</pre>
838
838
<p>
839
839
Interprets an array of double as axis values for a given device,
840
840
and locates the value in the array for a given axis use.
862
862
<tr>
863
863
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
864
864
<td>
865
 
<code class="literal">TRUE</code> if the given axis use was found, otherwise <code class="literal">FALSE</code>
 
865
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the given axis use was found, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
866
866
</td>
867
867
</tr>
868
868
</tbody>
871
871
<hr>
872
872
<div class="refsect2">
873
873
<a name="gdk-device-get-n-axes"></a><h3>gdk_device_get_n_axes ()</h3>
874
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_device_get_n_axes               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
 
874
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_device_get_n_axes               (<em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkDevice" title="struct GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
875
875
<p>
876
876
Gets the number of axes of a device.
877
877
</p>
895
895
<div class="refsect2">
896
896
<a name="gdk-input-set-extension-events"></a><h3>gdk_input_set_extension_events ()</h3>
897
897
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_input_set_extension_events      (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
898
 
                                                         <em class="parameter"><code><span class="type">gint</span> mask</code></em>,
 
898
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> mask</code></em>,
899
899
                                                         <em class="parameter"><code><a class="link" href="gdk-Input-Devices.html#GdkExtensionMode" title="enum GdkExtensionMode"><span class="type">GdkExtensionMode</span></a> mode</code></em>);</pre>
900
900
<p>
901
901
Turns extension events on or off for a particular window,
959
959
</div>
960
960
<div class="footer">
961
961
<hr>
962
 
          Generated by GTK-Doc V1.17.1</div>
 
962
          Generated by GTK-Doc V1.17</div>
963
963
</body>
964
964
</html>
 
 
b'\\ No newline at end of file'