mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-10-03 20:47:32 +00:00
425b9886c9
Thu Apr 25 16:51:40 2002 Owen Taylor <otaylor@redhat.com>
Start of integration of Erwann Chenede's multihead work
from the gtk-multihead branch.
* gdk/gdkdisplay.[ch] gdk/gdkscreen.[ch]
gdk/x11/gdkdisplay-x11.[ch] gdk/x11/gdkscreen-x11.[ch]
New classes representing a set of screens with attached
input devices and a single contiguous area, respectively.
* gdk/gdk.[ch] gdk/gdkinternals.h gdk/x11/gdkmain-x11.c:
gdk/x11/gdkprivate-x11.h: Make the initialization interface
simple _gdk_windowing_init() and do the rest in
gdk_open_display() calls.
* gdk/gdk.[ch]: Add gdk_parse_args() which can be used
to do the display-independent part of initialization
instead of gdk_init_[check].
* gdk/gdkcursor.h gdk/gdkfont.h gdk/gdkkeys.h gdk/gdkpixmap.h
gdk/gdkproperty.h gdk/gdkselection.h gdk/gdkwindow.h:
Add multihead variants (_for_display(), for_screen()) of functions
getting information specific to a particular screen screen or
display.
* gdk/gdkscreen.[ch]: Add gdk_screen__* variants of functions
like gdk_rgb_get_colormap() that used to get/list global
objects.
* gdk/x11/gdkx.h: Add functions for converting GdkScreen
and GdkDisplay into the X equivalents.
* gdk/x11/gdkwindow-x11.c: Removed gdk_window_xid_at_coords()
not in the headers and unused.
* configure.in gdk/x11/{gxid.c,gxid_lib.[ch],gdkinput-gxi.c}:
Remove gxid support ... has not been tested for a long time...
"xfree" support is more portable to non XFree86.
* gdk/**.h: Add a GDK_MULTIHEAD_SAFE define that can be
used to turn off functions that are inherently non-multihead
safe.
* gdk/**.c: add GDK_NOTE(multihead, ...) calls when functions
are used in non-multihead-safe ways.
* gdk/*.c gdk/x11/*.c: Changes to make the internals of GDK
multihead safe.
526 lines
9.3 KiB
Plaintext
526 lines
9.3 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
X Window System Interaction
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### MACRO GDK_ROOT_WINDOW ##### -->
|
|
<para>
|
|
Obtains the Xlib window id of the root window of the current screen.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GDK_ROOT_PARENT ##### -->
|
|
<para>
|
|
Obtains the Xlib window id of the root window of the default screen.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### MACRO GDK_DISPLAY ##### -->
|
|
<para>
|
|
The current display.
|
|
</para>
|
|
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_WINDOW_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkWindow.
|
|
</para>
|
|
|
|
@win: a #GdkWindow.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_WINDOW_XID ##### -->
|
|
<para>
|
|
Returns the X window belonging to a #GdkWindow.
|
|
</para>
|
|
|
|
@win: a #GdkWindow.
|
|
@Returns: the Xlib <type>Window</type> of @win.
|
|
|
|
|
|
<!-- ##### MACRO GDK_PIXMAP_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkPixmap.
|
|
</para>
|
|
|
|
@pix:
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
<!-- # Unused Parameters # -->
|
|
@win: a #GdkPixmap.
|
|
|
|
|
|
<!-- ##### MACRO GDK_PIXMAP_XID ##### -->
|
|
<para>
|
|
Returns the X pixmap belonging to a #GdkPixmap.
|
|
</para>
|
|
|
|
@pix:
|
|
@Returns: the Xlib <type>XPixmap</type> of @win.
|
|
<!-- # Unused Parameters # -->
|
|
@win: a #GdkPixmap.
|
|
|
|
|
|
<!-- ##### MACRO GDK_DRAWABLE_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkDrawable.
|
|
</para>
|
|
|
|
@win: a #GdkDrawable.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_DRAWABLE_XID ##### -->
|
|
<para>
|
|
Returns the X resource (window or pixmap) belonging to a #GdkDrawable.
|
|
</para>
|
|
|
|
@win: a #GdkDrawable.
|
|
@Returns: the ID of @win's X resource.
|
|
|
|
|
|
<!-- ##### MACRO GDK_IMAGE_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkImage.
|
|
</para>
|
|
|
|
@image: a #GdkImage.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_IMAGE_XIMAGE ##### -->
|
|
<para>
|
|
Returns the X image belonging to a #GdkImage.
|
|
</para>
|
|
|
|
@image: a #GdkImage.
|
|
@Returns: an <type>XImage*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_GC_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkGC.
|
|
</para>
|
|
|
|
@gc: a #GdkGC.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_COLORMAP_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkColormap.
|
|
</para>
|
|
|
|
@cmap: a #GdkColormap.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_COLORMAP_XCOLORMAP ##### -->
|
|
<para>
|
|
Returns the X colormap belonging to a #GdkColormap.
|
|
</para>
|
|
|
|
@cmap: a #GdkColormap.
|
|
@Returns: an Xlib <type>Colormap</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_VISUAL_XVISUAL ##### -->
|
|
<para>
|
|
Returns the X visual belonging to a #GdkVisual.
|
|
</para>
|
|
|
|
@vis: a #GdkVisual.
|
|
@Returns: an Xlib <type>Visual*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_FONT_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkFont.
|
|
</para>
|
|
|
|
@font: a #GdkFont.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_FONT_XFONT ##### -->
|
|
<para>
|
|
Returns the X font belonging to a #GdkFont.
|
|
</para>
|
|
|
|
@font: a #GdkFont.
|
|
@Returns: an Xlib <type>XFontStruct*</type> or an <type>XFontSet</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_CURSOR_XCURSOR ##### -->
|
|
<para>
|
|
Returns the X cursor belonging to a #GdkCursor.
|
|
</para>
|
|
|
|
@cursor: a #GdkCursor.
|
|
@Returns: an Xlib <type>Cursor</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_CURSOR_XDISPLAY ##### -->
|
|
<para>
|
|
Returns the display of a #GdkCursor.
|
|
</para>
|
|
|
|
@cursor: a #GdkCursor.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_GC_XGC ##### -->
|
|
<para>
|
|
Returns the X GC of a #GdkGC.
|
|
</para>
|
|
<note><para>
|
|
Note that the clip origin, clip region and tile/stipple origin fields of the
|
|
returned GC may not be in sync with @gc. If you need that,
|
|
use GDK_GC_GET_XGC().
|
|
</para></note>
|
|
|
|
@gc: a #GdkGC.
|
|
@Returns: an Xlib <type>GC</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_GC_GET_XGC ##### -->
|
|
<para>
|
|
Returns the X GC of a #GdkGC.
|
|
</para>
|
|
|
|
@gc: a #GdkGC.
|
|
@Returns: an Xlib <type>GC</type>.
|
|
|
|
|
|
<!-- ##### MACRO GDK_WINDOW_XWINDOW ##### -->
|
|
<para>
|
|
Another name for GDK_DRAWABLE_XID().
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdkx_visual_get ##### -->
|
|
<para>
|
|
Returns a #GdkVisual corresponding to a X visual.
|
|
</para>
|
|
|
|
@xvisualid: a X visual id.
|
|
@Returns: the #GdkVisual.
|
|
|
|
|
|
<!-- ##### FUNCTION gdkx_colormap_get ##### -->
|
|
<para>
|
|
Returns a #GdkColormap corresponding to a X colormap.
|
|
</para>
|
|
|
|
@xcolormap: a X colormap.
|
|
@Returns: the #GdkColormap.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_pixmap_foreign_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@anid:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_window_foreign_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@anid:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_xid_table_lookup ##### -->
|
|
<para>
|
|
Returns the Gdk object associated with the given X id.
|
|
</para>
|
|
|
|
@xid: an X id.
|
|
@Returns: the associated Gdk object, which may be a #GdkPixmap,
|
|
a #GdkWindow or a #GdkFont.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_window_lookup ##### -->
|
|
<para>
|
|
Obtains the #GdkWindow for the given Xlib window ID, or %NULL if no #GdkWindow has
|
|
been created for @xid.
|
|
</para>
|
|
|
|
@anid:
|
|
@Returns:
|
|
<!-- # Unused Parameters # -->
|
|
@xid: Xlib window ID
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_pixmap_lookup ##### -->
|
|
<para>
|
|
Obtains the #GdkPixmap for the given Xlib pixmap ID, or %NULL if no #GdkPixmap has
|
|
been created for @xid.
|
|
</para>
|
|
|
|
@anid:
|
|
@Returns:
|
|
<!-- # Unused Parameters # -->
|
|
@xid: Xlib pixmap ID
|
|
|
|
|
|
<!-- ##### MACRO gdk_font_lookup ##### -->
|
|
<para>
|
|
Obtains the #GdkFont for the given Xlib pixmap ID, or %NULL if no #GdkPixmap has
|
|
been created for @xid.
|
|
</para>
|
|
|
|
@xid:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_server_time ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@window:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_net_wm_supports ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@property:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_colormap_get_xcolormap ##### -->
|
|
<para>
|
|
Returns the X colormap belonging to a #GdkColormap.
|
|
</para>
|
|
|
|
@colormap: a #GdkColormap.
|
|
@Returns: an Xlib <type>Colormap</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_colormap_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkColormap.
|
|
</para>
|
|
|
|
@colormap: a #GdkColormap.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_cursor_get_xcursor ##### -->
|
|
<para>
|
|
Returns the X cursor belonging to a #GdkCursor.
|
|
</para>
|
|
|
|
@cursor: a #GdkCursor.
|
|
@Returns:
|
|
<!-- # Unused Parameters # -->
|
|
@Retursn: an Xlib <type>Cursor</type.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_cursor_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkCursor.
|
|
</para>
|
|
|
|
@cursor: a #GdkCursor.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_drawable_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkDrawable.
|
|
</para>
|
|
|
|
@drawable: a #GdkDrawable.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_drawable_get_xid ##### -->
|
|
<para>
|
|
Returns the X resource (window or pixmap) belonging to a #GdkDrawable.
|
|
</para>
|
|
|
|
@drawable: a #GdkDrawable.
|
|
@Returns: the ID of @win's X resource.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_font_get_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@font:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_font_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkFont.
|
|
</para>
|
|
|
|
@font: a #GdkFont.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_font_get_xfont ##### -->
|
|
<para>
|
|
Returns the X font belonging to a #GdkFont.
|
|
</para>
|
|
|
|
@font: a #GdkFont.
|
|
@Returns: an Xlib <type>XFontStruct*</type> or an <type>XFontSet</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_gc_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkGC.
|
|
</para>
|
|
|
|
@gc: a #GdkGC.
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_gc_get_xgc ##### -->
|
|
<para>
|
|
Returns the X GC of a #GdkGC.
|
|
</para>
|
|
|
|
@gc: a #GdkGC.
|
|
@Returns: an Xlib <type>GC</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_default_root_xwindow ##### -->
|
|
<para>
|
|
Gets the root window of the default screen
|
|
(see gdk_x11_get_default_screen()).
|
|
</para>
|
|
|
|
@Returns: an Xlib <type>Window</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_default_screen ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_default_xdisplay ##### -->
|
|
<para>
|
|
Gets the default GTK+ display.
|
|
</para>
|
|
|
|
@Returns: the Xlib <type>Display*</type> for the display
|
|
specified in the <option>--display</option> command line option
|
|
or the <envar>DISPLAY</envar> environment variable.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_grab_server ##### -->
|
|
<para>
|
|
Call <function>XGrabServer()</function> on the default display.
|
|
To ungrab the server again, use gdk_x11_ungrab_server().
|
|
</para>
|
|
<para>
|
|
gdk_x11_grab_server()/gdk_x11_ungrab_server() calls can be nested.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_image_get_xdisplay ##### -->
|
|
<para>
|
|
Returns the display of a #GdkImage.
|
|
</para>
|
|
|
|
@image:
|
|
@Returns: an Xlib <type>Display*</type>.
|
|
<!-- # Unused Parameters # -->
|
|
@drawable: a #GdkImage.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_image_get_ximage ##### -->
|
|
<para>
|
|
Returns the X image belonging to a #GdkImage.
|
|
</para>
|
|
|
|
@image: a #GdkImage.
|
|
@Returns: an <type>XImage*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_ungrab_server ##### -->
|
|
<para>
|
|
Ungrab the default display after it has been grabbed with
|
|
gdk_x11_grab_server().
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_visual_get_xvisual ##### -->
|
|
<para>
|
|
Returns the X visual belonging to a #GdkVisual.
|
|
</para>
|
|
|
|
@visual: a #GdkVisual.
|
|
@Returns: an Xlib <type>Visual*</type>.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_atom_to_xatom ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@atom:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_xatom_to_atom ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@xatom:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_xatom_by_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@atom_name:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_x11_get_xatom_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@xatom:
|
|
@Returns:
|
|
|
|
|