2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GdkDisplay
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2002-11-23 23:02:10 +00:00
|
|
|
Controls the keyboard/mouse pointer grabs and a set of <type>GdkScreen</type>s
|
2002-04-30 18:07:51 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2002-05-01 21:29:49 +00:00
|
|
|
#GdkDisplay objects purpose are two fold:
|
2002-04-30 18:07:51 +00:00
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para>To grab/ungrab keyboard focus and mouse pointer</para></listitem>
|
|
|
|
<listitem><para>To manage and provide information about the #GdkScreen(s)
|
|
|
|
available for this #GdkDisplay
|
|
|
|
</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</para>
|
|
|
|
<para>
|
2002-05-01 21:29:49 +00:00
|
|
|
#GdkDisplay objects are the GDK representation of the X Display which can be
|
|
|
|
described as <emphasis>a workstation consisting of a keyboard a pointing
|
|
|
|
device (such as a mouse) and one or more screens</emphasis>.
|
2002-04-30 18:07:51 +00:00
|
|
|
It is used to open and keep track of various #GdkScreen objects currently
|
2002-05-01 21:29:49 +00:00
|
|
|
instanciated by the application. It is also used to grab and release the keyboard
|
2002-04-30 18:07:51 +00:00
|
|
|
and the mouse pointer.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
<!-- ##### SECTION Image ##### -->
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### STRUCT GdkDisplay ##### -->
|
|
|
|
<para>
|
2002-05-02 22:28:50 +00:00
|
|
|
The <structname>GdkDisplay</structname> struct is the GDK representation
|
|
|
|
of an X display. All its fields are private and should not be accessed directly.
|
2002-04-30 18:07:51 +00:00
|
|
|
</para>
|
|
|
|
|
2002-12-06 00:10:20 +00:00
|
|
|
@Since: 2.2
|
2002-04-30 18:07:51 +00:00
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### SIGNAL GdkDisplay::closed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@gdkdisplay: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### SIGNAL GdkDisplay::opened ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@gdkdisplay: the object which received the signal.
|
|
|
|
|
2002-06-20 23:59:27 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_open ##### -->
|
2002-04-30 18:07:51 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display_name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-06-20 23:59:27 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
@void:
|
2002-06-20 23:59:27 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_n_screens ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_screen ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@screen_num:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_default_screen ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_device_manager ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_pointer_ungrab ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
2002-11-08 19:41:50 +00:00
|
|
|
@time_:
|
2002-04-30 18:07:51 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_keyboard_ungrab ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
2002-11-08 19:41:50 +00:00
|
|
|
@time_:
|
2002-04-30 18:07:51 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_pointer_is_grabbed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_device_is_grabbed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@device:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_beep ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_sync ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
|
|
|
|
|
2003-07-28 16:08:20 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_flush ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_close ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
|
|
|
|
|
2010-08-10 18:51:58 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_is_closed ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:07:51 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_list_devices ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_event ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_peek_event ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_put_event ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@event:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_add_client_message_filter ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@message_type:
|
|
|
|
@func:
|
|
|
|
@data:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_set_double_click_time ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@msec:
|
|
|
|
|
|
|
|
|
2004-01-22 06:48:20 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_set_double_click_distance ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@distance:
|
|
|
|
|
|
|
|
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_pointer ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@screen:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@mask:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_device_state ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@device:
|
|
|
|
@screen:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@mask:
|
|
|
|
|
|
|
|
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_window_at_pointer ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@win_x:
|
|
|
|
@win_y:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_window_at_device_position ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@device:
|
|
|
|
@win_x:
|
|
|
|
@win_y:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<!-- ##### STRUCT GdkDisplayPointerHooks ##### -->
|
|
|
|
<para>
|
2002-10-22 22:11:22 +00:00
|
|
|
A table of pointers to functions for getting quantities related to
|
|
|
|
the current pointer position. Each #GdkDisplay has a table of this type,
|
|
|
|
which can be set using gdk_display_set_pointer_hooks().
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
This is only useful for such low-level tools as an event recorder.
|
|
|
|
Applications should never have any reason to use this facility
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
</para>
|
|
|
|
|
2002-10-22 22:11:22 +00:00
|
|
|
@get_pointer: Obtains the current pointer position and modifier state.
|
|
|
|
The position is given in coordinates relative to the window containing
|
|
|
|
the pointer, which is returned in @window.
|
|
|
|
@window_get_pointer: Obtains the window underneath the mouse pointer.
|
|
|
|
Current pointer position and modifier state are returned in @x, @y and
|
|
|
|
@mask. The position is given in coordinates relative to @window.
|
|
|
|
@window_at_pointer: Obtains the window underneath the mouse pointer,
|
|
|
|
returning the location of that window in @win_x, @win_y. Returns %NULL
|
|
|
|
if the window under the mouse pointer is not known to GDK (for example,
|
|
|
|
belongs to another application).
|
2002-12-06 00:10:20 +00:00
|
|
|
@Since: 2.2
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_set_pointer_hooks ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@new_hooks:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### STRUCT GdkDisplayDeviceHooks ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@get_device_state:
|
|
|
|
@window_get_device_position:
|
|
|
|
@window_at_device_position:
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_set_device_hooks ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@new_hooks:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2005-02-03 23:29:02 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_warp_pointer ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@screen:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
|
|
|
|
|
2010-05-26 02:57:46 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_warp_device ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@device:
|
|
|
|
@screen:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
|
|
|
|
|
2003-07-28 16:08:20 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_supports_cursor_color ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_supports_cursor_alpha ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_default_cursor_size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_get_maximal_cursor_size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@width:
|
|
|
|
@height:
|
|
|
|
|
|
|
|
|
2004-01-22 06:48:20 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_get_default_group ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-05-18 20:56:54 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_supports_selection_notification ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_request_selection_notification ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@selection:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-10-25 19:23:22 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_supports_clipboard_persistence ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_store_clipboard ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@clipboard_window:
|
|
|
|
@time_:
|
|
|
|
@targets:
|
|
|
|
@n_targets:
|
|
|
|
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_supports_shapes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_display_supports_input_shapes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-06-04 17:01:14 +00:00
|
|
|
<!-- ##### FUNCTION gdk_display_supports_composite ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@display:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|