summaryrefslogtreecommitdiff
path: root/gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html
diff options
context:
space:
mode:
authorLeo Tenenbaum <pommicket@gmail.com>2018-08-20 21:12:06 -0400
committerLeo Tenenbaum <pommicket@gmail.com>2018-08-20 21:12:06 -0400
commit63e87c2d0c9d263f14c77b68f85c67d46ece82a9 (patch)
tree6260365cbf7d24f37d27669e8538227fcb72e243 /gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html
parenta4460f6d9453bbd7e584937686449cef3e19f052 (diff)
Removed gtk+ docsHEADmaster
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html')
-rw-r--r--gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html427
1 files changed, 0 insertions, 427 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html b/gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html
deleted file mode 100644
index a49bcc9..0000000
--- a/gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html
+++ /dev/null
@@ -1,427 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GdkDeviceManager</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="GDK 3 Reference Manual">
-<link rel="up" href="reference.html" title="API Reference">
-<link rel="prev" href="GdkScreen.html" title="GdkScreen">
-<link rel="next" href="GdkDevice.html" title="GdkDevice">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
-<link rel="stylesheet" href="style.css" type="text/css">
-</head>
-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GdkScreen.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GDK 3 Reference Manual</th>
-<td><a accesskey="n" href="GdkDevice.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GdkDeviceManager.synopsis" class="shortcut">Top</a>
-  | 
- <a href="#GdkDeviceManager.description" class="shortcut">Description</a>
-  | 
- <a href="#GdkDeviceManager.object-hierarchy" class="shortcut">Object Hierarchy</a>
-  | 
- <a href="#GdkDeviceManager.properties" class="shortcut">Properties</a>
-  | 
- <a href="#GdkDeviceManager.signals" class="shortcut">Signals</a>
-</td></tr>
-</table>
-<div class="refentry">
-<a name="GdkDeviceManager"></a><div class="titlepage"></div>
-<div class="refnamediv"><table width="100%"><tr>
-<td valign="top">
-<h2><span class="refentrytitle"><a name="GdkDeviceManager.top_of_page"></a>GdkDeviceManager</span></h2>
-<p>GdkDeviceManager — Functions for handling input devices</p>
-</td>
-<td valign="top" align="right"></td>
-</tr></table></div>
-<div class="refsynopsisdiv">
-<a name="GdkDeviceManager.synopsis"></a><h2>Synopsis</h2>
-<pre class="synopsis">
-#include &lt;gdk/gdk.h&gt;
-
- <a class="link" href="GdkDeviceManager.html#GdkDeviceManager-struct" title="GdkDeviceManager">GdkDeviceManager</a>;
-<span class="returnvalue">void</span> <a class="link" href="GdkDeviceManager.html#gdk-disable-multidevice" title="gdk_disable_multidevice ()">gdk_disable_multidevice</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
-<a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> * <a class="link" href="GdkDeviceManager.html#gdk-device-manager-get-display" title="gdk_device_manager_get_display ()">gdk_device_manager_get_display</a> (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>);
-<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="GdkDeviceManager.html#gdk-device-manager-list-devices" title="gdk_device_manager_list_devices ()">gdk_device_manager_list_devices</a> (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>,
- <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkDeviceType" title="enum GdkDeviceType"><span class="type">GdkDeviceType</span></a> type</code></em>);
-<a class="link" href="GdkDevice.html" title="GdkDevice"><span class="returnvalue">GdkDevice</span></a> * <a class="link" href="GdkDeviceManager.html#gdk-device-manager-get-client-pointer" title="gdk_device_manager_get_client_pointer ()">gdk_device_manager_get_client_pointer</a>
- (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>);
-</pre>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="synopsis">
- <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
- +----GdkDeviceManager
-</pre>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.properties"></a><h2>Properties</h2>
-<pre class="synopsis">
- "<a class="link" href="GdkDeviceManager.html#GdkDeviceManager--display" title='The "display" property'>display</a>" <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>* : Read / Write / Construct Only
-</pre>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.signals"></a><h2>Signals</h2>
-<pre class="synopsis">
- "<a class="link" href="GdkDeviceManager.html#GdkDeviceManager-device-added" title='The "device-added" signal'>device-added</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
- "<a class="link" href="GdkDeviceManager.html#GdkDeviceManager-device-changed" title='The "device-changed" signal'>device-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
- "<a class="link" href="GdkDeviceManager.html#GdkDeviceManager-device-removed" title='The "device-removed" signal'>device-removed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
-</pre>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.description"></a><h2>Description</h2>
-<p>
-In addition to a single pointer and keyboard for user interface input,
-GDK contains support for a variety of input devices, including graphics
-tablets, touchscreens and multiple pointers/keyboards interacting
-simultaneously with the user interface. Such input devices often have
-additional features, such as sub-pixel positioning information and
-additional device-dependent information.
-</p>
-<p>
-In order to query the device hierarchy and be aware of changes in the
-device hierarchy (such as virtual devices being created or removed, or
-physical devices being plugged or unplugged), GDK provides
-<a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a>.
-</p>
-<p>
-By default, and if the platform supports it, GDK is aware of multiple
-keyboard/pointer pairs and multitouch devices. This behavior can be
-changed by calling <a class="link" href="GdkDeviceManager.html#gdk-disable-multidevice" title="gdk_disable_multidevice ()"><code class="function">gdk_disable_multidevice()</code></a> before <a class="link" href="GdkDisplay.html#gdk-display-open" title="gdk_display_open ()"><code class="function">gdk_display_open()</code></a>.
-There should rarely be a need to do that though, since GDK defaults
-to a compatibility mode in which it will emit just one enter/leave
-event pair for all devices on a window. To enable per-device
-enter/leave events and other multi-pointer interaction features,
-<a class="link" href="gdk3-Windows.html#gdk-window-set-support-multidevice" title="gdk_window_set_support_multidevice ()"><code class="function">gdk_window_set_support_multidevice()</code></a> must be called on
-<a href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a> (or <a href="http://developer.gnome.org/gtk/GtkWidget.html#gtk-widget-set-support-multidevice"><code class="function">gtk_widget_set_support_multidevice()</code></a> on widgets).
-window. See the <a class="link" href="gdk3-Windows.html#gdk-window-set-support-multidevice" title="gdk_window_set_support_multidevice ()"><code class="function">gdk_window_set_support_multidevice()</code></a> documentation
-for more information.
-</p>
-<p>
-On X11, multi-device support is implemented through XInput 2.
-Unless <a class="link" href="GdkDeviceManager.html#gdk-disable-multidevice" title="gdk_disable_multidevice ()"><code class="function">gdk_disable_multidevice()</code></a> is called, the XInput 2
-<a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> implementation will be used as the input source.
-Otherwise either the core or XInput 1 implementations will be used.
-</p>
-<p>
-For simple applications that don't have any special interest in
-input devices, the so-called <em class="firstterm">client pointer</em>
-provides a reasonable approximation to a simple setup with a single
-pointer and keyboard. The device that has been set as the client
-pointer can be accessed via <a class="link" href="GdkDeviceManager.html#gdk-device-manager-get-client-pointer" title="gdk_device_manager_get_client_pointer ()"><code class="function">gdk_device_manager_get_client_pointer()</code></a>.
-</p>
-<p>
-Conceptually, in multidevice mode there are 2 device types. Virtual
-devices (or master devices) are represented by the pointer cursors
-and keyboard foci that are seen on the screen. Physical devices (or
-slave devices) represent the hardware that is controlling the virtual
-devices, and thus have no visible cursor on the screen.
-</p>
-<p>
-Virtual devices are always paired, so there is a keyboard device for every
-pointer device. Associations between devices may be inspected through
-<a class="link" href="GdkDevice.html#gdk-device-get-associated-device" title="gdk_device_get_associated_device ()"><code class="function">gdk_device_get_associated_device()</code></a>.
-</p>
-<p>
-There may be several virtual devices, and several physical devices could
-be controlling each of these virtual devices. Physical devices may also
-be "floating", which means they are not attached to any virtual device.
-</p>
-<p>
-</p>
-<div class="example">
-<a name="id485222"></a><p class="title"><b>Example 3. Master and slave devices</b></p>
-<div class="example-contents"><pre class="screen">
-carlos<em class="parameter"><code>sacarino</code></em>:~$ xinput list
-⎡ Virtual core pointer id=2 [master pointer (3)]
-⎜ ↳ Virtual core XTEST pointer id=4 [slave pointer (2)]
-⎜ ↳ Wacom ISDv4 E6 Pen stylus id=10 [slave pointer (2)]
-⎜ ↳ Wacom ISDv4 E6 Finger touch id=11 [slave pointer (2)]
-⎜ ↳ SynPS/2 Synaptics TouchPad id=13 [slave pointer (2)]
-⎜ ↳ TPPS/2 IBM TrackPoint id=14 [slave pointer (2)]
-⎜ ↳ Wacom ISDv4 E6 Pen eraser id=16 [slave pointer (2)]
-⎣ Virtual core keyboard id=3 [master keyboard (2)]
- ↳ Virtual core XTEST keyboard id=5 [slave keyboard (3)]
- ↳ Power Button id=6 [slave keyboard (3)]
- ↳ Video Bus id=7 [slave keyboard (3)]
- ↳ Sleep Button id=8 [slave keyboard (3)]
- ↳ Integrated Camera id=9 [slave keyboard (3)]
- ↳ AT Translated Set 2 keyboard id=12 [slave keyboard (3)]
- ↳ ThinkPad Extra Buttons id=15 [slave keyboard (3)]
-</pre></div>
-</div>
-<p><br class="example-break">
-</p>
-<p>
-By default, GDK will automatically listen for events coming from all
-master devices, setting the <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> for all events coming from input
-devices. Events containing device information are <a class="link" href="gdk3-Events.html#GDK-MOTION-NOTIFY:CAPS"><span class="type">GDK_MOTION_NOTIFY</span></a>,
-<a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><span class="type">GDK_BUTTON_PRESS</span></a>, <a class="link" href="gdk3-Events.html#GDK-2BUTTON-PRESS:CAPS"><span class="type">GDK_2BUTTON_PRESS</span></a>, <a class="link" href="gdk3-Events.html#GDK-3BUTTON-PRESS:CAPS"><span class="type">GDK_3BUTTON_PRESS</span></a>,
-<a class="link" href="gdk3-Events.html#GDK-BUTTON-RELEASE:CAPS"><span class="type">GDK_BUTTON_RELEASE</span></a>, <a class="link" href="gdk3-Events.html#GDK-SCROLL:CAPS"><span class="type">GDK_SCROLL</span></a>, <a class="link" href="gdk3-Events.html#GDK-KEY-PRESS:CAPS"><span class="type">GDK_KEY_PRESS</span></a>, <a class="link" href="gdk3-Events.html#GDK-KEY-RELEASE:CAPS"><span class="type">GDK_KEY_RELEASE</span></a>,
-<a class="link" href="gdk3-Events.html#GDK-ENTER-NOTIFY:CAPS"><span class="type">GDK_ENTER_NOTIFY</span></a>, <a class="link" href="gdk3-Events.html#GDK-LEAVE-NOTIFY:CAPS"><span class="type">GDK_LEAVE_NOTIFY</span></a>, <a class="link" href="gdk3-Events.html#GDK-FOCUS-CHANGE:CAPS"><span class="type">GDK_FOCUS_CHANGE</span></a>,
-<a class="link" href="gdk3-Events.html#GDK-PROXIMITY-IN:CAPS"><span class="type">GDK_PROXIMITY_IN</span></a>, <a class="link" href="gdk3-Events.html#GDK-PROXIMITY-OUT:CAPS"><span class="type">GDK_PROXIMITY_OUT</span></a>, <a class="link" href="gdk3-Events.html#GDK-DRAG-ENTER:CAPS"><span class="type">GDK_DRAG_ENTER</span></a>, <a class="link" href="gdk3-Events.html#GDK-DRAG-LEAVE:CAPS"><span class="type">GDK_DRAG_LEAVE</span></a>,
-<a class="link" href="gdk3-Events.html#GDK-DRAG-MOTION:CAPS"><span class="type">GDK_DRAG_MOTION</span></a>, <a class="link" href="gdk3-Events.html#GDK-DRAG-STATUS:CAPS"><span class="type">GDK_DRAG_STATUS</span></a>, <a class="link" href="gdk3-Events.html#GDK-DROP-START:CAPS"><span class="type">GDK_DROP_START</span></a>, <a class="link" href="gdk3-Events.html#GDK-DROP-FINISHED:CAPS"><span class="type">GDK_DROP_FINISHED</span></a>
-and <a class="link" href="gdk3-Events.html#GDK-GRAB-BROKEN:CAPS"><span class="type">GDK_GRAB_BROKEN</span></a>. When dealing with an event on a master device,
-it is possible to get the source (slave) device that the event originated
-from via <a class="link" href="gdk3-Events.html#gdk-event-get-source-device" title="gdk_event_get_source_device ()"><code class="function">gdk_event_get_source_device()</code></a>.
-</p>
-<p>
-In order to listen for events coming from devices
-other than a virtual device, <a class="link" href="gdk3-Windows.html#gdk-window-set-device-events" title="gdk_window_set_device_events ()"><code class="function">gdk_window_set_device_events()</code></a> must be
-called. Generally, this function can be used to modify the event mask
-for any given device.
-</p>
-<p>
-Input devices may also provide additional information besides X/Y.
-For example, graphics tablets may also provide pressure and X/Y tilt
-information. This information is device-dependent, and may be
-queried through <a class="link" href="GdkDevice.html#gdk-device-get-axis" title="gdk_device_get_axis ()"><code class="function">gdk_device_get_axis()</code></a>. In multidevice mode, virtual
-devices will change axes in order to always represent the physical
-device that is routing events through it. Whenever the physical device
-changes, the <a class="link" href="GdkDevice.html#GdkDevice--n-axes" title='The "n-axes" property'><span class="type">"n-axes"</span></a> property will be notified, and
-<a class="link" href="GdkDevice.html#gdk-device-list-axes" title="gdk_device_list_axes ()"><code class="function">gdk_device_list_axes()</code></a> will return the new device axes.
-</p>
-<p>
-Devices may also have associated <em class="firstterm">keys</em> or
-macro buttons. Such keys can be globally set to map into normal X
-keyboard events. The mapping is set using <a class="link" href="GdkDevice.html#gdk-device-set-key" title="gdk_device_set_key ()"><code class="function">gdk_device_set_key()</code></a>.
-</p>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.details"></a><h2>Details</h2>
-<div class="refsect2">
-<a name="GdkDeviceManager-struct"></a><h3>GdkDeviceManager</h3>
-<pre class="programlisting">typedef struct _GdkDeviceManager GdkDeviceManager;</pre>
-</div>
-<hr>
-<div class="refsect2">
-<a name="gdk-disable-multidevice"></a><h3>gdk_disable_multidevice ()</h3>
-<pre class="programlisting"><span class="returnvalue">void</span> gdk_disable_multidevice (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
-<p>
-Disables multidevice support in GDK. This call must happen prior
-to <a class="link" href="GdkDisplay.html#gdk-display-open" title="gdk_display_open ()"><code class="function">gdk_display_open()</code></a>, <a href="http://library.gnome.org/devel/gtk3/gtk-General.html#gtk-init"><code class="function">gtk_init()</code></a>, <a href="http://library.gnome.org/devel/gtk3/gtk-General.html#gtk-init-with-args"><code class="function">gtk_init_with_args()</code></a> or
-<a href="http://library.gnome.org/devel/gtk3/gtk-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a> in order to take effect.
-</p>
-<p>
-Most common GTK+ applications won't ever need to call this. Only
-applications that do mixed GDK/Xlib calls could want to disable
-multidevice support if such Xlib code deals with input devices in
-any way and doesn't observe the presence of XInput 2.
-</p>
-<p class="since">Since 3.0</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="gdk-device-manager-get-display"></a><h3>gdk_device_manager_get_display ()</h3>
-<pre class="programlisting"><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> * gdk_device_manager_get_display (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>);</pre>
-<p>
-Gets the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> associated to <em class="parameter"><code>device_manager</code></em>.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>a <a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a>
-</td>
-</tr>
-<tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> to which <em class="parameter"><code>device_manager</code></em> is
-associated to, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>. This memory is owned by GDK and
-must not be freed or unreferenced. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
-</td>
-</tr>
-</tbody>
-</table></div>
-<p class="since">Since 3.0</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="gdk-device-manager-list-devices"></a><h3>gdk_device_manager_list_devices ()</h3>
-<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_device_manager_list_devices (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>,
- <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkDeviceType" title="enum GdkDeviceType"><span class="type">GdkDeviceType</span></a> type</code></em>);</pre>
-<p>
-Returns the list of devices of type <em class="parameter"><code>type</code></em> currently attached to
-<em class="parameter"><code>device_manager</code></em>.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>a <a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a>
-</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
-<td>device type to get.</td>
-</tr>
-<tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>a list of
-<a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>s. The returned list must be
-freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. The list elements are owned by
-GTK+ and must not be freed or unreffed. <span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gdk.Device]</span>
-</td>
-</tr>
-</tbody>
-</table></div>
-<p class="since">Since 3.0</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="gdk-device-manager-get-client-pointer"></a><h3>gdk_device_manager_get_client_pointer ()</h3>
-<pre class="programlisting"><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="returnvalue">GdkDevice</span></a> * gdk_device_manager_get_client_pointer
- (<em class="parameter"><code><a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager</code></em>);</pre>
-<p>
-Returns the client pointer, that is, the master pointer that acts as the core pointer
-for this application. In X11, window managers may change this depending on the interaction
-pattern under the presence of several pointers.
-</p>
-<p>
-You should use this function sheldomly, only in code that isn't triggered by a <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a>
-and there aren't other means to get a meaningful <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to operate on.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>a <a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a>
-</td>
-</tr>
-<tr>
-<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>The client pointer. This memory is
-owned by GDK and must not be freed or unreferenced. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
-</td>
-</tr>
-</tbody>
-</table></div>
-<p class="since">Since 3.0</p>
-</div>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.property-details"></a><h2>Property Details</h2>
-<div class="refsect2">
-<a name="GdkDeviceManager--display"></a><h3>The <code class="literal">"display"</code> property</h3>
-<pre class="programlisting"> "display" <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>* : Read / Write / Construct Only</pre>
-<p>Display for the device manager.</p>
-</div>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.signal-details"></a><h2>Signal Details</h2>
-<div class="refsect2">
-<a name="GdkDeviceManager-device-added"></a><h3>The <code class="literal">"device-added"</code> signal</h3>
-<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager,
- <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device,
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
-<p>
-The ::device-added signal is emitted either when a new master
-pointer is created, or when a slave (Hardware) input device
-is plugged in.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>the object on which the signal is emitted</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
-<td>the newly added <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
-<td>user data set when the signal handler was connected.</td>
-</tr>
-</tbody>
-</table></div>
-</div>
-<hr>
-<div class="refsect2">
-<a name="GdkDeviceManager-device-changed"></a><h3>The <code class="literal">"device-changed"</code> signal</h3>
-<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager,
- <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device,
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
-<p>
-The ::device-changed signal is emitted whenever a device
-has changed in the hierarchy, either slave devices being
-disconnected from their master device or connected to
-another one, or master devices being added or removed
-a slave device.
-</p>
-<p>
-If a slave device is detached from all master devices
-(<a class="link" href="GdkDevice.html#gdk-device-get-associated-device" title="gdk_device_get_associated_device ()"><code class="function">gdk_device_get_associated_device()</code></a> returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), its
-<a class="link" href="GdkDevice.html#GdkDeviceType" title="enum GdkDeviceType"><span class="type">GdkDeviceType</span></a> will change to <a class="link" href="GdkDevice.html#GDK-DEVICE-TYPE-FLOATING:CAPS"><code class="literal">GDK_DEVICE_TYPE_FLOATING</code></a>,
-if it's attached, it will change to <a class="link" href="GdkDevice.html#GDK-DEVICE-TYPE-SLAVE:CAPS"><code class="literal">GDK_DEVICE_TYPE_SLAVE</code></a>.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>the object on which the signal is emitted</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
-<td>the <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> that changed.</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
-<td>user data set when the signal handler was connected.</td>
-</tr>
-</tbody>
-</table></div>
-</div>
-<hr>
-<div class="refsect2">
-<a name="GdkDeviceManager-device-removed"></a><h3>The <code class="literal">"device-removed"</code> signal</h3>
-<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkDeviceManager.html" title="GdkDeviceManager"><span class="type">GdkDeviceManager</span></a> *device_manager,
- <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device,
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
-<p>
-The ::device-removed signal is emitted either when a master
-pointer is removed, or when a slave (Hardware) input device
-is unplugged.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device_manager</code></em> :</span></p></td>
-<td>the object on which the signal is emitted</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
-<td>the just removed <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</td>
-</tr>
-<tr>
-<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
-<td>user data set when the signal handler was connected.</td>
-</tr>
-</tbody>
-</table></div>
-</div>
-</div>
-<div class="refsect1">
-<a name="GdkDeviceManager.see-also"></a><h2>See Also</h2>
-<a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>, <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a>
-</div>
-</div>
-<div class="footer">
-<hr>
- Generated by GTK-Doc V1.18.1</div>
-</body>
-</html> \ No newline at end of file
generated by cgit v1.2.3 (git 2.39.1) at 2025-07-07 22:32:14 +0000