1 /* GDK - The GIMP Drawing Kit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
25 #if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
26 #error "Only <gdk/gdk.h> can be included directly."
29 #ifndef __GDK_WINDOW_H__
30 #define __GDK_WINDOW_H__
32 #include <gdk/gdkversionmacros.h>
33 #include <gdk/gdktypes.h>
34 #include <gdk/gdkevents.h>
38 typedef struct _GdkGeometry GdkGeometry;
39 typedef struct _GdkWindowAttr GdkWindowAttr;
40 typedef struct _GdkWindowRedirect GdkWindowRedirect;
43 * GdkWindowWindowClass:
44 * @GDK_INPUT_OUTPUT: window for graphics and events
45 * @GDK_INPUT_ONLY: window for events only
47 * @GDK_INPUT_OUTPUT windows are the standard kind of window you might expect.
48 * Such windows receive events and are also displayed on screen.
49 * @GDK_INPUT_ONLY windows are invisible; they are usually placed above other
50 * windows in order to trap or filter the events. You can't draw on
51 * @GDK_INPUT_ONLY windows.
55 GDK_INPUT_OUTPUT, /*< nick=input-output >*/
56 GDK_INPUT_ONLY /*< nick=input-only >*/
57 } GdkWindowWindowClass;
61 * @GDK_WINDOW_ROOT: root window; this window has no parent, covers the entire
62 * screen, and is created by the window system
63 * @GDK_WINDOW_TOPLEVEL: toplevel window (used to implement #GtkWindow)
64 * @GDK_WINDOW_CHILD: child window (used to implement e.g. #GtkEntry)
65 * @GDK_WINDOW_TEMP: override redirect temporary window (used to implement
67 * @GDK_WINDOW_FOREIGN: foreign window (see gdk_window_foreign_new())
68 * @GDK_WINDOW_OFFSCREEN: offscreen window (see
69 * <xref linkend="OFFSCREEN-WINDOWS"/>). Since 2.18
71 * Describes the kind of window.
84 * GdkWindowAttributesType:
85 * @GDK_WA_TITLE: Honor the title field
86 * @GDK_WA_X: Honor the X coordinate field
87 * @GDK_WA_Y: Honor the Y coordinate field
88 * @GDK_WA_CURSOR: Honor the cursor field
89 * @GDK_WA_VISUAL: Honor the visual field
90 * @GDK_WA_WMCLASS: Honor the wmclass_class and wmclass_name fields
91 * @GDK_WA_NOREDIR: Honor the override_redirect field
92 * @GDK_WA_TYPE_HINT: Honor the type_hint field
94 * Used to indicate which fields in the #GdkWindowAttr struct should be honored.
95 * For example, if you filled in the "cursor" and "x" fields of #GdkWindowAttr,
96 * pass "@GDK_WA_X | @GDK_WA_CURSOR" to gdk_window_new(). Fields in
97 * #GdkWindowAttr not covered by a bit in this enum are required; for example,
98 * the @width/@height, @wclass, and @window_type fields are required, they have
99 * no corresponding flag in #GdkWindowAttributesType.
103 GDK_WA_TITLE = 1 << 1,
106 GDK_WA_CURSOR = 1 << 4,
107 GDK_WA_VISUAL = 1 << 5,
108 GDK_WA_WMCLASS = 1 << 6,
109 GDK_WA_NOREDIR = 1 << 7,
110 GDK_WA_TYPE_HINT = 1 << 8
111 } GdkWindowAttributesType;
113 /* Size restriction enumeration.
117 * @GDK_HINT_POS: indicates that the program has positioned the window
118 * @GDK_HINT_MIN_SIZE: min size fields are set
119 * @GDK_HINT_MAX_SIZE: max size fields are set
120 * @GDK_HINT_BASE_SIZE: base size fields are set
121 * @GDK_HINT_ASPECT: aspect ratio fields are set
122 * @GDK_HINT_RESIZE_INC: resize increment fields are set
123 * @GDK_HINT_WIN_GRAVITY: window gravity field is set
124 * @GDK_HINT_USER_POS: indicates that the window's position was explicitly set
126 * @GDK_HINT_USER_SIZE: indicates that the window's size was explicitly set by
129 * Used to indicate which fields of a #GdkGeometry struct should be paid
130 * attention to. Also, the presence/absence of @GDK_HINT_POS,
131 * @GDK_HINT_USER_POS, and @GDK_HINT_USER_SIZE is significant, though they don't
132 * directly refer to #GdkGeometry fields. @GDK_HINT_USER_POS will be set
133 * automatically by #GtkWindow if you call gtk_window_move().
134 * @GDK_HINT_USER_POS and @GDK_HINT_USER_SIZE should be set if the user
135 * specified a size/position using a --geometry command-line argument;
136 * gtk_window_parse_geometry() automatically sets these flags.
140 GDK_HINT_POS = 1 << 0,
141 GDK_HINT_MIN_SIZE = 1 << 1,
142 GDK_HINT_MAX_SIZE = 1 << 2,
143 GDK_HINT_BASE_SIZE = 1 << 3,
144 GDK_HINT_ASPECT = 1 << 4,
145 GDK_HINT_RESIZE_INC = 1 << 5,
146 GDK_HINT_WIN_GRAVITY = 1 << 6,
147 GDK_HINT_USER_POS = 1 << 7,
148 GDK_HINT_USER_SIZE = 1 << 8
154 * @GDK_WINDOW_TYPE_HINT_NORMAL: Normal toplevel window.
155 * @GDK_WINDOW_TYPE_HINT_DIALOG: Dialog window.
156 * @GDK_WINDOW_TYPE_HINT_MENU: Window used to implement a menu; GTK+ uses
157 * this hint only for torn-off menus, see #GtkTearoffMenuItem.
158 * @GDK_WINDOW_TYPE_HINT_TOOLBAR: Window used to implement toolbars.
159 * @GDK_WINDOW_TYPE_HINT_SPLASHSCREEN: Window used to display a splash
160 * screen during application startup.
161 * @GDK_WINDOW_TYPE_HINT_UTILITY: Utility windows which are not detached
162 * toolbars or dialogs.
163 * @GDK_WINDOW_TYPE_HINT_DOCK: Used for creating dock or panel windows.
164 * @GDK_WINDOW_TYPE_HINT_DESKTOP: Used for creating the desktop background
166 * @GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU: A menu that belongs to a menubar.
167 * @GDK_WINDOW_TYPE_HINT_POPUP_MENU: A menu that does not belong to a menubar,
168 * e.g. a context menu.
169 * @GDK_WINDOW_TYPE_HINT_TOOLTIP: A tooltip.
170 * @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a "bubble"
171 * that belongs to a status icon.
172 * @GDK_WINDOW_TYPE_HINT_COMBO: A popup from a combo box.
173 * @GDK_WINDOW_TYPE_HINT_DND: A window that is used to implement a DND cursor.
175 * These are hints for the window manager that indicate what type of function
176 * the window has. The window manager can use this when determining decoration
177 * and behaviour of the window. The hint must be set before mapping the window.
180 * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
181 * Window Manager Hints</ulink> specification for more details about
186 GDK_WINDOW_TYPE_HINT_NORMAL,
187 GDK_WINDOW_TYPE_HINT_DIALOG,
188 GDK_WINDOW_TYPE_HINT_MENU, /* Torn off menu */
189 GDK_WINDOW_TYPE_HINT_TOOLBAR,
190 GDK_WINDOW_TYPE_HINT_SPLASHSCREEN,
191 GDK_WINDOW_TYPE_HINT_UTILITY,
192 GDK_WINDOW_TYPE_HINT_DOCK,
193 GDK_WINDOW_TYPE_HINT_DESKTOP,
194 GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU, /* A drop down menu (from a menubar) */
195 GDK_WINDOW_TYPE_HINT_POPUP_MENU, /* A popup menu (from right-click) */
196 GDK_WINDOW_TYPE_HINT_TOOLTIP,
197 GDK_WINDOW_TYPE_HINT_NOTIFICATION,
198 GDK_WINDOW_TYPE_HINT_COMBO,
199 GDK_WINDOW_TYPE_HINT_DND
202 /* The next two enumeration values current match the
203 * Motif constants. If this is changed, the implementation
204 * of gdk_window_set_decorations/gdk_window_set_functions
205 * will need to change as well.
209 * @GDK_DECOR_ALL: all decorations should be applied.
210 * @GDK_DECOR_BORDER: a frame should be drawn around the window.
211 * @GDK_DECOR_RESIZEH: the frame should have resize handles.
212 * @GDK_DECOR_TITLE: a titlebar should be placed above the window.
213 * @GDK_DECOR_MENU: a button for opening a menu should be included.
214 * @GDK_DECOR_MINIMIZE: a minimize button should be included.
215 * @GDK_DECOR_MAXIMIZE: a maximize button should be included.
217 * These are hints originally defined by the Motif toolkit.
218 * The window manager can use them when determining how to decorate
219 * the window. The hint must be set before mapping the window.
223 GDK_DECOR_ALL = 1 << 0,
224 GDK_DECOR_BORDER = 1 << 1,
225 GDK_DECOR_RESIZEH = 1 << 2,
226 GDK_DECOR_TITLE = 1 << 3,
227 GDK_DECOR_MENU = 1 << 4,
228 GDK_DECOR_MINIMIZE = 1 << 5,
229 GDK_DECOR_MAXIMIZE = 1 << 6
234 * @GDK_FUNC_ALL: all functions should be offered.
235 * @GDK_FUNC_RESIZE: the window should be resizable.
236 * @GDK_FUNC_MOVE: the window should be movable.
237 * @GDK_FUNC_MINIMIZE: the window should be minimizable.
238 * @GDK_FUNC_MAXIMIZE: the window should be maximizable.
239 * @GDK_FUNC_CLOSE: the window should be closable.
241 * These are hints originally defined by the Motif toolkit. The window manager
242 * can use them when determining the functions to offer for the window. The
243 * hint must be set before mapping the window.
247 GDK_FUNC_ALL = 1 << 0,
248 GDK_FUNC_RESIZE = 1 << 1,
249 GDK_FUNC_MOVE = 1 << 2,
250 GDK_FUNC_MINIMIZE = 1 << 3,
251 GDK_FUNC_MAXIMIZE = 1 << 4,
252 GDK_FUNC_CLOSE = 1 << 5
255 /* Currently, these are the same values numerically as in the
256 * X protocol. If you change that, gdkwindow-x11.c/gdk_window_set_geometry_hints()
261 * @GDK_GRAVITY_NORTH_WEST: the reference point is at the top left corner.
262 * @GDK_GRAVITY_NORTH: the reference point is in the middle of the top edge.
263 * @GDK_GRAVITY_NORTH_EAST: the reference point is at the top right corner.
264 * @GDK_GRAVITY_WEST: the reference point is at the middle of the left edge.
265 * @GDK_GRAVITY_CENTER: the reference point is at the center of the window.
266 * @GDK_GRAVITY_EAST: the reference point is at the middle of the right edge.
267 * @GDK_GRAVITY_SOUTH_WEST: the reference point is at the lower left corner.
268 * @GDK_GRAVITY_SOUTH: the reference point is at the middle of the lower edge.
269 * @GDK_GRAVITY_SOUTH_EAST: the reference point is at the lower right corner.
270 * @GDK_GRAVITY_STATIC: the reference point is at the top left corner of the
271 * window itself, ignoring window manager decorations.
273 * Defines the reference point of a window and the meaning of coordinates
274 * passed to gtk_window_move(). See gtk_window_move() and the "implementation
275 * notes" section of the
276 * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
277 * Window Manager Hints</ulink> specification for more details.
281 GDK_GRAVITY_NORTH_WEST = 1,
283 GDK_GRAVITY_NORTH_EAST,
287 GDK_GRAVITY_SOUTH_WEST,
289 GDK_GRAVITY_SOUTH_EAST,
296 * @GDK_WINDOW_EDGE_NORTH_WEST: the top left corner.
297 * @GDK_WINDOW_EDGE_NORTH: the top edge.
298 * @GDK_WINDOW_EDGE_NORTH_EAST: the top right corner.
299 * @GDK_WINDOW_EDGE_WEST: the left edge.
300 * @GDK_WINDOW_EDGE_EAST: the right edge.
301 * @GDK_WINDOW_EDGE_SOUTH_WEST: the lower left corner.
302 * @GDK_WINDOW_EDGE_SOUTH: the lower edge.
303 * @GDK_WINDOW_EDGE_SOUTH_EAST: the lower right corner.
305 * Determines a window edge or corner.
309 GDK_WINDOW_EDGE_NORTH_WEST,
310 GDK_WINDOW_EDGE_NORTH,
311 GDK_WINDOW_EDGE_NORTH_EAST,
312 GDK_WINDOW_EDGE_WEST,
313 GDK_WINDOW_EDGE_EAST,
314 GDK_WINDOW_EDGE_SOUTH_WEST,
315 GDK_WINDOW_EDGE_SOUTH,
316 GDK_WINDOW_EDGE_SOUTH_EAST
321 * @title: title of the window (for toplevel windows)
322 * @event_mask: event mask (see gdk_window_set_events())
323 * @x: X coordinate relative to parent window (see gdk_window_move())
324 * @y: Y coordinate relative to parent window (see gdk_window_move())
325 * @width: width of window
326 * @height: height of window
327 * @wclass: #GDK_INPUT_OUTPUT (normal window) or #GDK_INPUT_ONLY (invisible
328 * window that receives events)
329 * @visual: #GdkVisual for window
330 * @window_type: type of window
331 * @cursor: cursor for the window (see gdk_window_set_cursor())
332 * @wmclass_name: don't use (see gtk_window_set_wmclass())
333 * @wmclass_class: don't use (see gtk_window_set_wmclass())
334 * @override_redirect: %TRUE to bypass the window manager
335 * @type_hint: a hint of the function of the window
337 * Attributes to use for a newly-created window.
339 struct _GdkWindowAttr
346 GdkWindowWindowClass wclass;
348 GdkWindowType window_type;
351 gchar *wmclass_class;
352 gboolean override_redirect;
353 GdkWindowTypeHint type_hint;
358 * @min_width: minimum width of window (or -1 to use requisition, with
360 * @min_height: minimum height of window (or -1 to use requisition, with
362 * @max_width: maximum width of window (or -1 to use requisition, with
364 * @max_height: maximum height of window (or -1 to use requisition, with
366 * @base_width: allowed window widths are @base_width + @width_inc * N where N
367 * is any integer (-1 allowed with #GtkWindow)
368 * @base_height: allowed window widths are @base_height + @height_inc * N where
369 * N is any integer (-1 allowed with #GtkWindow)
370 * @width_inc: width resize increment
371 * @height_inc: height resize increment
372 * @min_aspect: minimum width/height ratio
373 * @max_aspect: maximum width/height ratio
374 * @win_gravity: window gravity, see gtk_window_set_gravity()
376 * The #GdkGeometry struct gives the window manager information about
377 * a window's geometry constraints. Normally you would set these on
378 * the GTK+ level using gtk_window_set_geometry_hints(). #GtkWindow
379 * then sets the hints on the #GdkWindow it creates.
381 * gdk_window_set_geometry_hints() expects the hints to be fully valid already
382 * and simply passes them to the window manager; in contrast,
383 * gtk_window_set_geometry_hints() performs some interpretation. For example,
384 * #GtkWindow will apply the hints to the geometry widget instead of the
385 * toplevel window, if you set a geometry widget. Also, the
386 * @min_width/@min_height/@max_width/@max_height fields may be set to -1, and
387 * #GtkWindow will substitute the size request of the window or geometry widget.
388 * If the minimum size hint is not provided, #GtkWindow will use its requisition
389 * as the minimum size. If the minimum size is provided and a geometry widget is
390 * set, #GtkWindow will take the minimum size as the minimum size of the
391 * geometry widget rather than the entire window. The base size is treated
394 * The canonical use-case for gtk_window_set_geometry_hints() is to get a
395 * terminal widget to resize properly. Here, the terminal text area should be
396 * the geometry widget; #GtkWindow will then automatically set the base size to
397 * the size of other widgets in the terminal window, such as the menubar and
398 * scrollbar. Then, the @width_inc and @height_inc fields should be set to the
399 * size of one character in the terminal. Finally, the base size should be set
400 * to the size of one character. The net effect is that the minimum size of the
401 * terminal will have a 1x1 character terminal area, and only terminal sizes on
402 * the "character grid" will be allowed.
404 * Here's an example of how the terminal example would be implemented, assuming
405 * a terminal area widget called "terminal" and a toplevel window "toplevel":
407 * <informalexample><programlisting><![CDATA[
410 * hints.base_width = terminal->char_width;
411 * hints.base_height = terminal->char_height;
412 * hints.min_width = terminal->char_width;
413 * hints.min_height = terminal->char_height;
414 * hints.width_inc = terminal->char_width;
415 * hints.height_inc = terminal->char_height;
417 * gtk_window_set_geometry_hints (GTK_WINDOW (toplevel),
418 * GTK_WIDGET (terminal),
420 * GDK_HINT_RESIZE_INC |
421 * GDK_HINT_MIN_SIZE |
422 * GDK_HINT_BASE_SIZE);
423 * ]]></programlisting></informalexample>
425 * The other useful fields are the @min_aspect and @max_aspect fields; these
426 * contain a width/height ratio as a floating point number. If a geometry widget
427 * is set, the aspect applies to the geometry widget rather than the entire
428 * window. The most common use of these hints is probably to set @min_aspect and
429 * @max_aspect to the same value, thus forcing the window to keep a constant
444 GdkGravity win_gravity;
447 typedef struct _GdkWindowClass GdkWindowClass;
449 #define GDK_TYPE_WINDOW (gdk_window_get_type ())
450 #define GDK_WINDOW(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_WINDOW, GdkWindow))
451 #define GDK_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_WINDOW, GdkWindowClass))
452 #define GDK_IS_WINDOW(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_WINDOW))
453 #define GDK_IS_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_WINDOW))
454 #define GDK_WINDOW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_WINDOW, GdkWindowClass))
457 struct _GdkWindowClass
459 GObjectClass parent_class;
461 GdkWindow * (* pick_embedded_child) (GdkWindow *window,
465 /* the following 3 signals will only be emitted by offscreen windows */
466 void (* to_embedder) (GdkWindow *window,
470 gdouble *embedder_y);
471 void (* from_embedder) (GdkWindow *window,
474 gdouble *offscreen_x,
475 gdouble *offscreen_y);
476 cairo_surface_t * (* create_surface) (GdkWindow *window,
480 /* Padding for future expansion */
481 void (*_gdk_reserved1) (void);
482 void (*_gdk_reserved2) (void);
483 void (*_gdk_reserved3) (void);
484 void (*_gdk_reserved4) (void);
485 void (*_gdk_reserved5) (void);
486 void (*_gdk_reserved6) (void);
487 void (*_gdk_reserved7) (void);
488 void (*_gdk_reserved8) (void);
493 GType gdk_window_get_type (void) G_GNUC_CONST;
494 GdkWindow* gdk_window_new (GdkWindow *parent,
495 GdkWindowAttr *attributes,
496 gint attributes_mask);
497 void gdk_window_destroy (GdkWindow *window);
498 GdkWindowType gdk_window_get_window_type (GdkWindow *window);
499 gboolean gdk_window_is_destroyed (GdkWindow *window);
501 GdkVisual * gdk_window_get_visual (GdkWindow *window);
502 GdkScreen * gdk_window_get_screen (GdkWindow *window);
503 GdkDisplay * gdk_window_get_display (GdkWindow *window);
504 #ifndef GDK_MULTIDEVICE_SAFE
505 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_get_window_at_position)
506 GdkWindow* gdk_window_at_pointer (gint *win_x,
508 #endif /* GDK_MULTIDEVICE_SAFE */
509 void gdk_window_show (GdkWindow *window);
510 void gdk_window_hide (GdkWindow *window);
511 void gdk_window_withdraw (GdkWindow *window);
512 void gdk_window_show_unraised (GdkWindow *window);
513 void gdk_window_move (GdkWindow *window,
516 void gdk_window_resize (GdkWindow *window,
519 void gdk_window_move_resize (GdkWindow *window,
524 void gdk_window_reparent (GdkWindow *window,
525 GdkWindow *new_parent,
528 void gdk_window_raise (GdkWindow *window);
529 void gdk_window_lower (GdkWindow *window);
530 void gdk_window_restack (GdkWindow *window,
533 void gdk_window_focus (GdkWindow *window,
535 void gdk_window_set_user_data (GdkWindow *window,
537 void gdk_window_set_override_redirect (GdkWindow *window,
538 gboolean override_redirect);
539 gboolean gdk_window_get_accept_focus (GdkWindow *window);
540 void gdk_window_set_accept_focus (GdkWindow *window,
541 gboolean accept_focus);
542 gboolean gdk_window_get_focus_on_map (GdkWindow *window);
543 void gdk_window_set_focus_on_map (GdkWindow *window,
544 gboolean focus_on_map);
545 void gdk_window_add_filter (GdkWindow *window,
546 GdkFilterFunc function,
548 void gdk_window_remove_filter (GdkWindow *window,
549 GdkFilterFunc function,
551 void gdk_window_scroll (GdkWindow *window,
554 void gdk_window_move_region (GdkWindow *window,
555 const cairo_region_t *region,
558 gboolean gdk_window_ensure_native (GdkWindow *window);
561 * This allows for making shaped (partially transparent) windows
562 * - cool feature, needed for Drag and Drag for example.
564 void gdk_window_shape_combine_region (GdkWindow *window,
565 const cairo_region_t *shape_region,
570 * This routine allows you to quickly take the shapes of all the child windows
571 * of a window and use their shapes as the shape mask for this window - useful
572 * for container windows that dont want to look like a big box
576 void gdk_window_set_child_shapes (GdkWindow *window);
578 gboolean gdk_window_get_composited (GdkWindow *window);
579 void gdk_window_set_composited (GdkWindow *window,
580 gboolean composited);
583 * This routine allows you to merge (ie ADD) child shapes to your
584 * own window's shape keeping its current shape and ADDING the child
589 void gdk_window_merge_child_shapes (GdkWindow *window);
591 void gdk_window_input_shape_combine_region (GdkWindow *window,
592 const cairo_region_t *shape_region,
595 void gdk_window_set_child_input_shapes (GdkWindow *window);
596 void gdk_window_merge_child_input_shapes (GdkWindow *window);
600 * Check if a window has been shown, and whether all its
601 * parents up to a toplevel have been shown, respectively.
602 * Note that a window that is_viewable below is not necessarily
603 * viewable in the X sense.
605 gboolean gdk_window_is_visible (GdkWindow *window);
606 gboolean gdk_window_is_viewable (GdkWindow *window);
607 gboolean gdk_window_is_input_only (GdkWindow *window);
608 gboolean gdk_window_is_shaped (GdkWindow *window);
610 GdkWindowState gdk_window_get_state (GdkWindow *window);
612 /* Set static bit gravity on the parent, and static
613 * window gravity on all children.
615 gboolean gdk_window_set_static_gravities (GdkWindow *window,
616 gboolean use_static);
620 gboolean gdk_window_has_native (GdkWindow *window);
621 void gdk_window_set_type_hint (GdkWindow *window,
622 GdkWindowTypeHint hint);
623 GdkWindowTypeHint gdk_window_get_type_hint (GdkWindow *window);
625 gboolean gdk_window_get_modal_hint (GdkWindow *window);
626 void gdk_window_set_modal_hint (GdkWindow *window,
629 void gdk_window_set_skip_taskbar_hint (GdkWindow *window,
630 gboolean skips_taskbar);
631 void gdk_window_set_skip_pager_hint (GdkWindow *window,
632 gboolean skips_pager);
633 void gdk_window_set_urgency_hint (GdkWindow *window,
636 void gdk_window_set_geometry_hints (GdkWindow *window,
637 const GdkGeometry *geometry,
638 GdkWindowHints geom_mask);
640 cairo_region_t *gdk_window_get_clip_region (GdkWindow *window);
641 cairo_region_t *gdk_window_get_visible_region(GdkWindow *window);
644 void gdk_window_begin_paint_rect (GdkWindow *window,
645 const GdkRectangle *rectangle);
646 void gdk_window_begin_paint_region (GdkWindow *window,
647 const cairo_region_t *region);
648 void gdk_window_end_paint (GdkWindow *window);
649 void gdk_window_flush (GdkWindow *window);
651 void gdk_window_set_title (GdkWindow *window,
653 void gdk_window_set_role (GdkWindow *window,
655 void gdk_window_set_startup_id (GdkWindow *window,
656 const gchar *startup_id);
657 void gdk_window_set_transient_for (GdkWindow *window,
659 GDK_DEPRECATED_IN_3_4_FOR(gdk_window_set_background_rgba)
660 void gdk_window_set_background (GdkWindow *window,
661 const GdkColor *color);
662 void gdk_window_set_background_rgba (GdkWindow *window,
664 void gdk_window_set_background_pattern (GdkWindow *window,
665 cairo_pattern_t *pattern);
666 cairo_pattern_t *gdk_window_get_background_pattern (GdkWindow *window);
668 void gdk_window_set_cursor (GdkWindow *window,
670 GdkCursor *gdk_window_get_cursor (GdkWindow *window);
671 void gdk_window_set_device_cursor (GdkWindow *window,
674 GdkCursor *gdk_window_get_device_cursor (GdkWindow *window,
676 void gdk_window_get_user_data (GdkWindow *window,
678 void gdk_window_get_geometry (GdkWindow *window,
683 int gdk_window_get_width (GdkWindow *window);
684 int gdk_window_get_height (GdkWindow *window);
685 void gdk_window_get_position (GdkWindow *window,
688 gint gdk_window_get_origin (GdkWindow *window,
691 void gdk_window_get_root_coords (GdkWindow *window,
696 void gdk_window_coords_to_parent (GdkWindow *window,
701 void gdk_window_coords_from_parent (GdkWindow *window,
707 void gdk_window_get_root_origin (GdkWindow *window,
710 void gdk_window_get_frame_extents (GdkWindow *window,
713 #ifndef GDK_MULTIDEVICE_SAFE
714 GDK_DEPRECATED_IN_3_0_FOR(gdk_window_get_device_position)
715 GdkWindow * gdk_window_get_pointer (GdkWindow *window,
718 GdkModifierType *mask);
719 #endif /* GDK_MULTIDEVICE_SAFE */
720 GdkWindow * gdk_window_get_device_position (GdkWindow *window,
724 GdkModifierType *mask);
725 GdkWindow * gdk_window_get_parent (GdkWindow *window);
726 GdkWindow * gdk_window_get_toplevel (GdkWindow *window);
728 GdkWindow * gdk_window_get_effective_parent (GdkWindow *window);
729 GdkWindow * gdk_window_get_effective_toplevel (GdkWindow *window);
731 GList * gdk_window_get_children (GdkWindow *window);
732 GList * gdk_window_peek_children (GdkWindow *window);
733 GdkEventMask gdk_window_get_events (GdkWindow *window);
734 void gdk_window_set_events (GdkWindow *window,
735 GdkEventMask event_mask);
736 void gdk_window_set_device_events (GdkWindow *window,
738 GdkEventMask event_mask);
739 GdkEventMask gdk_window_get_device_events (GdkWindow *window,
742 void gdk_window_set_source_events (GdkWindow *window,
743 GdkInputSource source,
744 GdkEventMask event_mask);
745 GdkEventMask gdk_window_get_source_events (GdkWindow *window,
746 GdkInputSource source);
748 void gdk_window_set_icon_list (GdkWindow *window,
750 void gdk_window_set_icon_name (GdkWindow *window,
752 void gdk_window_set_group (GdkWindow *window,
754 GdkWindow* gdk_window_get_group (GdkWindow *window);
755 void gdk_window_set_decorations (GdkWindow *window,
756 GdkWMDecoration decorations);
757 gboolean gdk_window_get_decorations (GdkWindow *window,
758 GdkWMDecoration *decorations);
759 void gdk_window_set_functions (GdkWindow *window,
760 GdkWMFunction functions);
763 gdk_window_create_similar_surface (GdkWindow *window,
764 cairo_content_t content,
768 void gdk_window_beep (GdkWindow *window);
769 void gdk_window_iconify (GdkWindow *window);
770 void gdk_window_deiconify (GdkWindow *window);
771 void gdk_window_stick (GdkWindow *window);
772 void gdk_window_unstick (GdkWindow *window);
773 void gdk_window_maximize (GdkWindow *window);
774 void gdk_window_unmaximize (GdkWindow *window);
775 void gdk_window_fullscreen (GdkWindow *window);
776 void gdk_window_unfullscreen (GdkWindow *window);
777 void gdk_window_set_keep_above (GdkWindow *window,
779 void gdk_window_set_keep_below (GdkWindow *window,
781 void gdk_window_set_opacity (GdkWindow *window,
783 void gdk_window_register_dnd (GdkWindow *window);
786 gdk_window_get_drag_protocol(GdkWindow *window,
789 void gdk_window_begin_resize_drag (GdkWindow *window,
796 void gdk_window_begin_resize_drag_for_device (GdkWindow *window,
803 void gdk_window_begin_move_drag (GdkWindow *window,
809 void gdk_window_begin_move_drag_for_device (GdkWindow *window,
816 /* Interface for dirty-region queueing */
817 void gdk_window_invalidate_rect (GdkWindow *window,
818 const GdkRectangle *rect,
819 gboolean invalidate_children);
820 void gdk_window_invalidate_region (GdkWindow *window,
821 const cairo_region_t *region,
822 gboolean invalidate_children);
825 * GdkWindowChildFunc:
826 * @window: a #GdkWindow
827 * @user_data: user data
829 * A function of this type is passed to gdk_window_invalidate_maybe_recurse().
830 * It gets called for each child of the window to determine whether to
831 * recursively invalidate it or now.
833 * Returns: %TRUE to invalidate @window recursively
835 typedef gboolean (*GdkWindowChildFunc) (GdkWindow *window,
838 void gdk_window_invalidate_maybe_recurse (GdkWindow *window,
839 const cairo_region_t *region,
840 GdkWindowChildFunc child_func,
842 cairo_region_t *gdk_window_get_update_area (GdkWindow *window);
844 void gdk_window_freeze_updates (GdkWindow *window);
845 void gdk_window_thaw_updates (GdkWindow *window);
847 void gdk_window_freeze_toplevel_updates_libgtk_only (GdkWindow *window);
848 void gdk_window_thaw_toplevel_updates_libgtk_only (GdkWindow *window);
850 void gdk_window_process_all_updates (void);
851 void gdk_window_process_updates (GdkWindow *window,
852 gboolean update_children);
854 /* Enable/disable flicker, so you can tell if your code is inefficient. */
855 void gdk_window_set_debug_updates (gboolean setting);
857 void gdk_window_constrain_size (GdkGeometry *geometry,
864 void gdk_window_enable_synchronized_configure (GdkWindow *window);
865 void gdk_window_configure_finished (GdkWindow *window);
867 GdkWindow *gdk_get_default_root_window (void);
869 /* Offscreen redirection */
871 gdk_offscreen_window_get_surface (GdkWindow *window);
872 void gdk_offscreen_window_set_embedder (GdkWindow *window,
873 GdkWindow *embedder);
874 GdkWindow *gdk_offscreen_window_get_embedder (GdkWindow *window);
875 void gdk_window_geometry_changed (GdkWindow *window);
877 /* Multidevice support */
878 void gdk_window_set_support_multidevice (GdkWindow *window,
879 gboolean support_multidevice);
880 gboolean gdk_window_get_support_multidevice (GdkWindow *window);
884 #endif /* __GDK_WINDOW_H__ */