diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gdk3/GdkDeviceManager.html | 427 |
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 <gdk/gdk.h> - - <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 |