diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gdk3/gdk3-Windows.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gdk3/gdk3-Windows.html | 6244 |
1 files changed, 0 insertions, 6244 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gdk3/gdk3-Windows.html b/gtk+-mingw/share/gtk-doc/html/gdk3/gdk3-Windows.html deleted file mode 100644 index 42c9b9e..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gdk3/gdk3-Windows.html +++ /dev/null @@ -1,6244 +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>Windows</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="gdk3-Cursors.html" title="Cursors"> -<link rel="next" href="gdk3-Events.html" title="Events"> -<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="gdk3-Cursors.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="gdk3-Events.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#gdk3-Windows.synopsis" class="shortcut">Top</a> - | - <a href="#gdk3-Windows.description" class="shortcut">Description</a> - | - <a href="#gdk3-Windows.object-hierarchy" class="shortcut">Object Hierarchy</a> - | - <a href="#gdk3-Windows.properties" class="shortcut">Properties</a> - | - <a href="#gdk3-Windows.signals" class="shortcut">Signals</a> -</td></tr> -</table> -<div class="refentry"> -<a name="gdk3-Windows"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="gdk3-Windows.top_of_page"></a>Windows</span></h2> -<p>Windows — Onscreen display areas in the target window system</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="gdk3-Windows.synopsis"></a><h2>Synopsis</h2> -<a name="GdkWindow"></a><pre class="synopsis"> -#include <gdk/gdk.h> - - <a class="link" href="gdk3-Windows.html#GdkWindow-struct" title="GdkWindow">GdkWindow</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType">GdkWindowType</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowWindowClass" title="enum GdkWindowWindowClass">GdkWindowWindowClass</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints">GdkWindowHints</a>; -struct <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry">GdkGeometry</a>; -enum <a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity">GdkGravity</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge">GdkWindowEdge</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint">GdkWindowTypeHint</a>; -struct <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr">GdkWindowAttr</a>; -enum <a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType">GdkWindowAttributesType</a>; -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()">gdk_window_new</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> *attributes</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> attributes_mask</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-destroy" title="gdk_window_destroy ()">gdk_window_destroy</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="returnvalue">GdkWindowType</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-window-type" title="gdk_window_get_window_type ()">gdk_window_get_window_type</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-display" title="gdk_window_get_display ()">gdk_window_get_display</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="returnvalue">GdkScreen</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-screen" title="gdk_window_get_screen ()">gdk_window_get_screen</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="returnvalue">GdkVisual</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-visual" title="gdk_window_get_visual ()">gdk_window_get_visual</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-at-pointer" title="gdk_window_at_pointer ()">gdk_window_at_pointer</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *win_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *win_y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()">gdk_window_show</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()">gdk_window_show_unraised</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()">gdk_window_hide</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-is-destroyed" title="gdk_window_is_destroyed ()">gdk_window_is_destroyed</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-is-visible" title="gdk_window_is_visible ()">gdk_window_is_visible</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-is-viewable" title="gdk_window_is_viewable ()">gdk_window_is_viewable</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-is-input-only" title="gdk_window_is_input_only ()">gdk_window_is_input_only</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-is-shaped" title="gdk_window_is_shaped ()">gdk_window_is_shaped</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="returnvalue">GdkWindowState</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-state" title="gdk_window_get_state ()">gdk_window_get_state</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-withdraw" title="gdk_window_withdraw ()">gdk_window_withdraw</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-iconify" title="gdk_window_iconify ()">gdk_window_iconify</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-deiconify" title="gdk_window_deiconify ()">gdk_window_deiconify</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()">gdk_window_stick</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-unstick" title="gdk_window_unstick ()">gdk_window_unstick</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-maximize" title="gdk_window_maximize ()">gdk_window_maximize</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-unmaximize" title="gdk_window_unmaximize ()">gdk_window_unmaximize</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-fullscreen" title="gdk_window_fullscreen ()">gdk_window_fullscreen</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-unfullscreen" title="gdk_window_unfullscreen ()">gdk_window_unfullscreen</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-keep-above" title="gdk_window_set_keep_above ()">gdk_window_set_keep_above</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-keep-below" title="gdk_window_set_keep_below ()">gdk_window_set_keep_below</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-opacity" title="gdk_window_set_opacity ()">gdk_window_set_opacity</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()">gdk_window_set_composited</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> composited</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-composited" title="gdk_window_get_composited ()">gdk_window_get_composited</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()">gdk_window_move</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()">gdk_window_resize</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()">gdk_window_move_resize</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-scroll" title="gdk_window_scroll ()">gdk_window_scroll</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dy</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-move-region" title="gdk_window_move_region ()">gdk_window_move_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dy</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-flush" title="gdk_window_flush ()">gdk_window_flush</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-has-native" title="gdk_window_has_native ()">gdk_window_has_native</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-ensure-native" title="gdk_window_ensure_native ()">gdk_window_ensure_native</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-reparent" title="gdk_window_reparent ()">gdk_window_reparent</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *new_parent</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-raise" title="gdk_window_raise ()">gdk_window_raise</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-lower" title="gdk_window_lower ()">gdk_window_lower</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-restack" title="gdk_window_restack ()">gdk_window_restack</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *sibling</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> above</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-focus" title="gdk_window_focus ()">gdk_window_focus</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-register-dnd" title="gdk_window_register_dnd ()">gdk_window_register_dnd</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-resize-drag" title="gdk_window_begin_resize_drag ()">gdk_window_begin_resize_drag</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-resize-drag-for-device" title="gdk_window_begin_resize_drag_for_device ()">gdk_window_begin_resize_drag_for_device</a> - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-move-drag" title="gdk_window_begin_move_drag ()">gdk_window_begin_move_drag</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-move-drag-for-device" title="gdk_window_begin_move_drag_for_device ()">gdk_window_begin_move_drag_for_device</a> - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-constrain-size" title="gdk_window_constrain_size ()">gdk_window_constrain_size</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-beep" title="gdk_window_beep ()">gdk_window_beep</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); - -<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-clip-region" title="gdk_window_get_clip_region ()">gdk_window_get_clip_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-rect" title="gdk_window_begin_paint_rect ()">gdk_window_begin_paint_rect</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()">gdk_window_begin_paint_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()">gdk_window_end_paint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-visible-region" title="gdk_window_get_visible_region ()">gdk_window_get_visible_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); - -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-rect" title="gdk_window_invalidate_rect ()">gdk_window_invalidate_rect</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invalidate_children</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()">gdk_window_invalidate_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invalidate_children</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="gdk3-Windows.html#GdkWindowChildFunc" title="GdkWindowChildFunc ()">*GdkWindowChildFunc</a>) (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-maybe-recurse" title="gdk_window_invalidate_maybe_recurse ()">gdk_window_invalidate_maybe_recurse</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowChildFunc" title="GdkWindowChildFunc ()"><span class="type">GdkWindowChildFunc</span></a> child_func</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-update-area" title="gdk_window_get_update_area ()">gdk_window_get_update_area</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()">gdk_window_freeze_updates</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()">gdk_window_thaw_updates</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()">gdk_window_process_all_updates</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()">gdk_window_process_updates</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> update_children</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-debug-updates" title="gdk_window_set_debug_updates ()">gdk_window_set_debug_updates</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-enable-synchronized-configure" title="gdk_window_enable_synchronized_configure ()">gdk_window_enable_synchronized_configure</a> - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-configure-finished" title="gdk_window_configure_finished ()">gdk_window_configure_finished</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); - -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-user-data" title="gdk_window_set_user_data ()">gdk_window_set_user_data</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-override-redirect" title="gdk_window_set_override_redirect ()">gdk_window_set_override_redirect</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> override_redirect</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-accept-focus" title="gdk_window_set_accept_focus ()">gdk_window_set_accept_focus</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> accept_focus</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-accept-focus" title="gdk_window_get_accept_focus ()">gdk_window_get_accept_focus</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-focus-on-map" title="gdk_window_set_focus_on_map ()">gdk_window_set_focus_on_map</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> focus_on_map</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-focus-on-map" title="gdk_window_get_focus_on_map ()">gdk_window_get_focus_on_map</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-add-filter" title="gdk_window_add_filter ()">gdk_window_add_filter</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-remove-filter" title="gdk_window_remove_filter ()">gdk_window_remove_filter</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); -<a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="returnvalue">GdkFilterReturn</span></a> (<a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()">*GdkFilterFunc</a>) (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkXEvent" title="GdkXEvent"><span class="type">GdkXEvent</span></a> *xevent</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); -enum <a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn">GdkFilterReturn</a>; -typedef <a class="link" href="gdk3-Windows.html#GdkXEvent" title="GdkXEvent">GdkXEvent</a>; -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()">gdk_window_shape_combine_region</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-child-shapes" title="gdk_window_set_child_shapes ()">gdk_window_set_child_shapes</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-shapes" title="gdk_window_merge_child_shapes ()">gdk_window_merge_child_shapes</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-input-shape-combine-region" title="gdk_window_input_shape_combine_region ()">gdk_window_input_shape_combine_region</a> - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-child-input-shapes" title="gdk_window_set_child_input_shapes ()">gdk_window_set_child_input_shapes</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-input-shapes" title="gdk_window_merge_child_input_shapes ()">gdk_window_merge_child_input_shapes</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-set-static-gravities" title="gdk_window_set_static_gravities ()">gdk_window_set_static_gravities</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_static</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()">gdk_window_set_title</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-background" title="gdk_window_set_background ()">gdk_window_set_background</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *color</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-background-rgba" title="gdk_window_set_background_rgba ()">gdk_window_set_background_rgba</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-RGBA-Colors.html#GdkRGBA" title="GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-background-pattern" title="gdk_window_set_background_pattern ()">gdk_window_set_background_pattern</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>); -<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="returnvalue">cairo_pattern_t</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-background-pattern" title="gdk_window_get_background_pattern ()">gdk_window_get_background_pattern</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -#define <a class="link" href="gdk3-Windows.html#GDK-PARENT-RELATIVE:CAPS" title="GDK_PARENT_RELATIVE">GDK_PARENT_RELATIVE</a> -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()">gdk_window_set_cursor</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>); -<a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-cursor" title="gdk_window_get_cursor ()">gdk_window_get_cursor</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-user-data" title="gdk_window_get_user_data ()">gdk_window_get_user_data</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()">gdk_window_get_geometry</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-geometry-hints" title="gdk_window_set_geometry_hints ()">gdk_window_set_geometry_hints</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints"><span class="type">GdkWindowHints</span></a> geom_mask</code></em>); -<span class="returnvalue">int</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-width" title="gdk_window_get_width ()">gdk_window_get_width</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">int</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-height" title="gdk_window_get_height ()">gdk_window_get_height</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-icon-list" title="gdk_window_set_icon_list ()">gdk_window_set_icon_list</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *pixbufs</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-modal-hint" title="gdk_window_set_modal_hint ()">gdk_window_set_modal_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> modal</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-modal-hint" title="gdk_window_get_modal_hint ()">gdk_window_get_modal_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()">gdk_window_set_type_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> hint</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-type-hint" title="gdk_window_get_type_hint ()">gdk_window_get_type_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-skip-taskbar-hint" title="gdk_window_set_skip_taskbar_hint ()">gdk_window_set_skip_taskbar_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> skips_taskbar</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-skip-pager-hint" title="gdk_window_set_skip_pager_hint ()">gdk_window_set_skip_pager_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> skips_pager</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-urgency-hint" title="gdk_window_set_urgency_hint ()">gdk_window_set_urgency_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()">gdk_window_get_position</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-root-origin" title="gdk_window_get_root_origin ()">gdk_window_get_root_origin</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-frame-extents" title="gdk_window_get_frame_extents ()">gdk_window_get_frame_extents</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()">gdk_window_get_origin</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-get-root-coords" title="gdk_window_get_root_coords ()">gdk_window_get_root_coords</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *root_y</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-pointer" title="gdk_window_get_pointer ()">gdk_window_get_pointer</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-device-position" title="gdk_window_get_device_position ()">gdk_window_get_device_position</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>); -enum <a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType">GdkModifierType</a>; -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()">gdk_window_get_parent</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()">gdk_window_get_toplevel</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</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="gdk3-Windows.html#gdk-window-get-children" title="gdk_window_get_children ()">gdk_window_get_children</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</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="gdk3-Windows.html#gdk-window-peek-children" title="gdk_window_peek_children ()">gdk_window_peek_children</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-events" title="gdk_window_get_events ()">gdk_window_get_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()">gdk_window_set_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-icon-name" title="gdk_window_set_icon_name ()">gdk_window_set_icon_name</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-transient-for" title="gdk_window_set_transient_for ()">gdk_window_set_transient_for</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-role" title="gdk_window_set_role ()">gdk_window_set_role</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *role</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-startup-id" title="gdk_window_set_startup_id ()">gdk_window_set_startup_id</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-group" title="gdk_window_set_group ()">gdk_window_set_group</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *leader</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-group" title="gdk_window_get_group ()">gdk_window_get_group</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-decorations" title="gdk_window_set_decorations ()">gdk_window_set_decorations</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> decorations</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-decorations" title="gdk_window_get_decorations ()">gdk_window_get_decorations</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> *decorations</code></em>); -enum <a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration">GdkWMDecoration</a>; -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-functions" title="gdk_window_set_functions ()">gdk_window_set_functions</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction"><span class="type">GdkWMFunction</span></a> functions</code></em>); -enum <a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction">GdkWMFunction</a>; -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-get-default-root-window" title="gdk_get_default_root_window ()">gdk_get_default_root_window</a> (<em class="parameter"><code><span class="type">void</span></code></em>); - -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-support-multidevice" title="gdk_window_get_support_multidevice ()">gdk_window_get_support_multidevice</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-support-multidevice" title="gdk_window_set_support_multidevice ()">gdk_window_set_support_multidevice</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_multidevice</code></em>); -<a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-device-cursor" title="gdk_window_get_device_cursor ()">gdk_window_get_device_cursor</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-device-cursor" title="gdk_window_set_device_cursor ()">gdk_window_set_device_cursor</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>); -<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-device-events" title="gdk_window_get_device_events ()">gdk_window_get_device_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-device-events" title="gdk_window_set_device_events ()">gdk_window_set_device_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>); -<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> <a class="link" href="gdk3-Windows.html#gdk-window-get-source-events" title="gdk_window_get_source_events ()">gdk_window_get_source_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-set-source-events" title="gdk_window_set_source_events ()">gdk_window_set_source_events</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>); - -<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="returnvalue">cairo_surface_t</span></a> * <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()">gdk_offscreen_window_get_surface</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-set-embedder" title="gdk_offscreen_window_set_embedder ()">gdk_offscreen_window_set_embedder</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *embedder</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()">gdk_offscreen_window_get_embedder</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-geometry-changed" title="gdk_window_geometry_changed ()">gdk_window_geometry_changed</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-coords-from-parent" title="gdk_window_coords_from_parent ()">gdk_window_coords_from_parent</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> parent_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> parent_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gdk3-Windows.html#gdk-window-coords-to-parent" title="gdk_window_coords_to_parent ()">gdk_window_coords_to_parent</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *parent_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *parent_y</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()">gdk_window_get_effective_parent</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-toplevel" title="gdk_window_get_effective_toplevel ()">gdk_window_get_effective_toplevel</a> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.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> - +----GdkWindow -</pre> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.properties"></a><h2>Properties</h2> -<pre class="synopsis"> - "<a class="link" href="gdk3-Windows.html#GdkWindow--cursor" title='The "cursor" property'>cursor</a>" <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>* : Read / Write -</pre> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.signals"></a><h2>Signals</h2> -<pre class="synopsis"> - "<a class="link" href="gdk3-Windows.html#GdkWindow-create-surface" title='The "create-surface" signal'>create-surface</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="gdk3-Windows.html#GdkWindow-from-embedder" title='The "from-embedder" signal'>from-embedder</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="gdk3-Windows.html#GdkWindow-pick-embedded-child" title='The "pick-embedded-child" signal'>pick-embedded-child</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="gdk3-Windows.html#GdkWindow-to-embedder" title='The "to-embedder" signal'>to-embedder</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="gdk3-Windows.description"></a><h2>Description</h2> -<p> -A <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> is a (usually) rectangular region on the screen. -It's a low-level object, used to implement high-level objects such as -<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="type">GtkWidget</span></a> and <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> on the GTK+ level. A <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> is a toplevel -window, the thing a user might think of as a "window" with a titlebar and -so on; a <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> may contain many <a href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a>. For example, each -<a href="http://library.gnome.org/devel/gtk3/GtkButton.html"><span class="type">GtkButton</span></a> has a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> associated with it. -</p> -<p> -</p> -<div class="refsect2"> -<a name="COMPOSITED-WINDOWS"></a><h3>Composited Windows</h3> -<p> -Normally, the windowing system takes care of rendering the contents of a -child window onto its parent window. This mechanism can be intercepted by -calling <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</code></a> on the child window. For a -<em class="firstterm">composited</em> window it is the responsibility of the -application to render the window contents at the right spot. -</p> -<div class="example"> -<a name="composited-window-example"></a><p class="title"><b>Example 4. Composited windows</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">FIXME</span><span class="symbol">:</span><span class="normal"> MISSING XINCLUDE CONTENT</span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<br class="example-break"><p> -In the example <a class="xref" href="gdk3-Windows.html#composited-window-example" title="Example 4. Composited windows">Example 4, “Composited windows”</a>, a button is -placed inside of an event box inside of a window. The event box is set as -composited and therefore is no longer automatically drawn to the screen. -</p> -<p> -When the contents of the event box change, an expose event is generated on -its parent window (which, in this case, belongs to the toplevel <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>). -The expose handler for this widget is responsible for merging the changes -back on the screen in the way that it wishes. -</p> -<p> -In our case, we merge the contents with a 50% transparency. We also set the -background colour of the window to red. The effect is that the background -shows through the button. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="OFFSCREEN-WINDOWS"></a><h3>Offscreen Windows</h3> -<p> -Offscreen windows are more general than composited windows, since they allow -not only to modify the rendering of the child window onto its parent, but -also to apply coordinate transformations. -</p> -<p> -To integrate an offscreen window into a window hierarchy, one has to call -<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-set-embedder" title="gdk_offscreen_window_set_embedder ()"><code class="function">gdk_offscreen_window_set_embedder()</code></a> and handle a number of signals. The -<a class="link" href="gdk3-Windows.html#GdkWindow-pick-embedded-child" title='The "pick-embedded-child" signal'><span class="type">"pick-embedded-child"</span></a> signal on the embedder window is used to -select an offscreen child at given coordinates, and the -<a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title='The "to-embedder" signal'><span class="type">"to-embedder"</span></a> and <a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title='The "from-embedder" signal'><span class="type">"from-embedder"</span></a> signals on the -offscreen window are used to translate coordinates between the embedder and -the offscreen window. -</p> -<p> -For rendering an offscreen window onto its embedder, the contents of the -offscreen window are available as a surface, via -<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()"><code class="function">gdk_offscreen_window_get_surface()</code></a>. -</p> -</div> -<p> -</p> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GdkWindow-struct"></a><h3>GdkWindow</h3> -<pre class="programlisting">typedef struct _GdkWindow GdkWindow;</pre> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowType"></a><h3>enum GdkWindowType</h3> -<pre class="programlisting">typedef enum { - GDK_WINDOW_ROOT, - GDK_WINDOW_TOPLEVEL, - GDK_WINDOW_CHILD, - GDK_WINDOW_TEMP, - GDK_WINDOW_FOREIGN, - GDK_WINDOW_OFFSCREEN -} GdkWindowType; -</pre> -<p> -Describes the kind of window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-WINDOW-ROOT:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_ROOT</code></span></p></td> -<td>root window; this window has no parent, covers the entire - screen, and is created by the window system -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TOPLEVEL:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TOPLEVEL</code></span></p></td> -<td>toplevel window (used to implement <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>) -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-CHILD:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_CHILD</code></span></p></td> -<td>child window (used to implement e.g. <a href="http://library.gnome.org/devel/gtk3/GtkEntry.html"><span class="type">GtkEntry</span></a>) -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TEMP:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TEMP</code></span></p></td> -<td>override redirect temporary window (used to implement - <a href="http://library.gnome.org/devel/gtk3/GtkMenu.html"><span class="type">GtkMenu</span></a>) -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-FOREIGN:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_FOREIGN</code></span></p></td> -<td>foreign window (see <a href="http://library.gnome.org/devel/gdk3/gdk-X-Window-System-Interaction.html#gdk-window-foreign-new"><code class="function">gdk_window_foreign_new()</code></a>) -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-OFFSCREEN:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_OFFSCREEN</code></span></p></td> -<td>offscreen window (see - <a class="xref" href="gdk3-Windows.html#OFFSCREEN-WINDOWS" title="Offscreen Windows">the section called “Offscreen Windows”</a>). Since 2.18 -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowWindowClass"></a><h3>enum GdkWindowWindowClass</h3> -<pre class="programlisting">typedef enum { - GDK_INPUT_OUTPUT, /*< nick=input-output >*/ - GDK_INPUT_ONLY /*< nick=input-only >*/ -} GdkWindowWindowClass; -</pre> -<p> -<em class="parameter"><code>GDK_INPUT_OUTPUT</code></em> windows are the standard kind of window you might expect. -Such windows receive events and are also displayed on screen. -<em class="parameter"><code>GDK_INPUT_ONLY</code></em> windows are invisible; they are usually placed above other -windows in order to trap or filter the events. You can't draw on -<em class="parameter"><code>GDK_INPUT_ONLY</code></em> windows. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-INPUT-OUTPUT:CAPS"></a><span class="term"><code class="literal">GDK_INPUT_OUTPUT</code></span></p></td> -<td>window for graphics and events -</td> -</tr> -<tr> -<td><p><a name="GDK-INPUT-ONLY:CAPS"></a><span class="term"><code class="literal">GDK_INPUT_ONLY</code></span></p></td> -<td>window for events only -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowHints"></a><h3>enum GdkWindowHints</h3> -<pre class="programlisting">typedef enum { - GDK_HINT_POS = 1 << 0, - GDK_HINT_MIN_SIZE = 1 << 1, - GDK_HINT_MAX_SIZE = 1 << 2, - GDK_HINT_BASE_SIZE = 1 << 3, - GDK_HINT_ASPECT = 1 << 4, - GDK_HINT_RESIZE_INC = 1 << 5, - GDK_HINT_WIN_GRAVITY = 1 << 6, - GDK_HINT_USER_POS = 1 << 7, - GDK_HINT_USER_SIZE = 1 << 8 -} GdkWindowHints; -</pre> -<p> -Used to indicate which fields of a <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> struct should be paid -attention to. Also, the presence/absence of <em class="parameter"><code>GDK_HINT_POS</code></em>, -<em class="parameter"><code>GDK_HINT_USER_POS</code></em>, and <em class="parameter"><code>GDK_HINT_USER_SIZE</code></em> is significant, though they don't -directly refer to <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> fields. <em class="parameter"><code>GDK_HINT_USER_POS</code></em> will be set -automatically by <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> if you call <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-move"><code class="function">gtk_window_move()</code></a>. -<em class="parameter"><code>GDK_HINT_USER_POS</code></em> and <em class="parameter"><code>GDK_HINT_USER_SIZE</code></em> should be set if the user -specified a size/position using a --geometry command-line argument; -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-parse-geometry"><code class="function">gtk_window_parse_geometry()</code></a> automatically sets these flags. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-HINT-POS:CAPS"></a><span class="term"><code class="literal">GDK_HINT_POS</code></span></p></td> -<td>indicates that the program has positioned the window -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-MIN-SIZE:CAPS"></a><span class="term"><code class="literal">GDK_HINT_MIN_SIZE</code></span></p></td> -<td>min size fields are set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-MAX-SIZE:CAPS"></a><span class="term"><code class="literal">GDK_HINT_MAX_SIZE</code></span></p></td> -<td>max size fields are set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-BASE-SIZE:CAPS"></a><span class="term"><code class="literal">GDK_HINT_BASE_SIZE</code></span></p></td> -<td>base size fields are set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-ASPECT:CAPS"></a><span class="term"><code class="literal">GDK_HINT_ASPECT</code></span></p></td> -<td>aspect ratio fields are set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-RESIZE-INC:CAPS"></a><span class="term"><code class="literal">GDK_HINT_RESIZE_INC</code></span></p></td> -<td>resize increment fields are set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-WIN-GRAVITY:CAPS"></a><span class="term"><code class="literal">GDK_HINT_WIN_GRAVITY</code></span></p></td> -<td>window gravity field is set -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-USER-POS:CAPS"></a><span class="term"><code class="literal">GDK_HINT_USER_POS</code></span></p></td> -<td>indicates that the window's position was explicitly set - by the user -</td> -</tr> -<tr> -<td><p><a name="GDK-HINT-USER-SIZE:CAPS"></a><span class="term"><code class="literal">GDK_HINT_USER_SIZE</code></span></p></td> -<td>indicates that the window's size was explicitly set by - the user -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkGeometry"></a><h3>struct GdkGeometry</h3> -<pre class="programlisting">struct GdkGeometry { - gint min_width; - gint min_height; - gint max_width; - gint max_height; - gint base_width; - gint base_height; - gint width_inc; - gint height_inc; - gdouble min_aspect; - gdouble max_aspect; - GdkGravity win_gravity; -}; -</pre> -<p> -The <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> struct gives the window manager information about -a window's geometry constraints. Normally you would set these on -the GTK+ level using <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-geometry-hints"><code class="function">gtk_window_set_geometry_hints()</code></a>. <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> -then sets the hints on the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> it creates. -</p> -<p> -<a class="link" href="gdk3-Windows.html#gdk-window-set-geometry-hints" title="gdk_window_set_geometry_hints ()"><code class="function">gdk_window_set_geometry_hints()</code></a> expects the hints to be fully valid already -and simply passes them to the window manager; in contrast, -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-geometry-hints"><code class="function">gtk_window_set_geometry_hints()</code></a> performs some interpretation. For example, -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> will apply the hints to the geometry widget instead of the -toplevel window, if you set a geometry widget. Also, the -<em class="parameter"><code>min_width</code></em>/<em class="parameter"><code>min_height</code></em>/<em class="parameter"><code>max_width</code></em>/<em class="parameter"><code>max_height</code></em> fields may be set to -1, and -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> will substitute the size request of the window or geometry widget. -If the minimum size hint is not provided, <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> will use its requisition -as the minimum size. If the minimum size is provided and a geometry widget is -set, <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> will take the minimum size as the minimum size of the -geometry widget rather than the entire window. The base size is treated -similarly. -</p> -<p> -The canonical use-case for <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-geometry-hints"><code class="function">gtk_window_set_geometry_hints()</code></a> is to get a -terminal widget to resize properly. Here, the terminal text area should be -the geometry widget; <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> will then automatically set the base size to -the size of other widgets in the terminal window, such as the menubar and -scrollbar. Then, the <em class="parameter"><code>width_inc</code></em> and <em class="parameter"><code>height_inc</code></em> fields should be set to the -size of one character in the terminal. Finally, the base size should be set -to the size of one character. The net effect is that the minimum size of the -terminal will have a 1x1 character terminal area, and only terminal sizes on -the "character grid" will be allowed. -</p> -<p> -Here's an example of how the terminal example would be implemented, assuming -a terminal area widget called "terminal" and a toplevel window "toplevel": -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="usertype">GdkGeometry</span><span class="normal"> hints</span><span class="symbol">;</span> - -<span class="normal">hints</span><span class="symbol">.</span><span class="normal">base_width </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span> -<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">base_height </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span> -<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">min_width </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span> -<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">min_height </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span> -<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">width_inc </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span> -<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">height_inc </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span> - -<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-geometry-hints">gtk_window_set_geometry_hints</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toplevel</span><span class="symbol">),</span> -<span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">terminal</span><span class="symbol">),</span> -<span class="normal"> </span><span class="symbol">&</span><span class="normal">hints</span><span class="symbol">,</span> -<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-RESIZE-INC:CAPS">GDK_HINT_RESIZE_INC</a> </span><span class="symbol">|</span> -<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-MIN-SIZE:CAPS">GDK_HINT_MIN_SIZE</a> </span><span class="symbol">|</span> -<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-BASE-SIZE:CAPS">GDK_HINT_BASE_SIZE</a></span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -The other useful fields are the <em class="parameter"><code>min_aspect</code></em> and <em class="parameter"><code>max_aspect</code></em> fields; these -contain a width/height ratio as a floating point number. If a geometry widget -is set, the aspect applies to the geometry widget rather than the entire -window. The most common use of these hints is probably to set <em class="parameter"><code>min_aspect</code></em> and -<em class="parameter"><code>max_aspect</code></em> to the same value, thus forcing the window to keep a constant -aspect ratio. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.min-width"></a>min_width</code></em>;</span></p></td> -<td>minimum width of window (or -1 to use requisition, with -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> only)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.min-height"></a>min_height</code></em>;</span></p></td> -<td>minimum height of window (or -1 to use requisition, with -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> only)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.max-width"></a>max_width</code></em>;</span></p></td> -<td>maximum width of window (or -1 to use requisition, with -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> only)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.max-height"></a>max_height</code></em>;</span></p></td> -<td>maximum height of window (or -1 to use requisition, with -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> only)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.base-width"></a>base_width</code></em>;</span></p></td> -<td>allowed window widths are <em class="parameter"><code>base_width</code></em> + <em class="parameter"><code>width_inc</code></em> * N where N -is any integer (-1 allowed with <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.base-height"></a>base_height</code></em>;</span></p></td> -<td>allowed window widths are <em class="parameter"><code>base_height</code></em> + <em class="parameter"><code>height_inc</code></em> * N where -N is any integer (-1 allowed with <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.width-inc"></a>width_inc</code></em>;</span></p></td> -<td>width resize increment</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkGeometry.height-inc"></a>height_inc</code></em>;</span></p></td> -<td>height resize increment</td> -</tr> -<tr> -<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="GdkGeometry.min-aspect"></a>min_aspect</code></em>;</span></p></td> -<td>minimum width/height ratio</td> -</tr> -<tr> -<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="GdkGeometry.max-aspect"></a>max_aspect</code></em>;</span></p></td> -<td>maximum width/height ratio</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity"><span class="type">GdkGravity</span></a> <em class="structfield"><code><a name="GdkGeometry.win-gravity"></a>win_gravity</code></em>;</span></p></td> -<td>window gravity, see <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-gravity"><code class="function">gtk_window_set_gravity()</code></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkGravity"></a><h3>enum GdkGravity</h3> -<pre class="programlisting">typedef enum { - GDK_GRAVITY_NORTH_WEST = 1, - GDK_GRAVITY_NORTH, - GDK_GRAVITY_NORTH_EAST, - GDK_GRAVITY_WEST, - GDK_GRAVITY_CENTER, - GDK_GRAVITY_EAST, - GDK_GRAVITY_SOUTH_WEST, - GDK_GRAVITY_SOUTH, - GDK_GRAVITY_SOUTH_EAST, - GDK_GRAVITY_STATIC -} GdkGravity; -</pre> -<p> -Defines the reference point of a window and the meaning of coordinates -passed to <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-move"><code class="function">gtk_window_move()</code></a>. See <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-move"><code class="function">gtk_window_move()</code></a> and the "implementation -notes" section of the -<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended -Window Manager Hints</a> specification for more details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-GRAVITY-NORTH-WEST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></span></p></td> -<td>the reference point is at the top left corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-NORTH:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_NORTH</code></span></p></td> -<td>the reference point is in the middle of the top edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-NORTH-EAST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_NORTH_EAST</code></span></p></td> -<td>the reference point is at the top right corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-WEST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_WEST</code></span></p></td> -<td>the reference point is at the middle of the left edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-CENTER:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_CENTER</code></span></p></td> -<td>the reference point is at the center of the window. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-EAST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_EAST</code></span></p></td> -<td>the reference point is at the middle of the right edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-SOUTH-WEST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_SOUTH_WEST</code></span></p></td> -<td>the reference point is at the lower left corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-SOUTH:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_SOUTH</code></span></p></td> -<td>the reference point is at the middle of the lower edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-SOUTH-EAST:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_SOUTH_EAST</code></span></p></td> -<td>the reference point is at the lower right corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-GRAVITY-STATIC:CAPS"></a><span class="term"><code class="literal">GDK_GRAVITY_STATIC</code></span></p></td> -<td>the reference point is at the top left corner of the - window itself, ignoring window manager decorations. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowEdge"></a><h3>enum GdkWindowEdge</h3> -<pre class="programlisting">typedef enum { - GDK_WINDOW_EDGE_NORTH_WEST, - GDK_WINDOW_EDGE_NORTH, - GDK_WINDOW_EDGE_NORTH_EAST, - GDK_WINDOW_EDGE_WEST, - GDK_WINDOW_EDGE_EAST, - GDK_WINDOW_EDGE_SOUTH_WEST, - GDK_WINDOW_EDGE_SOUTH, - GDK_WINDOW_EDGE_SOUTH_EAST -} GdkWindowEdge; -</pre> -<p> -Determines a window edge or corner. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-NORTH-WEST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_NORTH_WEST</code></span></p></td> -<td>the top left corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-NORTH:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_NORTH</code></span></p></td> -<td>the top edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-NORTH-EAST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_NORTH_EAST</code></span></p></td> -<td>the top right corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-WEST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_WEST</code></span></p></td> -<td>the left edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-EAST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_EAST</code></span></p></td> -<td>the right edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-SOUTH-WEST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_SOUTH_WEST</code></span></p></td> -<td>the lower left corner. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-SOUTH:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_SOUTH</code></span></p></td> -<td>the lower edge. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-EDGE-SOUTH-EAST:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_EDGE_SOUTH_EAST</code></span></p></td> -<td>the lower right corner. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowTypeHint"></a><h3>enum GdkWindowTypeHint</h3> -<pre class="programlisting">typedef enum { - GDK_WINDOW_TYPE_HINT_NORMAL, - GDK_WINDOW_TYPE_HINT_DIALOG, - GDK_WINDOW_TYPE_HINT_MENU, /* Torn off menu */ - GDK_WINDOW_TYPE_HINT_TOOLBAR, - GDK_WINDOW_TYPE_HINT_SPLASHSCREEN, - GDK_WINDOW_TYPE_HINT_UTILITY, - GDK_WINDOW_TYPE_HINT_DOCK, - GDK_WINDOW_TYPE_HINT_DESKTOP, - GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU, /* A drop down menu (from a menubar) */ - GDK_WINDOW_TYPE_HINT_POPUP_MENU, /* A popup menu (from right-click) */ - GDK_WINDOW_TYPE_HINT_TOOLTIP, - GDK_WINDOW_TYPE_HINT_NOTIFICATION, - GDK_WINDOW_TYPE_HINT_COMBO, - GDK_WINDOW_TYPE_HINT_DND -} GdkWindowTypeHint; -</pre> -<p> -These are hints for the window manager that indicate what type of function -the window has. The window manager can use this when determining decoration -and behaviour of the window. The hint must be set before mapping the window. -</p> -<p> -See the -<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended -Window Manager Hints</a> specification for more details about -window types. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-NORMAL:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_NORMAL</code></span></p></td> -<td>Normal toplevel window. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-DIALOG:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_DIALOG</code></span></p></td> -<td>Dialog window. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-MENU:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_MENU</code></span></p></td> -<td>Window used to implement a menu; GTK+ uses - this hint only for torn-off menus, see <a href="http://library.gnome.org/devel/gtk3/GtkTearoffMenuItem.html"><span class="type">GtkTearoffMenuItem</span></a>. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-TOOLBAR:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_TOOLBAR</code></span></p></td> -<td>Window used to implement toolbars. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-SPLASHSCREEN:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_SPLASHSCREEN</code></span></p></td> -<td>Window used to display a splash - screen during application startup. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-UTILITY:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_UTILITY</code></span></p></td> -<td>Utility windows which are not detached - toolbars or dialogs. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-DOCK:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_DOCK</code></span></p></td> -<td>Used for creating dock or panel windows. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-DESKTOP:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_DESKTOP</code></span></p></td> -<td>Used for creating the desktop background - window. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-DROPDOWN-MENU:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU</code></span></p></td> -<td>A menu that belongs to a menubar. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-POPUP-MENU:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_POPUP_MENU</code></span></p></td> -<td>A menu that does not belong to a menubar, - e.g. a context menu. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-TOOLTIP:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_TOOLTIP</code></span></p></td> -<td>A tooltip. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-NOTIFICATION:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_NOTIFICATION</code></span></p></td> -<td>A notification - typically a "bubble" - that belongs to a status icon. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-COMBO:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_COMBO</code></span></p></td> -<td>A popup from a combo box. -</td> -</tr> -<tr> -<td><p><a name="GDK-WINDOW-TYPE-HINT-DND:CAPS"></a><span class="term"><code class="literal">GDK_WINDOW_TYPE_HINT_DND</code></span></p></td> -<td>A window that is used to implement a DND cursor. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowAttr"></a><h3>struct GdkWindowAttr</h3> -<pre class="programlisting">struct GdkWindowAttr { - gchar *title; - gint event_mask; - gint x, y; - gint width; - gint height; - GdkWindowWindowClass wclass; - GdkVisual *visual; - GdkWindowType window_type; - GdkCursor *cursor; - gchar *wmclass_name; - gchar *wmclass_class; - gboolean override_redirect; - GdkWindowTypeHint type_hint; -}; -</pre> -<p> -Attributes to use for a newly-created window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.title"></a>title</code></em>;</span></p></td> -<td>title of the window (for toplevel windows)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.event-mask"></a>event_mask</code></em>;</span></p></td> -<td>event mask (see <a class="link" href="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()"><code class="function">gdk_window_set_events()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.x"></a>x</code></em>;</span></p></td> -<td>X coordinate relative to parent window (see <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.y"></a>y</code></em>;</span></p></td> -<td>Y coordinate relative to parent window (see <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.width"></a>width</code></em>;</span></p></td> -<td>width of window</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.height"></a>height</code></em>;</span></p></td> -<td>height of window</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Windows.html#GdkWindowWindowClass" title="enum GdkWindowWindowClass"><span class="type">GdkWindowWindowClass</span></a> <em class="structfield"><code><a name="GdkWindowAttr.wclass"></a>wclass</code></em>;</span></p></td> -<td> -<a class="link" href="gdk3-Windows.html#GDK-INPUT-OUTPUT:CAPS"><span class="type">GDK_INPUT_OUTPUT</span></a> (normal window) or <a class="link" href="gdk3-Windows.html#GDK-INPUT-ONLY:CAPS"><span class="type">GDK_INPUT_ONLY</span></a> (invisible -window that receives events)</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.visual"></a>visual</code></em>;</span></p></td> -<td> -<a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> for window</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="type">GdkWindowType</span></a> <em class="structfield"><code><a name="GdkWindowAttr.window-type"></a>window_type</code></em>;</span></p></td> -<td>type of window</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.cursor"></a>cursor</code></em>;</span></p></td> -<td>cursor for the window (see <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.wmclass-name"></a>wmclass_name</code></em>;</span></p></td> -<td>don't use (see <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-wmclass"><code class="function">gtk_window_set_wmclass()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.wmclass-class"></a>wmclass_class</code></em>;</span></p></td> -<td>don't use (see <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-wmclass"><code class="function">gtk_window_set_wmclass()</code></a>)</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GdkWindowAttr.override-redirect"></a>override_redirect</code></em>;</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to bypass the window manager</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.type-hint"></a>type_hint</code></em>;</span></p></td> -<td>a hint of the function of the window</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowAttributesType"></a><h3>enum GdkWindowAttributesType</h3> -<pre class="programlisting">typedef enum { - GDK_WA_TITLE = 1 << 1, - GDK_WA_X = 1 << 2, - GDK_WA_Y = 1 << 3, - GDK_WA_CURSOR = 1 << 4, - GDK_WA_VISUAL = 1 << 5, - GDK_WA_WMCLASS = 1 << 6, - GDK_WA_NOREDIR = 1 << 7, - GDK_WA_TYPE_HINT = 1 << 8 -} GdkWindowAttributesType; -</pre> -<p> -Used to indicate which fields in the <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> struct should be honored. -For example, if you filled in the "cursor" and "x" fields of <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a>, -pass "<em class="parameter"><code>GDK_WA_X</code></em> | <em class="parameter"><code>GDK_WA_CURSOR</code></em>" to <a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()"><code class="function">gdk_window_new()</code></a>. Fields in -<a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> not covered by a bit in this enum are required; for example, -the <em class="parameter"><code>width</code></em>/<em class="parameter"><code>height</code></em>, <em class="parameter"><code>wclass</code></em>, and <em class="parameter"><code>window_type</code></em> fields are required, they have -no corresponding flag in <a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType"><span class="type">GdkWindowAttributesType</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-WA-TITLE:CAPS"></a><span class="term"><code class="literal">GDK_WA_TITLE</code></span></p></td> -<td>Honor the title field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-X:CAPS"></a><span class="term"><code class="literal">GDK_WA_X</code></span></p></td> -<td>Honor the X coordinate field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-Y:CAPS"></a><span class="term"><code class="literal">GDK_WA_Y</code></span></p></td> -<td>Honor the Y coordinate field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-CURSOR:CAPS"></a><span class="term"><code class="literal">GDK_WA_CURSOR</code></span></p></td> -<td>Honor the cursor field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-VISUAL:CAPS"></a><span class="term"><code class="literal">GDK_WA_VISUAL</code></span></p></td> -<td>Honor the visual field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-WMCLASS:CAPS"></a><span class="term"><code class="literal">GDK_WA_WMCLASS</code></span></p></td> -<td>Honor the wmclass_class and wmclass_name fields -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-NOREDIR:CAPS"></a><span class="term"><code class="literal">GDK_WA_NOREDIR</code></span></p></td> -<td>Honor the override_redirect field -</td> -</tr> -<tr> -<td><p><a name="GDK-WA-TYPE-HINT:CAPS"></a><span class="term"><code class="literal">GDK_WA_TYPE_HINT</code></span></p></td> -<td>Honor the type_hint field -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-new"></a><h3>gdk_window_new ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_new (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> *attributes</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> attributes_mask</code></em>);</pre> -<p> -Creates a new <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> using the attributes from -<em class="parameter"><code>attributes</code></em>. See <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> and <a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType"><span class="type">GdkWindowAttributesType</span></a> for -more details. Note: to use this on displays other than the default -display, <em class="parameter"><code>parent</code></em> must be specified. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to create the window as a child of -the default root window for the default display. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>attributes</code></em> :</span></p></td> -<td>attributes of the new window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>attributes_mask</code></em> :</span></p></td> -<td>mask indicating which fields in <em class="parameter"><code>attributes</code></em> are valid</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the new <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-destroy"></a><h3>gdk_window_destroy ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_destroy (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Destroys the window system resources associated with <em class="parameter"><code>window</code></em> and decrements <em class="parameter"><code>window</code></em>'s -reference count. The window system resources for all children of <em class="parameter"><code>window</code></em> are also -destroyed, but the children's reference counts are not decremented. -</p> -<p> -Note that a window will not be destroyed automatically when its reference count -reaches zero. You must call this function yourself before that happens. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-window-type"></a><h3>gdk_window_get_window_type ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="returnvalue">GdkWindowType</span></a> gdk_window_get_window_type (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the type of the window. See <a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="type">GdkWindowType</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>type of window</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-display"></a><h3>gdk_window_get_display ()</h3> -<pre class="programlisting"><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> * gdk_window_get_display (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> associated with a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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> associated with <em class="parameter"><code>window</code></em>. <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 2.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-screen"></a><h3>gdk_window_get_screen ()</h3> -<pre class="programlisting"><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="returnvalue">GdkScreen</span></a> * gdk_window_get_screen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> associated with a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> associated with <em class="parameter"><code>window</code></em>. <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 2.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-visual"></a><h3>gdk_window_get_visual ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="returnvalue">GdkVisual</span></a> * gdk_window_get_visual (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the <a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> describing the pixel format of <em class="parameter"><code>window</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a>. <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 2.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-at-pointer"></a><h3>gdk_window_at_pointer ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_at_pointer (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *win_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *win_y</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gdk_window_at_pointer</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDevice.html#gdk-device-get-window-at-position" title="gdk_device_get_window_at_position ()"><code class="function">gdk_device_get_window_at_position()</code></a> instead.</p> -</div> -<p> -Obtains the window underneath the mouse pointer, returning the -location of that window in <em class="parameter"><code>win_x</code></em>, <em class="parameter"><code>win_y</code></em>. Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the -window under the mouse pointer is not known to GDK (if the window -belongs to another application and a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> hasn't been created -for it with <a href="http://library.gnome.org/devel/gdk3/gdk-X-Window-System-Interaction.html#gdk-window-foreign-new"><code class="function">gdk_window_foreign_new()</code></a>) -</p> -<p> -NOTE: For multihead-aware widgets or applications use -<a class="link" href="GdkDisplay.html#gdk-display-get-window-at-pointer" title="gdk_display_get_window_at_pointer ()"><code class="function">gdk_display_get_window_at_pointer()</code></a> instead. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>win_x</code></em> :</span></p></td> -<td>return location for origin of the window under the pointer. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>win_y</code></em> :</span></p></td> -<td>return location for origin of the window under the pointer. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>window under the mouse pointer. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-show"></a><h3>gdk_window_show ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_show (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Like <a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</code></a>, but also raises the window to the -top of the window stack (moves the window to the front of the -Z-order). -</p> -<p> -This function maps a window so it's visible onscreen. Its opposite -is <a class="link" href="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()"><code class="function">gdk_window_hide()</code></a>. -</p> -<p> -When implementing a <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="type">GtkWidget</span></a>, you should call this function on the widget's -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as part of the "map" method. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-show-unraised"></a><h3>gdk_window_show_unraised ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_show_unraised (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Shows a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> onscreen, but does not modify its stacking -order. In contrast, <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> will raise the window -to the top of the window stack. -</p> -<p> -On the X11 platform, in Xlib terms, this function calls -<code class="function">XMapWindow()</code> (it also updates some internal GDK state, which means -that you can't really use <code class="function">XMapWindow()</code> directly on a GDK window). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-hide"></a><h3>gdk_window_hide ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_hide (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -For toplevel windows, withdraws them, so they will no longer be -known to the window manager; for all windows, unmaps them, so -they won't be displayed. Normally done automatically as -part of <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-hide"><code class="function">gtk_widget_hide()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-is-destroyed"></a><h3>gdk_window_is_destroyed ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_is_destroyed (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Check to see if a window is destroyed.. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is destroyed</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-is-visible"></a><h3>gdk_window_is_visible ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_is_visible (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Checks whether the window has been mapped (with <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> or -<a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is mapped</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-is-viewable"></a><h3>gdk_window_is_viewable ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_is_viewable (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Check if the window and all ancestors of the window are -mapped. (This is not necessarily "viewable" in the X sense, since -we only check as far as we have GDK window parents, not to the root -window.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is viewable</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-is-input-only"></a><h3>gdk_window_is_input_only ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_is_input_only (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether or not the window is an input only window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>window</code></em> is input only</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-is-shaped"></a><h3>gdk_window_is_shaped ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_is_shaped (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether or not the window is shaped. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>window</code></em> is shaped</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-state"></a><h3>gdk_window_get_state ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="returnvalue">GdkWindowState</span></a> gdk_window_get_state (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the bitwise OR of the currently active window state flags, -from the <a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="type">GdkWindowState</span></a> enumeration. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>window state bitfield</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-withdraw"></a><h3>gdk_window_withdraw ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_withdraw (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Withdraws a window (unmaps it and asks the window manager to forget about it). -This function is not really useful as <a class="link" href="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()"><code class="function">gdk_window_hide()</code></a> automatically -withdraws toplevel windows before hiding them. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-iconify"></a><h3>gdk_window_iconify ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_iconify (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Asks to iconify (minimize) <em class="parameter"><code>window</code></em>. The window manager may choose -to ignore the request, but normally will honor it. Using -<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-iconify"><code class="function">gtk_window_iconify()</code></a> is preferred, if you have a <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> widget. -</p> -<p> -This function only makes sense when <em class="parameter"><code>window</code></em> is a toplevel window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-deiconify"></a><h3>gdk_window_deiconify ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_deiconify (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Attempt to deiconify (unminimize) <em class="parameter"><code>window</code></em>. On X11 the window manager may -choose to ignore the request to deiconify. When using GTK+, -use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-deiconify"><code class="function">gtk_window_deiconify()</code></a> instead of the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> variant. Or better yet, -you probably want to use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-present"><code class="function">gtk_window_present()</code></a>, which raises the window, focuses it, -unminimizes it, and puts it on the current desktop. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-stick"></a><h3>gdk_window_stick ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_stick (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -"Pins" a window such that it's on all workspaces and does not scroll -with viewports, for window managers that have scrollable viewports. -(When using <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>, <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-stick"><code class="function">gtk_window_stick()</code></a> may be more useful.) -</p> -<p> -On the X11 platform, this function depends on window manager -support, so may have no effect with many window managers. However, -GDK will do the best it can to convince the window manager to stick -the window. For window managers that don't support this operation, -there's nothing you can do to force it to happen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-unstick"></a><h3>gdk_window_unstick ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_unstick (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Reverse operation for <a class="link" href="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()"><code class="function">gdk_window_stick()</code></a>; see <a class="link" href="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()"><code class="function">gdk_window_stick()</code></a>, -and <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-unstick"><code class="function">gtk_window_unstick()</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>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-maximize"></a><h3>gdk_window_maximize ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_maximize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Maximizes the window. If the window was already maximized, then -this function does nothing. -</p> -<p> -On X11, asks the window manager to maximize <em class="parameter"><code>window</code></em>, if the window -manager supports this operation. Not all window managers support -this, and some deliberately ignore it or don't have a concept of -"maximized"; so you can't rely on the maximization actually -happening. But it will happen with most standard window managers, -and GDK makes a best effort to get it to happen. -</p> -<p> -On Windows, reliably maximizes the window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-unmaximize"></a><h3>gdk_window_unmaximize ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_unmaximize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Unmaximizes the window. If the window wasn't maximized, then this -function does nothing. -</p> -<p> -On X11, asks the window manager to unmaximize <em class="parameter"><code>window</code></em>, if the -window manager supports this operation. Not all window managers -support this, and some deliberately ignore it or don't have a -concept of "maximized"; so you can't rely on the unmaximization -actually happening. But it will happen with most standard window -managers, and GDK makes a best effort to get it to happen. -</p> -<p> -On Windows, reliably unmaximizes the window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-fullscreen"></a><h3>gdk_window_fullscreen ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_fullscreen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Moves the window into fullscreen mode. This means the -window covers the entire screen and is above any panels -or task bars. -</p> -<p> -If the window was already fullscreen, then this function does nothing. -</p> -<p> -On X11, asks the window manager to put <em class="parameter"><code>window</code></em> in a fullscreen -state, if the window manager supports this operation. Not all -window managers support this, and some deliberately ignore it or -don't have a concept of "fullscreen"; so you can't rely on the -fullscreenification actually happening. But it will happen with -most standard window managers, and GDK makes a best effort to get -it to happen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-unfullscreen"></a><h3>gdk_window_unfullscreen ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_unfullscreen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Moves the window out of fullscreen mode. If the window was not -fullscreen, does nothing. -</p> -<p> -On X11, asks the window manager to move <em class="parameter"><code>window</code></em> out of the fullscreen -state, if the window manager supports this operation. Not all -window managers support this, and some deliberately ignore it or -don't have a concept of "fullscreen"; so you can't rely on the -unfullscreenification actually happening. But it will happen with -most standard window managers, and GDK makes a best effort to get -it to happen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-keep-above"></a><h3>gdk_window_set_keep_above ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_keep_above (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -Set if <em class="parameter"><code>window</code></em> must be kept above other windows. If the -window was already above, then this function does nothing. -</p> -<p> -On X11, asks the window manager to keep <em class="parameter"><code>window</code></em> above, if the window -manager supports this operation. Not all window managers support -this, and some deliberately ignore it or don't have a concept of -"keep above"; so you can't rely on the window being kept above. -But it will happen with most standard window managers, -and GDK makes a best effort to get it to happen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td>whether to keep <em class="parameter"><code>window</code></em> above other windows</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-keep-below"></a><h3>gdk_window_set_keep_below ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_keep_below (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -Set if <em class="parameter"><code>window</code></em> must be kept below other windows. If the -window was already below, then this function does nothing. -</p> -<p> -On X11, asks the window manager to keep <em class="parameter"><code>window</code></em> below, if the window -manager supports this operation. Not all window managers support -this, and some deliberately ignore it or don't have a concept of -"keep below"; so you can't rely on the window being kept below. -But it will happen with most standard window managers, -and GDK makes a best effort to get it to happen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td>whether to keep <em class="parameter"><code>window</code></em> below other windows</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-opacity"></a><h3>gdk_window_set_opacity ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_opacity (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> opacity</code></em>);</pre> -<p> -Request the windowing system to make <em class="parameter"><code>window</code></em> partially transparent, -with opacity 0 being fully transparent and 1 fully opaque. (Values -of the opacity parameter are clamped to the [0,1] range.) -</p> -<p> -On X11, this works only on X screens with a compositing manager -running. -</p> -<p> -For setting up per-pixel alpha, see <a class="link" href="GdkScreen.html#gdk-screen-get-rgba-visual" title="gdk_screen_get_rgba_visual ()"><code class="function">gdk_screen_get_rgba_visual()</code></a>. -For making non-toplevel windows translucent, see -<a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</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>window</code></em> :</span></p></td> -<td>a top-level <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>opacity</code></em> :</span></p></td> -<td>opacity</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-composited"></a><h3>gdk_window_set_composited ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_composited (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> composited</code></em>);</pre> -<p> -Sets a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as composited, or unsets it. Composited -windows do not automatically have their contents drawn to -the screen. Drawing is redirected to an offscreen buffer -and an expose event is emitted on the parent of the composited -window. It is the responsibility of the parent's expose handler -to manually merge the off-screen content onto the screen in -whatever way it sees fit. See <a class="xref" href="gdk3-Windows.html#composited-window-example" title="Example 4. Composited windows">Example 4, “Composited windows”</a> -for an example. -</p> -<p> -It only makes sense for child windows to be composited; see -<a class="link" href="gdk3-Windows.html#gdk-window-set-opacity" title="gdk_window_set_opacity ()"><code class="function">gdk_window_set_opacity()</code></a> if you need translucent toplevel -windows. -</p> -<p> -An additional effect of this call is that the area of this -window is no longer clipped from regions marked for -invalidation on its parent. Draws done on the parent -window are also no longer clipped by the child. -</p> -<p> -This call is only supported on some systems (currently, -only X11 with new enough Xcomposite and Xdamage extensions). -You must call <a class="link" href="GdkDisplay.html#gdk-display-supports-composite" title="gdk_display_supports_composite ()"><code class="function">gdk_display_supports_composite()</code></a> to check if -setting a window as composited is supported before -attempting to do so. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>composited</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to set the window as composited</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-composited"></a><h3>gdk_window_get_composited ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_composited (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether <em class="parameter"><code>window</code></em> is composited. -</p> -<p> -See <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is composited.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-move"></a><h3>gdk_window_move ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_move (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre> -<p> -Repositions a window relative to its parent window. -For toplevel windows, window managers may ignore or modify the move; -you should probably use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-move"><code class="function">gtk_window_move()</code></a> on a <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> widget -anyway, instead of using GDK functions. For child windows, -the move will reliably succeed. -</p> -<p> -If you're also planning to resize the window, use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a> -to both move and resize simultaneously, for a nicer visual effect. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>X coordinate relative to window's parent</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>Y coordinate relative to window's parent</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-resize"></a><h3>gdk_window_resize ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_resize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);</pre> -<p> -Resizes <em class="parameter"><code>window</code></em>; for toplevel windows, asks the window manager to resize -the window. The window manager may not allow the resize. When using GTK+, -use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-resize"><code class="function">gtk_window_resize()</code></a> instead of this low-level GDK function. -</p> -<p> -Windows may not be resized below 1x1. -</p> -<p> -If you're also planning to move the window, use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a> -to both move and resize simultaneously, for a nicer visual effect. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>new width of the window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>new height of the window</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-move-resize"></a><h3>gdk_window_move_resize ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_move_resize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>);</pre> -<p> -Equivalent to calling <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a> and <a class="link" href="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()"><code class="function">gdk_window_resize()</code></a>, -except that both operations are performed at once, avoiding strange -visual effects. (i.e. the user may be able to see the window first -move, then resize, if you don't use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>new X position relative to window's parent</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>new Y position relative to window's parent</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>new width</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>new height</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-scroll"></a><h3>gdk_window_scroll ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_scroll (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dy</code></em>);</pre> -<p> -Scroll the contents of <em class="parameter"><code>window</code></em>, both pixels and children, by the -given amount. <em class="parameter"><code>window</code></em> itself does not move. Portions of the window -that the scroll operation brings in from offscreen areas are -invalidated. The invalidated region may be bigger than what would -strictly be necessary. -</p> -<p> -For X11, a minimum area will be invalidated if the window has no -subwindows, or if the edges of the window's parent do not extend -beyond the edges of the window. In other cases, a multi-step process -is used to scroll the window which may produce temporary visual -artifacts and unnecessary invalidations. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td> -<td>Amount to scroll in the X direction</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td> -<td>Amount to scroll in the Y direction</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-move-region"></a><h3>gdk_window_move_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_move_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> dy</code></em>);</pre> -<p> -Move the part of <em class="parameter"><code>window</code></em> indicated by <em class="parameter"><code>region</code></em> by <em class="parameter"><code>dy</code></em> pixels in the Y -direction and <em class="parameter"><code>dx</code></em> pixels in the X direction. The portions of <em class="parameter"><code>region</code></em> -that not covered by the new position of <em class="parameter"><code>region</code></em> are invalidated. -</p> -<p> -Child windows are not moved. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>region</code></em> :</span></p></td> -<td>The <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> to move</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td> -<td>Amount to move in the X direction</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td> -<td>Amount to move in the Y direction</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.8</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-flush"></a><h3>gdk_window_flush ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_flush (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Flush all outstanding cached operations on a window, leaving the -window in a state which reflects all that has been drawn before. -</p> -<p> -Gdk uses multiple kinds of caching to get better performance and -nicer drawing. For instance, during exposes all paints to a window -using double buffered rendering are keep on a surface until the last -window has been exposed. It also delays window moves/scrolls until -as long as possible until next update to avoid tearing when moving -windows. -</p> -<p> -Normally this should be completely invisible to applications, as -we automatically flush the windows when required, but this might -be needed if you for instance mix direct native drawing with -gdk drawing. For Gtk widgets that don't use double buffering this -will be called automatically before sending the expose event. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-has-native"></a><h3>gdk_window_has_native ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_has_native (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Checks whether the window has a native window or not. Note that -you can use <a class="link" href="gdk3-Windows.html#gdk-window-ensure-native" title="gdk_window_ensure_native ()"><code class="function">gdk_window_ensure_native()</code></a> if a native window is needed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code class="literal">window</code> has a native window, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-ensure-native"></a><h3>gdk_window_ensure_native ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_ensure_native (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Tries to ensure that there is a window-system native window for this -GdkWindow. This may fail in some situations, returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. -</p> -<p> -Offscreen window and children of them can never have native windows. -</p> -<p> -Some backends may not support native child windows. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window has a native window, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-reparent"></a><h3>gdk_window_reparent ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_reparent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *new_parent</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre> -<p> -Reparents <em class="parameter"><code>window</code></em> into the given <em class="parameter"><code>new_parent</code></em>. The window being -reparented will be unmapped as a side effect. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>new_parent</code></em> :</span></p></td> -<td>new parent to move <em class="parameter"><code>window</code></em> into</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>X location inside the new parent</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>Y location inside the new parent</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-raise"></a><h3>gdk_window_raise ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_raise (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Raises <em class="parameter"><code>window</code></em> to the top of the Z-order (stacking order), so that -other windows with the same parent window appear below <em class="parameter"><code>window</code></em>. -This is true whether or not the windows are visible. -</p> -<p> -If <em class="parameter"><code>window</code></em> is a toplevel, the window manager may choose to deny the -request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-raise" title="gdk_window_raise ()"><code class="function">gdk_window_raise()</code></a> only -requests the restack, does not guarantee it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-lower"></a><h3>gdk_window_lower ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_lower (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Lowers <em class="parameter"><code>window</code></em> to the bottom of the Z-order (stacking order), so that -other windows with the same parent window appear above <em class="parameter"><code>window</code></em>. -This is true whether or not the other windows are visible. -</p> -<p> -If <em class="parameter"><code>window</code></em> is a toplevel, the window manager may choose to deny the -request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-lower" title="gdk_window_lower ()"><code class="function">gdk_window_lower()</code></a> only -requests the restack, does not guarantee it. -</p> -<p> -Note that <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> raises the window again, so don't call this -function before <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a>. (Try <a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-restack"></a><h3>gdk_window_restack ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_restack (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *sibling</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> above</code></em>);</pre> -<p> -Changes the position of <em class="parameter"><code>window</code></em> in the Z-order (stacking order), so that -it is above <em class="parameter"><code>sibling</code></em> (if <em class="parameter"><code>above</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>) or below <em class="parameter"><code>sibling</code></em> (if <em class="parameter"><code>above</code></em> is -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>). -</p> -<p> -If <em class="parameter"><code>sibling</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then this either raises (if <em class="parameter"><code>above</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>) or -lowers the window. -</p> -<p> -If <em class="parameter"><code>window</code></em> is a toplevel, the window manager may choose to deny the -request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-restack" title="gdk_window_restack ()"><code class="function">gdk_window_restack()</code></a> only -requests the restack, does not guarantee it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that is a sibling of <em class="parameter"><code>window</code></em>, 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="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>above</code></em> :</span></p></td> -<td>a boolean</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-focus"></a><h3>gdk_window_focus ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre> -<p> -Sets keyboard focus to <em class="parameter"><code>window</code></em>. In most cases, <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-present"><code class="function">gtk_window_present()</code></a> -should be used on a <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>, rather than calling this function. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td> -<td>timestamp of the event triggering the window focus</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-register-dnd"></a><h3>gdk_window_register_dnd ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_register_dnd (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Registers a window as a potential drop destination. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-resize-drag"></a><h3>gdk_window_begin_resize_drag ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_resize_drag (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre> -<p> -Begins a window resize operation (for a toplevel window). -</p> -<p> -This function assumes that the drag is controlled by the -client pointer device, use <a class="link" href="gdk3-Windows.html#gdk-window-begin-resize-drag-for-device" title="gdk_window_begin_resize_drag_for_device ()"><code class="function">gdk_window_begin_resize_drag_for_device()</code></a> -to begin a drag with a different device. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>edge</code></em> :</span></p></td> -<td>the edge or corner from which the drag is started</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td> -<td>the button being used to drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_x</code></em> :</span></p></td> -<td>root window X coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_y</code></em> :</span></p></td> -<td>root window Y coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td> -<td>timestamp of mouse click that began the drag (use <a class="link" href="gdk3-Events.html#gdk-event-get-time" title="gdk_event_get_time ()"><code class="function">gdk_event_get_time()</code></a>)</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-resize-drag-for-device"></a><h3>gdk_window_begin_resize_drag_for_device ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_resize_drag_for_device - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre> -<p> -Begins a window resize operation (for a toplevel window). -You might use this function to implement a "window resize grip," for -example; in fact <a href="http://library.gnome.org/devel/gtk3/GtkStatusbar.html"><span class="type">GtkStatusbar</span></a> uses it. The function works best -with window managers that support the <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>, but has a -fallback implementation for other window managers. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>edge</code></em> :</span></p></td> -<td>the edge or corner from which the drag is started</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>the device used for the operation</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td> -<td>the button being used to drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_x</code></em> :</span></p></td> -<td>root window X coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_y</code></em> :</span></p></td> -<td>root window Y coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td> -<td>timestamp of mouse click that began the drag (use <a class="link" href="gdk3-Events.html#gdk-event-get-time" title="gdk_event_get_time ()"><code class="function">gdk_event_get_time()</code></a>)</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-move-drag"></a><h3>gdk_window_begin_move_drag ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_move_drag (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre> -<p> -Begins a window move operation (for a toplevel window). -</p> -<p> -This function assumes that the drag is controlled by the -client pointer device, use <a class="link" href="gdk3-Windows.html#gdk-window-begin-move-drag-for-device" title="gdk_window_begin_move_drag_for_device ()"><code class="function">gdk_window_begin_move_drag_for_device()</code></a> -to begin a drag with a different device. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td> -<td>the button being used to drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_x</code></em> :</span></p></td> -<td>root window X coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_y</code></em> :</span></p></td> -<td>root window Y coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td> -<td>timestamp of mouse click that began the drag</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-move-drag-for-device"></a><h3>gdk_window_begin_move_drag_for_device ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_move_drag_for_device - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> button</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> root_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre> -<p> -Begins a window move operation (for a toplevel window). -You might use this function to implement a "window move grip," for -example. The function works best with window managers that support -the <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended -Window Manager Hints</a>, but has a fallback implementation for -other window managers. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>the device used for the operation</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td> -<td>the button being used to drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_x</code></em> :</span></p></td> -<td>root window X coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_y</code></em> :</span></p></td> -<td>root window Y coordinate of mouse click that began the drag</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td> -<td>timestamp of mouse click that began the drag</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-constrain-size"></a><h3>gdk_window_constrain_size ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_constrain_size (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_height</code></em>);</pre> -<p> -Constrains a desired width and height according to a -set of geometry hints (such as minimum and maximum size). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>geometry</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> structure</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>a mask indicating what portions of <em class="parameter"><code>geometry</code></em> are set</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>desired width of window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>desired height of the window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>new_width</code></em> :</span></p></td> -<td>location to store resulting width. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>new_height</code></em> :</span></p></td> -<td>location to store resulting height. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-beep"></a><h3>gdk_window_beep ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_beep (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Emits a short beep associated to <em class="parameter"><code>window</code></em> in the appropriate -display, if supported. Otherwise, emits a short beep on -the display just as <a class="link" href="GdkDisplay.html#gdk-display-beep" title="gdk_display_beep ()"><code class="function">gdk_display_beep()</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>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-clip-region"></a><h3>gdk_window_get_clip_region ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * gdk_window_get_clip_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Computes the region of a window that potentially can be written -to by drawing primitives. This region may not take into account -other factors such as if the window is obscured by other windows, -but no area outside of this region will be affected by drawing -primitives. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a>. This must be freed with <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a> -when you are done.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-paint-rect"></a><h3>gdk_window_begin_paint_rect ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_paint_rect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>);</pre> -<p> -A convenience wrapper around <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> which -creates a rectangular region for you. See -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> for details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td> -<td>rectangle you intend to draw to</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-begin-paint-region"></a><h3>gdk_window_begin_paint_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_begin_paint_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre> -<p> -Indicates that you are beginning the process of redrawing <em class="parameter"><code>region</code></em>. -A backing store (offscreen buffer) large enough to contain <em class="parameter"><code>region</code></em> -will be created. The backing store will be initialized with the -background color or background surface for <em class="parameter"><code>window</code></em>. Then, all -drawing operations performed on <em class="parameter"><code>window</code></em> will be diverted to the -backing store. When you call <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>, the backing -store will be copied to <em class="parameter"><code>window</code></em>, making it visible onscreen. Only -the part of <em class="parameter"><code>window</code></em> contained in <em class="parameter"><code>region</code></em> will be modified; that is, -drawing operations are clipped to <em class="parameter"><code>region</code></em>. -</p> -<p> -The net result of all this is to remove flicker, because the user -sees the finished product appear all at once when you call -<a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>. If you draw to <em class="parameter"><code>window</code></em> directly without -calling <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>, the user may see flicker -as individual drawing operations are performed in sequence. The -clipping and background-initializing features of -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> are conveniences for the -programmer, so you can avoid doing that work yourself. -</p> -<p> -When using GTK+, the widget system automatically places calls to -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> and <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> around -emissions of the expose_event signal. That is, if you're writing an -expose event handler, you can assume that the exposed area in -<a class="link" href="gdk3-Event-Structures.html#GdkEventExpose" title="struct GdkEventExpose"><span class="type">GdkEventExpose</span></a> has already been cleared to the window background, -is already set as the clip region, and already has a backing store. -Therefore in most cases, application code need not call -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>. (You can disable the automatic -calls around expose events on a widget-by-widget basis by calling -<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-set-double-buffered"><code class="function">gtk_widget_set_double_buffered()</code></a>.) -</p> -<p> -If you call this function multiple times before calling the -matching <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>, the backing stores are pushed onto -a stack. <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> copies the topmost backing store -onscreen, subtracts the topmost region from all other regions in -the stack, and pops the stack. All drawing operations affect only -the topmost backing store in the stack. One matching call to -<a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> is required for each call to -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>region</code></em> :</span></p></td> -<td>region you intend to draw to</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-end-paint"></a><h3>gdk_window_end_paint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_end_paint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Indicates that the backing store created by the most recent call to -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> should be copied onscreen and -deleted, leaving the next-most-recent backing store or no backing -store at all as the active paint region. See -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> for full details. It is an error to -call this function without a matching -<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> first. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-visible-region"></a><h3>gdk_window_get_visible_region ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * gdk_window_get_visible_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Computes the region of the <em class="parameter"><code>window</code></em> that is potentially visible. -This does not necessarily take into account if the window is -obscured by other windows, but no area outside of this region -is visible. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a>. This must be freed with <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a> -when you are done.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-invalidate-rect"></a><h3>gdk_window_invalidate_rect ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_invalidate_rect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invalidate_children</code></em>);</pre> -<p> -A convenience wrapper around <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> which -invalidates a rectangular region. See -<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> for details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>rect</code></em> :</span></p></td> -<td>rectangle to invalidate or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to invalidate the whole -window. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>invalidate_children</code></em> :</span></p></td> -<td>whether to also invalidate child windows</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-invalidate-region"></a><h3>gdk_window_invalidate_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_invalidate_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invalidate_children</code></em>);</pre> -<p> -Adds <em class="parameter"><code>region</code></em> to the update area for <em class="parameter"><code>window</code></em>. The update area is the -region that needs to be redrawn, or "dirty region." The call -<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> sends one or more expose events to the -window, which together cover the entire update area. An -application would normally redraw the contents of <em class="parameter"><code>window</code></em> in -response to those expose events. -</p> -<p> -GDK will call <a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf -whenever your program returns to the main loop and becomes idle, so -normally there's no need to do that manually, you just need to -invalidate regions that you know should be redrawn. -</p> -<p> -The <em class="parameter"><code>invalidate_children</code></em> parameter controls whether the region of -each child window that intersects <em class="parameter"><code>region</code></em> will also be invalidated. -If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then the update area for child windows will remain -unaffected. See gdk_window_invalidate_maybe_recurse if you need -fine grained control over which children are invalidated. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>region</code></em> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>invalidate_children</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to also invalidate child windows</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindowChildFunc"></a><h3>GdkWindowChildFunc ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GdkWindowChildFunc) (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> -<p> -A function of this type is passed to <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-maybe-recurse" title="gdk_window_invalidate_maybe_recurse ()"><code class="function">gdk_window_invalidate_maybe_recurse()</code></a>. -It gets called for each child of the window to determine whether to -recursively invalidate it or now. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to invalidate <em class="parameter"><code>window</code></em> recursively</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-invalidate-maybe-recurse"></a><h3>gdk_window_invalidate_maybe_recurse ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_invalidate_maybe_recurse (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowChildFunc" title="GdkWindowChildFunc ()"><span class="type">GdkWindowChildFunc</span></a> child_func</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> -<p> -Adds <em class="parameter"><code>region</code></em> to the update area for <em class="parameter"><code>window</code></em>. The update area is the -region that needs to be redrawn, or "dirty region." The call -<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> sends one or more expose events to the -window, which together cover the entire update area. An -application would normally redraw the contents of <em class="parameter"><code>window</code></em> in -response to those expose events. -</p> -<p> -GDK will call <a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf -whenever your program returns to the main loop and becomes idle, so -normally there's no need to do that manually, you just need to -invalidate regions that you know should be redrawn. -</p> -<p> -The <em class="parameter"><code>child_func</code></em> parameter controls whether the region of -each child window that intersects <em class="parameter"><code>region</code></em> will also be invalidated. -Only children for which <em class="parameter"><code>child_func</code></em> returns TRUE will have the area -invalidated. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>region</code></em> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>child_func</code></em> :</span></p></td> -<td>function to use to decide if to -recurse to a child, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> means never recurse. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>data passed to <em class="parameter"><code>child_func</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-update-area"></a><h3>gdk_window_get_update_area ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> * gdk_window_get_update_area (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Transfers ownership of the update area from <em class="parameter"><code>window</code></em> to the caller -of the function. That is, after calling this function, <em class="parameter"><code>window</code></em> will -no longer have an invalid/dirty region; the update area is removed -from <em class="parameter"><code>window</code></em> and handed to you. If a window has no update area, -<a class="link" href="gdk3-Windows.html#gdk-window-get-update-area" title="gdk_window_get_update_area ()"><code class="function">gdk_window_get_update_area()</code></a> returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You are responsible for -calling <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a> on the returned region if it's non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the update area for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-freeze-updates"></a><h3>gdk_window_freeze_updates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_freeze_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Temporarily freezes a window such that it won't receive expose -events. The window will begin receiving expose events again when -<a class="link" href="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()"><code class="function">gdk_window_thaw_updates()</code></a> is called. If <a class="link" href="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()"><code class="function">gdk_window_freeze_updates()</code></a> -has been called more than once, <a class="link" href="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()"><code class="function">gdk_window_thaw_updates()</code></a> must be called -an equal number of times to begin processing exposes. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-thaw-updates"></a><h3>gdk_window_thaw_updates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_thaw_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Thaws a window frozen with <a class="link" href="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()"><code class="function">gdk_window_freeze_updates()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-process-all-updates"></a><h3>gdk_window_process_all_updates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_process_all_updates (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -Calls <a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> for all windows (see <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>) -in the application. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-process-updates"></a><h3>gdk_window_process_updates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_process_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> update_children</code></em>);</pre> -<p> -Sends one or more expose events to <em class="parameter"><code>window</code></em>. The areas in each -expose event will cover the entire update area for the window (see -<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> for details). Normally GDK calls -<a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf, so there's no -need to call this function unless you want to force expose events -to be delivered immediately and synchronously (vs. the usual -case, where GDK delivers them in an idle handler). Occasionally -this is useful to produce nicer scrolling behavior, for example. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>update_children</code></em> :</span></p></td> -<td>whether to also process updates for child windows</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-debug-updates"></a><h3>gdk_window_set_debug_updates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_debug_updates (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -With update debugging enabled, calls to -<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> clear the invalidated region of the -screen to a noticeable color, and GDK pauses for a short time -before sending exposes to windows during -<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a>. The net effect is that you can see -the invalid region for each window and watch redraws as they -occur. This allows you to diagnose inefficiencies in your application. -</p> -<p> -In essence, because the GDK rendering model prevents all flicker, -if you are redrawing the same region 400 times you may never -notice, aside from noticing a speed problem. Enabling update -debugging causes GTK to flicker slowly and noticeably, so you can -see exactly what's being redrawn when, in what order. -</p> -<p> -The --gtk-debug=updates command line option passed to GTK+ programs -enables this debug option at application startup time. That's -usually more useful than calling <a class="link" href="gdk3-Windows.html#gdk-window-set-debug-updates" title="gdk_window_set_debug_updates ()"><code class="function">gdk_window_set_debug_updates()</code></a> -yourself, though you might want to use this function to enable -updates sometime after application startup time. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to turn on update debugging</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-enable-synchronized-configure"></a><h3>gdk_window_enable_synchronized_configure ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_enable_synchronized_configure - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Indicates that the application will cooperate with the window -system in synchronizing the window repaint with the window -manager during resizing operations. After an application calls -this function, it must call <a class="link" href="gdk3-Windows.html#gdk-window-configure-finished" title="gdk_window_configure_finished ()"><code class="function">gdk_window_configure_finished()</code></a> every -time it has finished all processing associated with a set of -Configure events. Toplevel GTK+ windows automatically use this -protocol. -</p> -<p> -On X, calling this function makes <em class="parameter"><code>window</code></em> participate in the -_NET_WM_SYNC_REQUEST window manager protocol. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-configure-finished"></a><h3>gdk_window_configure_finished ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_configure_finished (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Signal to the window system that the application has finished -handling Configure events it has received. Window Managers can -use this to better synchronize the frame repaint with the -application. GTK+ applications will automatically call this -function when appropriate. -</p> -<p> -This function can only be called if <a class="link" href="gdk3-Windows.html#gdk-window-enable-synchronized-configure" title="gdk_window_enable_synchronized_configure ()"><code class="function">gdk_window_enable_synchronized_configure()</code></a> -was called previously. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-user-data"></a><h3>gdk_window_set_user_data ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_user_data (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> -<p> -For most purposes this function is deprecated in favor of -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a>. However, for historical reasons GTK+ stores -the <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="type">GtkWidget</span></a> that owns a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as user data on the -<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. So, custom widget implementations should use -this function for that. If GTK+ receives an event for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, -and the user data for the window is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, GTK+ will assume the -user data is a <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="type">GtkWidget</span></a>, and forward the event to that widget. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-override-redirect"></a><h3>gdk_window_set_override_redirect ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_override_redirect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> override_redirect</code></em>);</pre> -<p> -An override redirect window is not under the control of the window manager. -This means it won't have a titlebar, won't be minimizable, etc. - it will -be entirely under the control of the application. The window manager -can't see the override redirect window at all. -</p> -<p> -Override redirect should only be used for short-lived temporary -windows, such as popup menus. <a href="http://library.gnome.org/devel/gtk3/GtkMenu.html"><span class="type">GtkMenu</span></a> uses an override redirect -window in its implementation, for example. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>override_redirect</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if window should be override redirect</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-accept-focus"></a><h3>gdk_window_set_accept_focus ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_accept_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> accept_focus</code></em>);</pre> -<p> -Setting <em class="parameter"><code>accept_focus</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> hints the desktop environment that the -window doesn't want to receive input focus. -</p> -<p> -On X, it is the responsibility of the window manager to interpret this -hint. ICCCM-compliant window manager usually respect it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>accept_focus</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window should receive input focus</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-accept-focus"></a><h3>gdk_window_get_accept_focus ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_accept_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether or not the desktop environment shuld be hinted that -the window does not want to receive input focus. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether or not the window should receive input focus.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-focus-on-map"></a><h3>gdk_window_set_focus_on_map ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_focus_on_map (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> focus_on_map</code></em>);</pre> -<p> -Setting <em class="parameter"><code>focus_on_map</code></em> to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> hints the desktop environment that the -window doesn't want to receive input focus when it is mapped. -focus_on_map should be turned off for windows that aren't triggered -interactively (such as popups from network activity). -</p> -<p> -On X, it is the responsibility of the window manager to interpret -this hint. Window managers following the freedesktop.org window -manager extension specification should respect it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>focus_on_map</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window should receive input focus when mapped</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-focus-on-map"></a><h3>gdk_window_get_focus_on_map ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_focus_on_map (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether or not the desktop environment should be hinted that the -window does not want to receive input focus when it is mapped. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether or not the window wants to receive input focus when -it is mapped.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-add-filter"></a><h3>gdk_window_add_filter ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_add_filter (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> -<p> -Adds an event filter to <em class="parameter"><code>window</code></em>, allowing you to intercept events -before they reach GDK. This is a low-level operation and makes it -easy to break GDK and/or GTK+, so you have to know what you're -doing. Pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for <em class="parameter"><code>window</code></em> to get all events for all windows, -instead of events for a specific window. -</p> -<p> -If you are interested in X GenericEvents, bear in mind that -<code class="function">XGetEventData()</code> has been already called on the event, and -<code class="function">XFreeEventData()</code> must not be called within <em class="parameter"><code>function</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>function</code></em> :</span></p></td> -<td>filter callback</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>data to pass to filter callback</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-remove-filter"></a><h3>gdk_window_remove_filter ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_remove_filter (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> -<p> -Remove a filter previously added with <a class="link" href="gdk3-Windows.html#gdk-window-add-filter" title="gdk_window_add_filter ()"><code class="function">gdk_window_add_filter()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>function</code></em> :</span></p></td> -<td>previously-added filter function</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>user data for previously-added filter function</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkFilterFunc"></a><h3>GdkFilterFunc ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="returnvalue">GdkFilterReturn</span></a> (*GdkFilterFunc) (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkXEvent" title="GdkXEvent"><span class="type">GdkXEvent</span></a> *xevent</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> -<p> -Specifies the type of function used to filter native events before they are -converted to GDK events. -</p> -<p> -When a filter is called, <em class="parameter"><code>event</code></em> is unpopulated, except for -<code class="literal">event->window</code>. The filter may translate the native -event to a GDK event and store the result in <em class="parameter"><code>event</code></em>, or handle it without -translation. If the filter translates the event and processing should -continue, it should return <a class="link" href="gdk3-Windows.html#GDK-FILTER-TRANSLATE:CAPS"><code class="literal">GDK_FILTER_TRANSLATE</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>xevent</code></em> :</span></p></td> -<td>the native event to filter.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the GDK event to which the X event will be translated.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>user data set when the filter was installed.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="type">GdkFilterReturn</span></a> value.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkFilterReturn"></a><h3>enum GdkFilterReturn</h3> -<pre class="programlisting">typedef enum { - GDK_FILTER_CONTINUE, /* Event not handled, continue processesing */ - GDK_FILTER_TRANSLATE, /* Native event translated into a GDK event and - stored in the "event" structure that was - passed in */ - GDK_FILTER_REMOVE /* Terminate processing, removing event */ -} GdkFilterReturn; -</pre> -<p> -Specifies the result of applying a <a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> to a native event. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-FILTER-CONTINUE:CAPS"></a><span class="term"><code class="literal">GDK_FILTER_CONTINUE</code></span></p></td> -<td>event not handled, continue processing. -</td> -</tr> -<tr> -<td><p><a name="GDK-FILTER-TRANSLATE:CAPS"></a><span class="term"><code class="literal">GDK_FILTER_TRANSLATE</code></span></p></td> -<td>native event translated into a GDK event and stored - in the <code class="literal">event</code> structure that was passed in. -</td> -</tr> -<tr> -<td><p><a name="GDK-FILTER-REMOVE:CAPS"></a><span class="term"><code class="literal">GDK_FILTER_REMOVE</code></span></p></td> -<td>event handled, terminate processing. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkXEvent"></a><h3>GdkXEvent</h3> -<pre class="programlisting">typedef void GdkXEvent; /* Can be cast to window system specific -</pre> -<p> -Used to represent native events (<span class="type">XEvent</span>s for the X11 -backend, <span class="type">MSG</span>s for Win32). -</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-shape-combine-region"></a><h3>gdk_window_shape_combine_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_shape_combine_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_y</code></em>);</pre> -<p> -Makes pixels in <em class="parameter"><code>window</code></em> outside <em class="parameter"><code>shape_region</code></em> be transparent, -so that the window may be nonrectangular. -</p> -<p> -If <em class="parameter"><code>shape_region</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the shape will be unset, so the whole -window will be opaque again. <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em> are ignored -if <em class="parameter"><code>shape_region</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -</p> -<p> -On the X11 platform, this uses an X server extension which is -widely available on most common platforms, but not available on -very old X servers, and occasionally the implementation will be -buggy. On servers without the shape extension, this function -will do nothing. -</p> -<p> -This function works on both toplevel and child windows. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>shape_region</code></em> :</span></p></td> -<td>region of window to be non-transparent. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td> -<td>X position of <em class="parameter"><code>shape_region</code></em> in <em class="parameter"><code>window</code></em> coordinates</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td> -<td>Y position of <em class="parameter"><code>shape_region</code></em> in <em class="parameter"><code>window</code></em> coordinates</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-child-shapes"></a><h3>gdk_window_set_child_shapes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_child_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Sets the shape mask of <em class="parameter"><code>window</code></em> to the union of shape masks -for all children of <em class="parameter"><code>window</code></em>, ignoring the shape mask of <em class="parameter"><code>window</code></em> -itself. Contrast with <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-shapes" title="gdk_window_merge_child_shapes ()"><code class="function">gdk_window_merge_child_shapes()</code></a> which includes -the shape mask of <em class="parameter"><code>window</code></em> in the masks to be merged. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-merge-child-shapes"></a><h3>gdk_window_merge_child_shapes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_merge_child_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Merges the shape masks for any child windows into the -shape mask for <em class="parameter"><code>window</code></em>. i.e. the union of all masks -for <em class="parameter"><code>window</code></em> and its children will become the new mask -for <em class="parameter"><code>window</code></em>. See <a class="link" href="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()"><code class="function">gdk_window_shape_combine_region()</code></a>. -</p> -<p> -This function is distinct from <a class="link" href="gdk3-Windows.html#gdk-window-set-child-shapes" title="gdk_window_set_child_shapes ()"><code class="function">gdk_window_set_child_shapes()</code></a> -because it includes <em class="parameter"><code>window</code></em>'s shape mask in the set of shapes to -be merged. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-input-shape-combine-region"></a><h3>gdk_window_input_shape_combine_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_input_shape_combine_region - (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> offset_y</code></em>);</pre> -<p> -Like <a class="link" href="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()"><code class="function">gdk_window_shape_combine_region()</code></a>, but the shape applies -only to event handling. Mouse events which happen while -the pointer position corresponds to an unset bit in the -mask will be passed on the window below <em class="parameter"><code>window</code></em>. -</p> -<p> -An input shape is typically used with RGBA windows. -The alpha channel of the window defines which pixels are -invisible and allows for nicely antialiased borders, -and the input shape controls where the window is -"clickable". -</p> -<p> -On the X11 platform, this requires version 1.1 of the -shape extension. -</p> -<p> -On the Win32 platform, this functionality is not present and the -function does nothing. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>shape_region</code></em> :</span></p></td> -<td>region of window to be non-transparent</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td> -<td>X position of <em class="parameter"><code>shape_region</code></em> in <em class="parameter"><code>window</code></em> coordinates</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td> -<td>Y position of <em class="parameter"><code>shape_region</code></em> in <em class="parameter"><code>window</code></em> coordinates</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-child-input-shapes"></a><h3>gdk_window_set_child_input_shapes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_child_input_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Sets the input shape mask of <em class="parameter"><code>window</code></em> to the union of input shape masks -for all children of <em class="parameter"><code>window</code></em>, ignoring the input shape mask of <em class="parameter"><code>window</code></em> -itself. Contrast with <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-input-shapes" title="gdk_window_merge_child_input_shapes ()"><code class="function">gdk_window_merge_child_input_shapes()</code></a> which includes -the input shape mask of <em class="parameter"><code>window</code></em> in the masks to be merged. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-merge-child-input-shapes"></a><h3>gdk_window_merge_child_input_shapes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_merge_child_input_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Merges the input shape masks for any child windows into the -input shape mask for <em class="parameter"><code>window</code></em>. i.e. the union of all input masks -for <em class="parameter"><code>window</code></em> and its children will become the new input mask -for <em class="parameter"><code>window</code></em>. See <a class="link" href="gdk3-Windows.html#gdk-window-input-shape-combine-region" title="gdk_window_input_shape_combine_region ()"><code class="function">gdk_window_input_shape_combine_region()</code></a>. -</p> -<p> -This function is distinct from <a class="link" href="gdk3-Windows.html#gdk-window-set-child-input-shapes" title="gdk_window_set_child_input_shapes ()"><code class="function">gdk_window_set_child_input_shapes()</code></a> -because it includes <em class="parameter"><code>window</code></em>'s input shape mask in the set of -shapes to be merged. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-static-gravities"></a><h3>gdk_window_set_static_gravities ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_set_static_gravities (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_static</code></em>);</pre> -<p> -Set the bit gravity of the given window to static, and flag it so -all children get static subwindow gravity. This is used if you are -implementing scary features that involve deep knowledge of the -windowing system. Don't worry about it unless you have to. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>use_static</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to turn on static gravity</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the server supports static gravity</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-title"></a><h3>gdk_window_set_title ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_title (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre> -<p> -Sets the title of a toplevel window, to be displayed in the titlebar. -If you haven't explicitly set the icon name for the window -(using <a class="link" href="gdk3-Windows.html#gdk-window-set-icon-name" title="gdk_window_set_icon_name ()"><code class="function">gdk_window_set_icon_name()</code></a>), the icon name will be set to -<em class="parameter"><code>title</code></em> as well. <em class="parameter"><code>title</code></em> must be in UTF-8 encoding (as with all -user-readable strings in GDK/GTK+). <em class="parameter"><code>title</code></em> may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</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>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td> -<td>title of <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-background"></a><h3>gdk_window_set_background ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_background (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gdk_window_set_background</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="gdk3-Windows.html#gdk-window-set-background-rgba" title="gdk_window_set_background_rgba ()"><code class="function">gdk_window_set_background_rgba()</code></a> instead.</p> -</div> -<p> -Sets the background color of <em class="parameter"><code>window</code></em>. (However, when using GTK+, -set the background of a widget with <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#gtk-widget-modify-bg"><code class="function">gtk_widget_modify_bg()</code></a> - if -you're an application - or <a href="http://library.gnome.org/devel/gtk3/GtkStyle.html#gtk-style-set-background"><code class="function">gtk_style_set_background()</code></a> - if you're -implementing a custom widget.) -</p> -<p> -See also <a class="link" href="gdk3-Windows.html#gdk-window-set-background-pattern" title="gdk_window_set_background_pattern ()"><code class="function">gdk_window_set_background_pattern()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-background-rgba"></a><h3>gdk_window_set_background_rgba ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_background_rgba (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-RGBA-Colors.html#GdkRGBA" title="GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre> -<p> -Sets the background color of <em class="parameter"><code>window</code></em>. -</p> -<p> -See also <a class="link" href="gdk3-Windows.html#gdk-window-set-background-pattern" title="gdk_window_set_background_pattern ()"><code class="function">gdk_window_set_background_pattern()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>rgba</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-RGBA-Colors.html#GdkRGBA" title="GdkRGBA"><span class="type">GdkRGBA</span></a> color</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-background-pattern"></a><h3>gdk_window_set_background_pattern ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_background_pattern (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre> -<p> -Sets the background of <em class="parameter"><code>window</code></em>. -</p> -<p> -A background of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> means that the window will inherit its -background form its parent window. -</p> -<p> -The windowing system will normally fill a window with its background -when the window is obscured then exposed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td> -<td>a pattern to use, 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="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-background-pattern"></a><h3>gdk_window_get_background_pattern ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="returnvalue">cairo_pattern_t</span></a> * gdk_window_get_background_pattern (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the pattern used to clear the background on <em class="parameter"><code>window</code></em>. If <em class="parameter"><code>window</code></em> -does not have its own background and reuses the parent's, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is -returned and you'll have to query it yourself. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a window</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The pattern to use for the background or -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the parent's background. <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 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="GDK-PARENT-RELATIVE:CAPS"></a><h3>GDK_PARENT_RELATIVE</h3> -<pre class="programlisting">#define GDK_PARENT_RELATIVE 1L -</pre> -<p> -A special value, indicating that the background -for a window should be inherited from the parent window. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-cursor"></a><h3>gdk_window_set_cursor ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre> -<p> -Sets the default mouse pointer for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. Use <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()"><code class="function">gdk_cursor_new_for_display()</code></a> -or <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()"><code class="function">gdk_cursor_new_from_pixbuf()</code></a> to create the cursor. To make the cursor -invisible, use <a class="link" href="gdk3-Cursors.html#GDK-BLANK-CURSOR:CAPS"><code class="literal">GDK_BLANK_CURSOR</code></a>. Passing <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>cursor</code></em> argument -to <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> means that <em class="parameter"><code>window</code></em> will use the cursor of its -parent window. Most windows should use this default. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td> -<td>a cursor. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-cursor"></a><h3>gdk_window_get_cursor ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> * gdk_window_get_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Retrieves a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> pointer for the cursor currently set on the -specified <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If the return value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then -there is no custom cursor set on the specified window, and it is -using the cursor for its parent window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The returned -object is owned by the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> and should not be unreferenced -directly. Use <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> to unset the cursor of the -window. <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 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-user-data"></a><h3>gdk_window_get_user_data ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_user_data (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data</code></em>);</pre> -<p> -Retrieves the user data for <em class="parameter"><code>window</code></em>, which is normally the widget -that <em class="parameter"><code>window</code></em> belongs to. See <a class="link" href="gdk3-Windows.html#gdk-window-set-user-data" title="gdk_window_set_user_data ()"><code class="function">gdk_window_set_user_data()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> -<td>return location for user data. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-geometry"></a><h3>gdk_window_get_geometry ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_geometry (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>);</pre> -<p> -Any of the return location arguments to this function may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, -if you aren't interested in getting the value of that field. -</p> -<p> -The X and Y coordinates returned are relative to the parent window -of <em class="parameter"><code>window</code></em>, which for toplevels usually means relative to the -window decorations (titlebar, etc.) rather than relative to the -root window (screen-size background window). -</p> -<p> -On the X11 platform, the geometry is obtained from the X server, -so reflects the latest position of <em class="parameter"><code>window</code></em>; this may be out-of-sync -with the position of <em class="parameter"><code>window</code></em> delivered in the most-recently-processed -<a class="link" href="gdk3-Event-Structures.html#GdkEventConfigure" title="struct GdkEventConfigure"><span class="type">GdkEventConfigure</span></a>. <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> in contrast gets the -position from the most recent configure event. -</p> -<p> -</p> -<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Note</h3> -If <em class="parameter"><code>window</code></em> is not a toplevel, it is <span class="emphasis"><em>much</em></span> better -to call <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a>, <a class="link" href="gdk3-Windows.html#gdk-window-get-width" title="gdk_window_get_width ()"><code class="function">gdk_window_get_width()</code></a> and -<a class="link" href="gdk3-Windows.html#gdk-window-get-height" title="gdk_window_get_height ()"><code class="function">gdk_window_get_height()</code></a> instead, because it avoids the roundtrip to -the X server and because these functions support the full 32-bit -coordinate space, whereas <a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> is restricted to -the 16-bit coordinates of X11. -</div> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for X coordinate of window (relative to its parent). <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for Y coordinate of window (relative to its parent). <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>return location for width of window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>return location for height of window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-geometry-hints"></a><h3>gdk_window_set_geometry_hints ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_geometry_hints (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints"><span class="type">GdkWindowHints</span></a> geom_mask</code></em>);</pre> -<p> -Sets the geometry hints for <em class="parameter"><code>window</code></em>. Hints flagged in <em class="parameter"><code>geom_mask</code></em> -are set, hints not flagged in <em class="parameter"><code>geom_mask</code></em> are unset. -To unset all hints, use a <em class="parameter"><code>geom_mask</code></em> of 0 and a <em class="parameter"><code>geometry</code></em> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -</p> -<p> -This function provides hints to the windowing system about -acceptable sizes for a toplevel window. The purpose of -this is to constrain user resizing, but the windowing system -will typically (but is not required to) also constrain the -current size of the window to the provided values and -constrain programatic resizing via <a class="link" href="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()"><code class="function">gdk_window_resize()</code></a> or -<a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a>. -</p> -<p> -Note that on X11, this effect has no effect on windows -of type <a class="link" href="gdk3-Windows.html#GDK-WINDOW-TEMP:CAPS"><code class="literal">GDK_WINDOW_TEMP</code></a> or windows where override redirect -has been turned on via <a class="link" href="gdk3-Windows.html#gdk-window-set-override-redirect" title="gdk_window_set_override_redirect ()"><code class="function">gdk_window_set_override_redirect()</code></a> -since these windows are not resizable by the user. -</p> -<p> -Since you can't count on the windowing system doing the -constraints for programmatic resizes, you should generally -call <a class="link" href="gdk3-Windows.html#gdk-window-constrain-size" title="gdk_window_constrain_size ()"><code class="function">gdk_window_constrain_size()</code></a> yourself to determine -appropriate sizes. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>geometry</code></em> :</span></p></td> -<td>geometry hints</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>geom_mask</code></em> :</span></p></td> -<td>bitmask indicating fields of <em class="parameter"><code>geometry</code></em> to pay attention to</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-width"></a><h3>gdk_window_get_width ()</h3> -<pre class="programlisting"><span class="returnvalue">int</span> gdk_window_get_width (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Returns the width of the given <em class="parameter"><code>window</code></em>. -</p> -<p> -On the X11 platform the returned size is the size reported in the -most-recently-processed configure event, rather than the current -size on the X server. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The width of <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-height"></a><h3>gdk_window_get_height ()</h3> -<pre class="programlisting"><span class="returnvalue">int</span> gdk_window_get_height (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Returns the height of the given <em class="parameter"><code>window</code></em>. -</p> -<p> -On the X11 platform the returned size is the size reported in the -most-recently-processed configure event, rather than the current -size on the X server. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The height of <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.24</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-icon-list"></a><h3>gdk_window_set_icon_list ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_icon_list (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *pixbufs</code></em>);</pre> -<p> -Sets a list of icons for the window. One of these will be used -to represent the window when it has been iconified. The icon is -usually shown in an icon box or some sort of task bar. Which icon -size is shown depends on the window manager. The window manager -can scale the icon but setting several size icons can give better -image quality since the window manager may only need to scale the -icon by a small amount or not at all. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>The <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> toplevel window to set the icon of.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pixbufs</code></em> :</span></p></td> -<td>A list of pixbufs, of different sizes. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbuf]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-modal-hint"></a><h3>gdk_window_set_modal_hint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_modal_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> modal</code></em>);</pre> -<p> -The application can use this hint to tell the window manager -that a certain window has modal behaviour. The window manager -can use this information to handle modal windows in a special -way. -</p> -<p> -You should only use this on windows for which you have -previously called <a class="link" href="gdk3-Windows.html#gdk-window-set-transient-for" title="gdk_window_set_transient_for ()"><code class="function">gdk_window_set_transient_for()</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>window</code></em> :</span></p></td> -<td>A toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modal</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is modal, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-modal-hint"></a><h3>gdk_window_get_modal_hint ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_modal_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Determines whether or not the window manager is hinted that <em class="parameter"><code>window</code></em> -has modal behaviour. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>A toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether or not the window has the modal hint set.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-type-hint"></a><h3>gdk_window_set_type_hint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_type_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> hint</code></em>);</pre> -<p> -The application can use this call to provide a hint to the window -manager about the functionality of a window. The window manager -can use this information when determining the decoration and behaviour -of the window. -</p> -<p> -The hint must be set before the window is mapped. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>A toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>hint</code></em> :</span></p></td> -<td>A hint of the function this window will have</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-type-hint"></a><h3>gdk_window_get_type_hint ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a> gdk_window_get_type_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -This function returns the type hint set for a window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>A toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The type hint set for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-skip-taskbar-hint"></a><h3>gdk_window_set_skip_taskbar_hint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_skip_taskbar_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> skips_taskbar</code></em>);</pre> -<p> -Toggles whether a window should appear in a task list or window -list. If a window's semantic type as specified with -<a class="link" href="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()"><code class="function">gdk_window_set_type_hint()</code></a> already fully describes the window, this -function should <span class="emphasis"><em>not</em></span> be called in addition, -instead you should allow the window to be treated according to -standard policy for its semantic type. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>skips_taskbar</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to skip the taskbar</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-skip-pager-hint"></a><h3>gdk_window_set_skip_pager_hint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_skip_pager_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> skips_pager</code></em>);</pre> -<p> -Toggles whether a window should appear in a pager (workspace -switcher, or other desktop utility program that displays a small -thumbnail representation of the windows on the desktop). If a -window's semantic type as specified with <a class="link" href="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()"><code class="function">gdk_window_set_type_hint()</code></a> -already fully describes the window, this function should -<span class="emphasis"><em>not</em></span> be called in addition, instead you should -allow the window to be treated according to standard policy for -its semantic type. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>skips_pager</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to skip the pager</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-urgency-hint"></a><h3>gdk_window_set_urgency_hint ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_urgency_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>);</pre> -<p> -Toggles whether a window needs the user's -urgent attention. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>urgent</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is urgent</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.8</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-position"></a><h3>gdk_window_get_position ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_position (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre> -<p> -Obtains the position of the window as reported in the -most-recently-processed <a class="link" href="gdk3-Event-Structures.html#GdkEventConfigure" title="struct GdkEventConfigure"><span class="type">GdkEventConfigure</span></a>. Contrast with -<a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> which queries the X server for the -current window position, regardless of which events have been -received or processed. -</p> -<p> -The position coordinates are relative to the window's parent window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>X coordinate of window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>Y coordinate of window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-root-origin"></a><h3>gdk_window_get_root_origin ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_root_origin (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre> -<p> -Obtains the top-left corner of the window manager frame in root -window coordinates. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for X position of window frame. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for Y position of window frame. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-frame-extents"></a><h3>gdk_window_get_frame_extents ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_frame_extents (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre> -<p> -Obtains the bounding box of the window, including window manager -titlebar/borders if any. The frame position is given in root window -coordinates. To get the position of the window itself (rather than -the frame) in root window coordinates, use <a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()"><code class="function">gdk_window_get_origin()</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>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>rect</code></em> :</span></p></td> -<td>rectangle to fill with bounding box of the window frame. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-origin"></a><h3>gdk_window_get_origin ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gdk_window_get_origin (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre> -<p> -Obtains the position of a window in root window coordinates. -(Compare with <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> and -<a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> which return the position of a window -relative to its parent window.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for X coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for Y coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>not meaningful, ignore</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-root-coords"></a><h3>gdk_window_get_root_coords ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_get_root_coords (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *root_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *root_y</code></em>);</pre> -<p> -Obtains the position of a window position in root -window coordinates. This is similar to -<a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()"><code class="function">gdk_window_get_origin()</code></a> but allows you go pass -in any position in the window, not just the origin. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>X coordinate in window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>Y coordinate in window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_x</code></em> :</span></p></td> -<td>return location for X coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>root_y</code></em> :</span></p></td> -<td>return location for Y coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-pointer"></a><h3>gdk_window_get_pointer ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_pointer (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gdk_window_get_pointer</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="gdk3-Windows.html#gdk-window-get-device-position" title="gdk_window_get_device_position ()"><code class="function">gdk_window_get_device_position()</code></a> instead.</p> -</div> -<p> -Obtains the current pointer position and modifier state. -The position is given in coordinates relative to the upper left -corner of <em class="parameter"><code>window</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for X coordinate of pointer or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to not -return the X coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for Y coordinate of pointer or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to not -return the Y coordinate. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td> -<td>return location for modifier mask or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to not return the -modifier mask. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the window containing the pointer (as with -<a class="link" href="gdk3-Windows.html#gdk-window-at-pointer" title="gdk_window_at_pointer ()"><code class="function">gdk_window_at_pointer()</code></a>), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the window containing the -pointer isn't known to GDK. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-device-position"></a><h3>gdk_window_get_device_position ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_device_position (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre> -<p> -Obtains the current device position and modifier state. -The position is given in coordinates relative to the upper left -corner of <em class="parameter"><code>window</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to query to.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for the X coordinate of <em class="parameter"><code>device</code></em>, 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 for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for the Y coordinate of <em class="parameter"><code>device</code></em>, 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 for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td> -<td>return location for the modifier mask, 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 for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The window underneath <em class="parameter"><code>device</code></em> (as with -<a class="link" href="GdkDevice.html#gdk-device-get-window-at-position" title="gdk_device_get_window_at_position ()"><code class="function">gdk_device_get_window_at_position()</code></a>), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the window is not known to GDK. <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="GdkModifierType"></a><h3>enum GdkModifierType</h3> -<pre class="programlisting">typedef enum { - GDK_SHIFT_MASK = 1 << 0, - GDK_LOCK_MASK = 1 << 1, - GDK_CONTROL_MASK = 1 << 2, - GDK_MOD1_MASK = 1 << 3, - GDK_MOD2_MASK = 1 << 4, - GDK_MOD3_MASK = 1 << 5, - GDK_MOD4_MASK = 1 << 6, - GDK_MOD5_MASK = 1 << 7, - GDK_BUTTON1_MASK = 1 << 8, - GDK_BUTTON2_MASK = 1 << 9, - GDK_BUTTON3_MASK = 1 << 10, - GDK_BUTTON4_MASK = 1 << 11, - GDK_BUTTON5_MASK = 1 << 12, - - GDK_MODIFIER_RESERVED_13_MASK = 1 << 13, - GDK_MODIFIER_RESERVED_14_MASK = 1 << 14, - GDK_MODIFIER_RESERVED_15_MASK = 1 << 15, - GDK_MODIFIER_RESERVED_16_MASK = 1 << 16, - GDK_MODIFIER_RESERVED_17_MASK = 1 << 17, - GDK_MODIFIER_RESERVED_18_MASK = 1 << 18, - GDK_MODIFIER_RESERVED_19_MASK = 1 << 19, - GDK_MODIFIER_RESERVED_20_MASK = 1 << 20, - GDK_MODIFIER_RESERVED_21_MASK = 1 << 21, - GDK_MODIFIER_RESERVED_22_MASK = 1 << 22, - GDK_MODIFIER_RESERVED_23_MASK = 1 << 23, - GDK_MODIFIER_RESERVED_24_MASK = 1 << 24, - GDK_MODIFIER_RESERVED_25_MASK = 1 << 25, - - /* The next few modifiers are used by XKB, so we skip to the end. - * Bits 15 - 25 are currently unused. Bit 29 is used internally. - */ - - GDK_SUPER_MASK = 1 << 26, - GDK_HYPER_MASK = 1 << 27, - GDK_META_MASK = 1 << 28, - - GDK_MODIFIER_RESERVED_29_MASK = 1 << 29, - - GDK_RELEASE_MASK = 1 << 30, - - /* Combination of GDK_SHIFT_MASK..GDK_BUTTON5_MASK + GDK_SUPER_MASK - + GDK_HYPER_MASK + GDK_META_MASK + GDK_RELEASE_MASK */ - GDK_MODIFIER_MASK = 0x5c001fff -} GdkModifierType; -</pre> -<p> -A set of bit-flags to indicate the state of modifier keys and mouse buttons -in various event types. Typical modifier keys are Shift, Control, Meta, -Super, Hyper, Alt, Compose, Apple, CapsLock or ShiftLock. -</p> -<p> -Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons. -</p> -<p> -Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped -to Mod2 - Mod5, and indicates this by setting <a class="link" href="gdk3-Windows.html#GDK-SUPER-MASK:CAPS"><code class="literal">GDK_SUPER_MASK</code></a>, -<a class="link" href="gdk3-Windows.html#GDK-HYPER-MASK:CAPS"><code class="literal">GDK_HYPER_MASK</code></a> or <a class="link" href="gdk3-Windows.html#GDK-META-MASK:CAPS"><code class="literal">GDK_META_MASK</code></a> in the state field of key events. -</p> -<p> -Note that GDK may add internal values to events which include -reserved values such as <a class="link" href="gdk3-Windows.html#GDK-MODIFIER-RESERVED-13-MASK:CAPS"><code class="literal">GDK_MODIFIER_RESERVED_13_MASK</code></a>. Your code -should preserve and ignore them. You can use <a class="link" href="gdk3-Windows.html#GDK-MODIFIER-MASK:CAPS"><code class="literal">GDK_MODIFIER_MASK</code></a> to -remove all reserved values. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-SHIFT-MASK:CAPS"></a><span class="term"><code class="literal">GDK_SHIFT_MASK</code></span></p></td> -<td>the Shift key. -</td> -</tr> -<tr> -<td><p><a name="GDK-LOCK-MASK:CAPS"></a><span class="term"><code class="literal">GDK_LOCK_MASK</code></span></p></td> -<td>a Lock key (depending on the modifier mapping of the - X server this may either be CapsLock or ShiftLock). -</td> -</tr> -<tr> -<td><p><a name="GDK-CONTROL-MASK:CAPS"></a><span class="term"><code class="literal">GDK_CONTROL_MASK</code></span></p></td> -<td>the Control key. -</td> -</tr> -<tr> -<td><p><a name="GDK-MOD1-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MOD1_MASK</code></span></p></td> -<td>the fourth modifier key (it depends on the modifier - mapping of the X server which key is interpreted as this modifier, but - normally it is the Alt key). -</td> -</tr> -<tr> -<td><p><a name="GDK-MOD2-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MOD2_MASK</code></span></p></td> -<td>the fifth modifier key (it depends on the modifier - mapping of the X server which key is interpreted as this modifier). -</td> -</tr> -<tr> -<td><p><a name="GDK-MOD3-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MOD3_MASK</code></span></p></td> -<td>the sixth modifier key (it depends on the modifier - mapping of the X server which key is interpreted as this modifier). -</td> -</tr> -<tr> -<td><p><a name="GDK-MOD4-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MOD4_MASK</code></span></p></td> -<td>the seventh modifier key (it depends on the modifier - mapping of the X server which key is interpreted as this modifier). -</td> -</tr> -<tr> -<td><p><a name="GDK-MOD5-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MOD5_MASK</code></span></p></td> -<td>the eighth modifier key (it depends on the modifier - mapping of the X server which key is interpreted as this modifier). -</td> -</tr> -<tr> -<td><p><a name="GDK-BUTTON1-MASK:CAPS"></a><span class="term"><code class="literal">GDK_BUTTON1_MASK</code></span></p></td> -<td>the first mouse button. -</td> -</tr> -<tr> -<td><p><a name="GDK-BUTTON2-MASK:CAPS"></a><span class="term"><code class="literal">GDK_BUTTON2_MASK</code></span></p></td> -<td>the second mouse button. -</td> -</tr> -<tr> -<td><p><a name="GDK-BUTTON3-MASK:CAPS"></a><span class="term"><code class="literal">GDK_BUTTON3_MASK</code></span></p></td> -<td>the third mouse button. -</td> -</tr> -<tr> -<td><p><a name="GDK-BUTTON4-MASK:CAPS"></a><span class="term"><code class="literal">GDK_BUTTON4_MASK</code></span></p></td> -<td>the fourth mouse button. -</td> -</tr> -<tr> -<td><p><a name="GDK-BUTTON5-MASK:CAPS"></a><span class="term"><code class="literal">GDK_BUTTON5_MASK</code></span></p></td> -<td>the fifth mouse button. -</td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-13-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_13_MASK</code></span></p></td> -<td>A reserved bit flag; do not use in your own code -</td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-14-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_14_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-15-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_15_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-16-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_16_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-17-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_17_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-18-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_18_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-19-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_19_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-20-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_20_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-21-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_21_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-22-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_22_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-23-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_23_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-24-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_24_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-25-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_25_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-SUPER-MASK:CAPS"></a><span class="term"><code class="literal">GDK_SUPER_MASK</code></span></p></td> -<td>the Super modifier. Since 2.10 -</td> -</tr> -<tr> -<td><p><a name="GDK-HYPER-MASK:CAPS"></a><span class="term"><code class="literal">GDK_HYPER_MASK</code></span></p></td> -<td>the Hyper modifier. Since 2.10 -</td> -</tr> -<tr> -<td><p><a name="GDK-META-MASK:CAPS"></a><span class="term"><code class="literal">GDK_META_MASK</code></span></p></td> -<td>the Meta modifier. Since 2.10 -</td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-RESERVED-29-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_RESERVED_29_MASK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GDK-RELEASE-MASK:CAPS"></a><span class="term"><code class="literal">GDK_RELEASE_MASK</code></span></p></td> -<td>not used in GDK itself. GTK+ uses it to differentiate - between (keyval, modifiers) pairs from key press and release events. -</td> -</tr> -<tr> -<td><p><a name="GDK-MODIFIER-MASK:CAPS"></a><span class="term"><code class="literal">GDK_MODIFIER_MASK</code></span></p></td> -<td>a mask covering all modifier types. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-parent"></a><h3>gdk_window_get_parent ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Obtains the parent of <em class="parameter"><code>window</code></em>, as known to GDK. Does not query the -X server; thus this returns the parent as passed to <a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()"><code class="function">gdk_window_new()</code></a>, -not the actual parent. This should never matter unless you're using -Xlib calls mixed with GDK calls on the X11 platform. It may also -matter for toplevel windows, because the window manager may choose -to reparent them. -</p> -<p> -Note that you should use <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()"><code class="function">gdk_window_get_effective_parent()</code></a> when -writing generic code that walks up a window hierarchy, because -<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> will most likely not do what you expect if -there are offscreen windows in the hierarchy. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>parent of <em class="parameter"><code>window</code></em>. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-toplevel"></a><h3>gdk_window_get_toplevel ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_toplevel (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the toplevel window that's an ancestor of <em class="parameter"><code>window</code></em>. -</p> -<p> -Any window type but <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> is considered a -toplevel window, as is a <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> window that -has a root window as parent. -</p> -<p> -Note that you should use <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-toplevel" title="gdk_window_get_effective_toplevel ()"><code class="function">gdk_window_get_effective_toplevel()</code></a> when -you want to get to a window's toplevel as seen on screen, because -<a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()"><code class="function">gdk_window_get_toplevel()</code></a> will most likely not do what you expect -if there are offscreen windows in the hierarchy. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the toplevel window containing <em class="parameter"><code>window</code></em>. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-children"></a><h3>gdk_window_get_children ()</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_window_get_children (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the list of children of <em class="parameter"><code>window</code></em> known to GDK. -This function only returns children created via GDK, -so for example it's useless when used with the root window; -it only returns windows an application created itself. -</p> -<p> -The returned list must be freed, but the elements in the -list need not be. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>list of child windows inside <em class="parameter"><code>window</code></em>. <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> GdkWindow]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-peek-children"></a><h3>gdk_window_peek_children ()</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_window_peek_children (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Like <a class="link" href="gdk3-Windows.html#gdk-window-get-children" title="gdk_window_get_children ()"><code class="function">gdk_window_get_children()</code></a>, but does not copy the list of -children, so the list does not need to be freed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a reference to the list of child windows in <em class="parameter"><code>window</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-events"></a><h3>gdk_window_get_events ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> gdk_window_get_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the event mask for <em class="parameter"><code>window</code></em> for all master input devices. See -<a class="link" href="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()"><code class="function">gdk_window_set_events()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-events"></a><h3>gdk_window_set_events ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre> -<p> -The event mask for a window determines which events will be reported -for that window from all master input devices. For example, an event mask -including <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> means the window should report button -press events. The event mask is the bitwise OR of values from the -<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> enumeration. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event_mask</code></em> :</span></p></td> -<td>event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-icon-name"></a><h3>gdk_window_set_icon_name ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_icon_name (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre> -<p> -Windows may have a name used while minimized, distinct from the -name they display in their titlebar. Most of the time this is a bad -idea from a user interface standpoint. But you can set such a name -with this function, if you like. -</p> -<p> -After calling this with a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <em class="parameter"><code>name</code></em>, calls to <a class="link" href="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()"><code class="function">gdk_window_set_title()</code></a> -will not update the icon title. -</p> -<p> -Using <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for <em class="parameter"><code>name</code></em> unsets the icon title; further calls to -<a class="link" href="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()"><code class="function">gdk_window_set_title()</code></a> will again update the icon title as well. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> -<td>name of window while iconified (minimized). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-transient-for"></a><h3>gdk_window_set_transient_for ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_transient_for (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>);</pre> -<p> -Indicates to the window manager that <em class="parameter"><code>window</code></em> is a transient dialog -associated with the application window <em class="parameter"><code>parent</code></em>. This allows the -window manager to do things like center <em class="parameter"><code>window</code></em> on <em class="parameter"><code>parent</code></em> and -keep <em class="parameter"><code>window</code></em> above <em class="parameter"><code>parent</code></em>. -</p> -<p> -See <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-transient-for"><code class="function">gtk_window_set_transient_for()</code></a> if you're using <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> or -<a href="http://library.gnome.org/devel/gtk3/GtkDialog.html"><span class="type">GtkDialog</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td> -<td>another toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-role"></a><h3>gdk_window_set_role ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_role (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *role</code></em>);</pre> -<p> -When using GTK+, typically you should use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-role"><code class="function">gtk_window_set_role()</code></a> instead -of this low-level function. -</p> -<p> -The window manager and session manager use a window's role to -distinguish it from other kinds of window in the same application. -When an application is restarted after being saved in a previous -session, all windows with the same title and role are treated as -interchangeable. So if you have two windows with the same title -that should be distinguished for session management purposes, you -should set the role on those windows. It doesn't matter what string -you use for the role, as long as you have a different role for each -non-interchangeable kind of window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td> -<td>a string indicating its role</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-startup-id"></a><h3>gdk_window_set_startup_id ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_startup_id (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);</pre> -<p> -When using GTK+, typically you should use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-startup-id"><code class="function">gtk_window_set_startup_id()</code></a> -instead of this low-level function. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>startup_id</code></em> :</span></p></td> -<td>a string with startup-notification identifier</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-group"></a><h3>gdk_window_set_group ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_group (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *leader</code></em>);</pre> -<p> -Sets the group leader window for <em class="parameter"><code>window</code></em>. By default, -GDK sets the group leader for all toplevel windows -to a global window implicitly created by GDK. With this function -you can override this default. -</p> -<p> -The group leader window allows the window manager to distinguish -all windows that belong to a single application. It may for example -allow users to minimize/unminimize all windows belonging to an -application at once. You should only set a non-default group window -if your application pretends to be multiple applications. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>leader</code></em> :</span></p></td> -<td>group leader window, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to restore the default group leader window. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-group"></a><h3>gdk_window_get_group ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_group (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Returns the group leader window for <em class="parameter"><code>window</code></em>. See <a class="link" href="gdk3-Windows.html#gdk-window-set-group" title="gdk_window_set_group ()"><code class="function">gdk_window_set_group()</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>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the group leader window for <em class="parameter"><code>window</code></em>. <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 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-decorations"></a><h3>gdk_window_set_decorations ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_decorations (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> decorations</code></em>);</pre> -<p> -"Decorations" are the features the window manager adds to a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. -This function sets the traditional Motif window manager hints that tell the -window manager which decorations you would like your window to have. -Usually you should use <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-decorated"><code class="function">gtk_window_set_decorated()</code></a> on a <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> instead of -using the GDK function directly. -</p> -<p> -The <em class="parameter"><code>decorations</code></em> argument is the logical OR of the fields in -the <a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> enumeration. If <a class="link" href="gdk3-Windows.html#GDK-DECOR-ALL:CAPS"><span class="type">GDK_DECOR_ALL</span></a> is included in the -mask, the other bits indicate which decorations should be turned off. -If <a class="link" href="gdk3-Windows.html#GDK-DECOR-ALL:CAPS"><span class="type">GDK_DECOR_ALL</span></a> is not included, then the other bits indicate -which decorations should be turned on. -</p> -<p> -Most window managers honor a decorations hint of 0 to disable all decorations, -but very few honor all possible combinations of bits. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>decorations</code></em> :</span></p></td> -<td>decoration hint mask</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-decorations"></a><h3>gdk_window_get_decorations ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_decorations (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> *decorations</code></em>);</pre> -<p> -Returns the decorations set on the GdkWindow with -<a class="link" href="gdk3-Windows.html#gdk-window-set-decorations" title="gdk_window_set_decorations ()"><code class="function">gdk_window_set_decorations()</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>window</code></em> :</span></p></td> -<td>The toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> to get the decorations from</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>decorations</code></em> :</span></p></td> -<td>The window decorations will be written here. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window has decorations set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWMDecoration"></a><h3>enum GdkWMDecoration</h3> -<pre class="programlisting">typedef enum { - GDK_DECOR_ALL = 1 << 0, - GDK_DECOR_BORDER = 1 << 1, - GDK_DECOR_RESIZEH = 1 << 2, - GDK_DECOR_TITLE = 1 << 3, - GDK_DECOR_MENU = 1 << 4, - GDK_DECOR_MINIMIZE = 1 << 5, - GDK_DECOR_MAXIMIZE = 1 << 6 -} GdkWMDecoration; -</pre> -<p> -These are hints originally defined by the Motif toolkit. -The window manager can use them when determining how to decorate -the window. The hint must be set before mapping the window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-DECOR-ALL:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_ALL</code></span></p></td> -<td>all decorations should be applied. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-BORDER:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_BORDER</code></span></p></td> -<td>a frame should be drawn around the window. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-RESIZEH:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_RESIZEH</code></span></p></td> -<td>the frame should have resize handles. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-TITLE:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_TITLE</code></span></p></td> -<td>a titlebar should be placed above the window. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-MENU:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_MENU</code></span></p></td> -<td>a button for opening a menu should be included. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-MINIMIZE:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_MINIMIZE</code></span></p></td> -<td>a minimize button should be included. -</td> -</tr> -<tr> -<td><p><a name="GDK-DECOR-MAXIMIZE:CAPS"></a><span class="term"><code class="literal">GDK_DECOR_MAXIMIZE</code></span></p></td> -<td>a maximize button should be included. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-functions"></a><h3>gdk_window_set_functions ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_functions (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction"><span class="type">GdkWMFunction</span></a> functions</code></em>);</pre> -<p> -Sets hints about the window management functions to make available -via buttons on the window frame. -</p> -<p> -On the X backend, this function sets the traditional Motif window -manager hint for this purpose. However, few window managers do -anything reliable or interesting with this hint. Many ignore it -entirely. -</p> -<p> -The <em class="parameter"><code>functions</code></em> argument is the logical OR of values from the -<a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction"><span class="type">GdkWMFunction</span></a> enumeration. If the bitmask includes <a class="link" href="gdk3-Windows.html#GDK-FUNC-ALL:CAPS"><span class="type">GDK_FUNC_ALL</span></a>, -then the other bits indicate which functions to disable; if -it doesn't include <a class="link" href="gdk3-Windows.html#GDK-FUNC-ALL:CAPS"><span class="type">GDK_FUNC_ALL</span></a>, it indicates which functions to -enable. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>functions</code></em> :</span></p></td> -<td>bitmask of operations to allow on <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWMFunction"></a><h3>enum GdkWMFunction</h3> -<pre class="programlisting">typedef enum { - GDK_FUNC_ALL = 1 << 0, - GDK_FUNC_RESIZE = 1 << 1, - GDK_FUNC_MOVE = 1 << 2, - GDK_FUNC_MINIMIZE = 1 << 3, - GDK_FUNC_MAXIMIZE = 1 << 4, - GDK_FUNC_CLOSE = 1 << 5 -} GdkWMFunction; -</pre> -<p> -These are hints originally defined by the Motif toolkit. The window manager -can use them when determining the functions to offer for the window. The -hint must be set before mapping the window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GDK-FUNC-ALL:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_ALL</code></span></p></td> -<td>all functions should be offered. -</td> -</tr> -<tr> -<td><p><a name="GDK-FUNC-RESIZE:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_RESIZE</code></span></p></td> -<td>the window should be resizable. -</td> -</tr> -<tr> -<td><p><a name="GDK-FUNC-MOVE:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_MOVE</code></span></p></td> -<td>the window should be movable. -</td> -</tr> -<tr> -<td><p><a name="GDK-FUNC-MINIMIZE:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_MINIMIZE</code></span></p></td> -<td>the window should be minimizable. -</td> -</tr> -<tr> -<td><p><a name="GDK-FUNC-MAXIMIZE:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_MAXIMIZE</code></span></p></td> -<td>the window should be maximizable. -</td> -</tr> -<tr> -<td><p><a name="GDK-FUNC-CLOSE:CAPS"></a><span class="term"><code class="literal">GDK_FUNC_CLOSE</code></span></p></td> -<td>the window should be closable. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-get-default-root-window"></a><h3>gdk_get_default_root_window ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_get_default_root_window (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -Obtains the root window (parent all other windows are inside) -for the default display and screen. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the default root window. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-support-multidevice"></a><h3>gdk_window_get_support_multidevice ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_window_get_support_multidevice (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window is aware of the existence of multiple -devices. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window handles multidevice features.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-support-multidevice"></a><h3>gdk_window_set_support_multidevice ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_support_multidevice (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_multidevice</code></em>);</pre> -<p> -This function will enable multidevice features in <em class="parameter"><code>window</code></em>. -</p> -<p> -Multidevice aware windows will need to handle properly multiple, -per device enter/leave events, device grabs and grab ownerships. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>support_multidevice</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable multidevice support in <em class="parameter"><code>window</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-device-cursor"></a><h3>gdk_window_get_device_cursor ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> * gdk_window_get_device_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre> -<p> -Retrieves a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> pointer for the <em class="parameter"><code>device</code></em> currently set on the -specified <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If the return value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then -there is no custom cursor set on the specified window, and it is -using the cursor for its parent window. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>a master, pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The returned -object is owned by the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> and should not be unreferenced -directly. Use <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> to unset the cursor of the -window. <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-window-set-device-cursor"></a><h3>gdk_window_set_device_cursor ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_device_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre> -<p> -Sets a specific <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> for a given device when it gets inside <em class="parameter"><code>window</code></em>. -Use <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()"><code class="function">gdk_cursor_new_for_display()</code></a> or <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()"><code class="function">gdk_cursor_new_from_pixbuf()</code></a> to create -the cursor. To make the cursor invisible, use <a class="link" href="gdk3-Cursors.html#GDK-BLANK-CURSOR:CAPS"><code class="literal">GDK_BLANK_CURSOR</code></a>. Passing -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>cursor</code></em> argument to <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> means that -<em class="parameter"><code>window</code></em> will use the cursor of its parent window. Most windows should -use this default. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <span class="type">Gdkwindow</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>a master, pointer <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>cursor</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-device-events"></a><h3>gdk_window_get_device_events ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> gdk_window_get_device_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre> -<p> -Returns the event mask for <em class="parameter"><code>window</code></em> corresponding to an specific device. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td>a <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>device event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-device-events"></a><h3>gdk_window_set_device_events ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_device_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre> -<p> -Sets the event mask for a given device (Normally a floating device, not -attached to any visible pointer) to <em class="parameter"><code>window</code></em>. For example, an event mask -including <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> means the window should report button -press events. The event mask is the bitwise OR of values from the -<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> enumeration. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td> -<td> -<a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to enable events for.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event_mask</code></em> :</span></p></td> -<td>event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-source-events"></a><h3>gdk_window_get_source_events ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a> gdk_window_get_source_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>);</pre> -<p> -Returns the event mask for <em class="parameter"><code>window</code></em> corresponding to the device class specified -by <em class="parameter"><code>source</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td> -<td>a <a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> to define the source class.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>source event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-set-source-events"></a><h3>gdk_window_set_source_events ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_set_source_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre> -<p> -Sets the event mask for any floating device (i.e. not attached to any -visible pointer) that has the source defined as <em class="parameter"><code>source</code></em>. This event -mask will be applied both to currently existing, newly added devices -after this call, and devices being attached/detached. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td> -<td>a <a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> to define the source class.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event_mask</code></em> :</span></p></td> -<td>event mask for <em class="parameter"><code>window</code></em> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-offscreen-window-get-surface"></a><h3>gdk_offscreen_window_get_surface ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="returnvalue">cairo_surface_t</span></a> * gdk_offscreen_window_get_surface (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the offscreen surface that an offscreen window renders into. -If you need to keep this around over window resizes, you need to -add a reference to it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The offscreen surface, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not offscreen. <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> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-offscreen-window-set-embedder"></a><h3>gdk_offscreen_window_set_embedder ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_offscreen_window_set_embedder (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *embedder</code></em>);</pre> -<p> -Sets <em class="parameter"><code>window</code></em> to be embedded in <em class="parameter"><code>embedder</code></em>. -</p> -<p> -To fully embed an offscreen window, in addition to calling this -function, it is also necessary to handle the <a class="link" href="gdk3-Windows.html#GdkWindow-pick-embedded-child" title='The "pick-embedded-child" signal'><span class="type">"pick-embedded-child"</span></a> -signal on the <em class="parameter"><code>embedder</code></em> and the <a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title='The "to-embedder" signal'><span class="type">"to-embedder"</span></a> and -<a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title='The "from-embedder" signal'><span class="type">"from-embedder"</span></a> signals on <em class="parameter"><code>window</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>embedder</code></em> :</span></p></td> -<td>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that <em class="parameter"><code>window</code></em> gets embedded in</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-offscreen-window-get-embedder"></a><h3>gdk_offscreen_window_get_embedder ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_offscreen_window_get_embedder (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the window that <em class="parameter"><code>window</code></em> is embedded in. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the embedding <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -if <em class="parameter"><code>window</code></em> is not an mbedded offscreen window. <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 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-geometry-changed"></a><h3>gdk_window_geometry_changed ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_geometry_changed (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -This function informs GDK that the geometry of an embedded -offscreen window has changed. This is necessary for GDK to keep -track of which offscreen window the pointer is in. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>an embedded offscreen <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-coords-from-parent"></a><h3>gdk_window_coords_from_parent ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_coords_from_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> parent_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> parent_y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *y</code></em>);</pre> -<p> -Transforms window coordinates from a parent window to a child -window, where the parent window is the normal parent as returned by -<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, and the window's -embedder as returned by <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a> for -offscreen windows. -</p> -<p> -For normal windows, calling this function is equivalent to subtracting -the return values of <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> from the parent coordinates. -For offscreen windows however (which can be arbitrarily transformed), -this function calls the GdkWindow::from-embedder: signal to translate -the coordinates. -</p> -<p> -You should always use this function when writing generic code that -walks down a window hierarchy. -</p> -<p> -See also: <a class="link" href="gdk3-Windows.html#gdk-window-coords-to-parent" title="gdk_window_coords_to_parent ()"><code class="function">gdk_window_coords_to_parent()</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>window</code></em> :</span></p></td> -<td>a child window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent_x</code></em> :</span></p></td> -<td>X coordinate in parent's coordinate system</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent_y</code></em> :</span></p></td> -<td>Y coordinate in parent's coordinate system</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>return location for X coordinate in child's coordinate system. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>return location for Y coordinate in child's coordinate system. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-coords-to-parent"></a><h3>gdk_window_coords_to_parent ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gdk_window_coords_to_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *parent_x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *parent_y</code></em>);</pre> -<p> -Transforms window coordinates from a child window to its parent -window, where the parent window is the normal parent as returned by -<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, and the window's -embedder as returned by <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a> for -offscreen windows. -</p> -<p> -For normal windows, calling this function is equivalent to adding -the return values of <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> to the child coordinates. -For offscreen windows however (which can be arbitrarily transformed), -this function calls the GdkWindow::to-embedder: signal to translate -the coordinates. -</p> -<p> -You should always use this function when writing generic code that -walks up a window hierarchy. -</p> -<p> -See also: <a class="link" href="gdk3-Windows.html#gdk-window-coords-from-parent" title="gdk_window_coords_from_parent ()"><code class="function">gdk_window_coords_from_parent()</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>window</code></em> :</span></p></td> -<td>a child window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>X coordinate in child's coordinate system</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>Y coordinate in child's coordinate system</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent_x</code></em> :</span></p></td> -<td>return location for X coordinate -in parent's coordinate system, 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 for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>parent_y</code></em> :</span></p></td> -<td>return location for Y coordinate -in parent's coordinate system, 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 for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-effective-parent"></a><h3>gdk_window_get_effective_parent ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_effective_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Obtains the parent of <em class="parameter"><code>window</code></em>, as known to GDK. Works like -<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, but returns the -window's embedder for offscreen windows. -</p> -<p> -See also: <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>effective parent of <em class="parameter"><code>window</code></em>. <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 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gdk-window-get-effective-toplevel"></a><h3>gdk_window_get_effective_toplevel ()</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> * gdk_window_get_effective_toplevel (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre> -<p> -Gets the toplevel window that's an ancestor of <em class="parameter"><code>window</code></em>. -</p> -<p> -Works like <a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()"><code class="function">gdk_window_get_toplevel()</code></a>, but treats an offscreen window's -embedder as its parent, using <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()"><code class="function">gdk_window_get_effective_parent()</code></a>. -</p> -<p> -See also: <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</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>window</code></em> :</span></p></td> -<td>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the effective toplevel window containing <em class="parameter"><code>window</code></em>. <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 2.22</p> -</div> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="GdkWindow--cursor"></a><h3>The <code class="literal">"cursor"</code> property</h3> -<pre class="programlisting"> "cursor" <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>* : Read / Write</pre> -<p> -The mouse pointer for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. See <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> and -<a class="link" href="gdk3-Windows.html#gdk-window-get-cursor" title="gdk_window_get_cursor ()"><code class="function">gdk_window_get_cursor()</code></a> for details. -</p> -<p class="since">Since 2.18</p> -</div> -</div> -<div class="refsect1"> -<a name="gdk3-Windows.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="GdkWindow-create-surface"></a><h3>The <code class="literal">"create-surface"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">CairoSurface</span>* user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height, - <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 ::create-surface signal is emitted when an offscreen window -needs its surface (re)created, which happens either when the the -window is first drawn to, or when the window is being -resized. The first signal handler that returns a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -surface will stop any further signal emission, and its surface -will be used. -</p> -<p> -Note that it is not possible to access the window's previous -surface from within any callback of this signal. Calling -<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()"><code class="function">gdk_offscreen_window_get_surface()</code></a> will lead to a crash. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>the offscreen window on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> -<td>the width of the offscreen surface to create</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> -<td>the height of the offscreen surface to create</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> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the newly created <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="type">cairo_surface_t</span></a> for the offscreen window</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindow-from-embedder"></a><h3>The <code class="literal">"from-embedder"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> embedder-x, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> embedder-y, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> offscreen-x, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> offscreen-y, - <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 ::from-embedder signal is emitted to translate coordinates -in the embedder of an offscreen window to the offscreen window. -</p> -<p> -See also <span class="type">"to-embedder"</span>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>the offscreen window on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>embedder-x</code></em> :</span></p></td> -<td>x coordinate in the embedder window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>embedder-y</code></em> :</span></p></td> -<td>y coordinate in the embedder window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offscreen-x</code></em> :</span></p></td> -<td>return location for the x -coordinate in the offscreen window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offscreen-y</code></em> :</span></p></td> -<td>return location for the y -coordinate in the offscreen window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span> -</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> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindow-pick-embedded-child"></a><h3>The <code class="literal">"pick-embedded-child"</code> signal</h3> -<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a>* user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y, - <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 ::pick-embedded-child signal is emitted to find an embedded -child at the given position. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>the window on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>x coordinate in the window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>y coordinate in the window</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> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> of the embedded child at -<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>, 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="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 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GdkWindow-to-embedder"></a><h3>The <code class="literal">"to-embedder"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> offscreen-x, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> offscreen-y, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> embedder-x, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> embedder-y, - <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 ::to-embedder signal is emitted to translate coordinates -in an offscreen window to its embedder. -</p> -<p> -See also <span class="type">"from-embedder"</span>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td> -<td>the offscreen window on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offscreen-x</code></em> :</span></p></td> -<td>x coordinate in the offscreen window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>offscreen-y</code></em> :</span></p></td> -<td>y coordinate in the offscreen window</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>embedder-x</code></em> :</span></p></td> -<td>return location for the x -coordinate in the embedder window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>embedder-y</code></em> :</span></p></td> -<td>return location for the y -coordinate in the embedder window. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span> -</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> -<p class="since">Since 2.18</p> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |