+/* GDK - The GIMP Drawing Kit
+ * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
+ * file for a list of people on the GTK+ Team. See the ChangeLog
+ * files for a list of changes. These files are distributed with
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
+ */
+
+#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
+#error "Only <gdk/gdk.h> can be included directly."
+#endif
+
#ifndef __GDK_WINDOW_H__
#define __GDK_WINDOW_H__
#include <gdk/gdkdrawable.h>
#include <gdk/gdktypes.h>
-#include <gdk/gdkwindow.h>
#include <gdk/gdkevents.h>
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
+G_BEGIN_DECLS
-typedef struct _GdkGeometry GdkGeometry;
-typedef struct _GdkWindowAttr GdkWindowAttr;
+typedef struct _GdkGeometry GdkGeometry;
+typedef struct _GdkWindowAttr GdkWindowAttr;
+typedef struct _GdkPointerHooks GdkPointerHooks;
+typedef struct _GdkOffscreenChildHooks GdkOffscreenChildHooks;
+typedef struct _GdkWindowRedirect GdkWindowRedirect;
+typedef struct _GdkWindowPaint GdkWindowPaint;
/* Classes of windows.
* InputOutput: Almost every window should be of this type. Such windows
GDK_WINDOW_CHILD,
GDK_WINDOW_DIALOG,
GDK_WINDOW_TEMP,
- GDK_WINDOW_FOREIGN
+ GDK_WINDOW_FOREIGN,
+ GDK_WINDOW_OFFSCREEN
} GdkWindowType;
/* Window attribute mask values.
*/
typedef enum
{
- GDK_WA_TITLE = 1 << 1,
- GDK_WA_X = 1 << 2,
- GDK_WA_Y = 1 << 3,
- GDK_WA_CURSOR = 1 << 4,
- GDK_WA_COLORMAP = 1 << 5,
- GDK_WA_VISUAL = 1 << 6,
- GDK_WA_WMCLASS = 1 << 7,
- GDK_WA_NOREDIR = 1 << 8
+ GDK_WA_TITLE = 1 << 1,
+ GDK_WA_X = 1 << 2,
+ GDK_WA_Y = 1 << 3,
+ GDK_WA_CURSOR = 1 << 4,
+ GDK_WA_COLORMAP = 1 << 5,
+ GDK_WA_VISUAL = 1 << 6,
+ GDK_WA_WMCLASS = 1 << 7,
+ GDK_WA_NOREDIR = 1 << 8,
+ GDK_WA_TYPE_HINT = 1 << 9
} GdkWindowAttributesType;
/* Size restriction enumeration.
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_WIN_GRAVITY = 1 << 6,
+ GDK_HINT_USER_POS = 1 << 7,
+ GDK_HINT_USER_SIZE = 1 << 8
} GdkWindowHints;
+
+/* Window type hints.
+ * 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.
+ *
+ * Normal: Normal toplevel window
+ * Dialog: Dialog window
+ * Menu: Window used to implement a menu.
+ * Toolbar: Window used to implement toolbars.
+ */
+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;
+
/* The next two enumeration values current match the
* Motif constants. If this is changed, the implementation
* of gdk_window_set_decorations/gdk_window_set_functions
GDK_GRAVITY_STATIC
} GdkGravity;
+
+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;
+
struct _GdkWindowAttr
{
gchar *title;
gchar *wmclass_name;
gchar *wmclass_class;
gboolean override_redirect;
+ GdkWindowTypeHint type_hint;
};
-struct _GdkGeometry {
+struct _GdkGeometry
+{
gint min_width;
gint min_height;
gint max_width;
GdkGravity win_gravity;
};
+struct _GdkPointerHooks
+{
+ GdkWindow* (*get_pointer) (GdkWindow *window,
+ gint *x,
+ gint *y,
+ GdkModifierType *mask);
+ GdkWindow* (*window_at_pointer) (GdkScreen *screen, /* unused */
+ gint *win_x,
+ gint *win_y);
+};
+
+struct _GdkOffscreenChildHooks
+{
+ void (*from_parent) (GdkWindow *offscreen_child,
+ gdouble parent_x,
+ gdouble parent_y,
+ gdouble *child_x,
+ gdouble *child_y);
+ void (*to_parent) (GdkWindow *offscreen_child,
+ gdouble child_x,
+ gdouble child_y,
+ gdouble *parent_x,
+ gdouble *parent_y);
+};
+
typedef struct _GdkWindowObject GdkWindowObject;
typedef struct _GdkWindowObjectClass GdkWindowObjectClass;
guint8 window_type;
guint8 depth;
guint8 resize_count;
- guint mapped : 1;
+
+ GdkWindowState state;
+
guint guffaw_gravity : 1;
guint input_only : 1;
+ guint modal_hint : 1;
+ guint composited : 1;
guint destroyed : 2;
+
+ guint accept_focus : 1;
+ guint focus_on_map : 1;
+ guint shaped : 1;
+
+ GdkEventMask event_mask;
+
+ guint update_and_descendants_freeze_count;
+
+ GdkWindowRedirect *redirect;
+ const GdkOffscreenChildHooks *offscreen_hooks;
+
+ int abs_x, abs_y; /* Absolute offset in impl */
+ gint width, height;
+ guint32 clip_tag;
+ GdkRegion *clip_region; /* Clip region (wrt toplevel) in window coords */
+ GdkRegion *clip_region_with_children; /* Clip region in window coords */
+ GdkCursor *cursor;
+ gint8 toplevel_window_type;
+
+ GdkWindowPaint *implicit_paint;
+
+ GList *outstanding_moves;
+
+ GdkRegion *shape;
+ GdkRegion *input_shape;
+
+ cairo_surface_t *cairo_surface;
};
struct _GdkWindowObjectClass
{
GdkDrawableClass parent_class;
-
-
};
/* Windows
void gdk_window_show (GdkWindow *window);
void gdk_window_hide (GdkWindow *window);
void gdk_window_withdraw (GdkWindow *window);
+void gdk_window_show_unraised (GdkWindow *window);
void gdk_window_move (GdkWindow *window,
gint x,
gint y);
gint height);
void gdk_window_raise (GdkWindow *window);
void gdk_window_lower (GdkWindow *window);
+void gdk_window_focus (GdkWindow *window,
+ guint32 timestamp);
void gdk_window_set_user_data (GdkWindow *window,
gpointer user_data);
void gdk_window_set_override_redirect (GdkWindow *window,
gboolean override_redirect);
+void gdk_window_set_accept_focus (GdkWindow *window,
+ gboolean accept_focus);
+void gdk_window_set_focus_on_map (GdkWindow *window,
+ gboolean focus_on_map);
void gdk_window_add_filter (GdkWindow *window,
GdkFilterFunc function,
gpointer data);
void gdk_window_remove_filter (GdkWindow *window,
GdkFilterFunc function,
gpointer data);
-void gdk_window_scroll (GdkWindow *window,
- gint dx,
- gint dy);
+void gdk_window_scroll (GdkWindow *window,
+ gint dx,
+ gint dy);
+void gdk_window_move_region (GdkWindow *window,
+ const GdkRegion *region,
+ gint dx,
+ gint dy);
+void gdk_window_set_has_native (GdkWindow *window,
+ gboolean has_native);
/*
* This allows for making shaped (partially transparent) windows
* The shape_mask can be the mask
* from gdk_pixmap_create_from_xpm. Stefan Wille
*/
-void gdk_window_shape_combine_mask (GdkWindow *window,
- GdkBitmap *shape_mask,
- gint offset_x,
- gint offset_y);
+void gdk_window_shape_combine_mask (GdkWindow *window,
+ GdkBitmap *mask,
+ gint x,
+ gint y);
+void gdk_window_shape_combine_region (GdkWindow *window,
+ const GdkRegion *shape_region,
+ gint offset_x,
+ gint offset_y);
+
/*
* This routine allows you to quickly take the shapes of all the child windows
* of a window and use their shapes as the shape mask for this window - useful
*/
void gdk_window_set_child_shapes (GdkWindow *window);
+void gdk_window_set_composited (GdkWindow *window,
+ gboolean composited);
+
/*
* This routine allows you to merge (ie ADD) child shapes to your
* own window's shape keeping its current shape and ADDING the child
*
* - Raster
*/
-void gdk_window_merge_child_shapes (GdkWindow *window);
+void gdk_window_merge_child_shapes (GdkWindow *window);
+
+void gdk_window_input_shape_combine_mask (GdkWindow *window,
+ GdkBitmap *mask,
+ gint x,
+ gint y);
+void gdk_window_input_shape_combine_region (GdkWindow *window,
+ const GdkRegion *shape_region,
+ gint offset_x,
+ gint offset_y);
+void gdk_window_set_child_input_shapes (GdkWindow *window);
+void gdk_window_merge_child_input_shapes (GdkWindow *window);
+
/*
* Check if a window has been shown, and whether all its
gboolean gdk_window_is_visible (GdkWindow *window);
gboolean gdk_window_is_viewable (GdkWindow *window);
+GdkWindowState gdk_window_get_state (GdkWindow *window);
+
/* Set static bit gravity on the parent, and static
* window gravity on all children.
*/
gboolean gdk_window_set_static_gravities (GdkWindow *window,
gboolean use_static);
+/* Functions to create/lookup windows from their native equivalents */
+#ifndef GDK_MULTIHEAD_SAFE
+GdkWindow* gdk_window_foreign_new (GdkNativeWindow anid);
+GdkWindow* gdk_window_lookup (GdkNativeWindow anid);
+#endif
+GdkWindow *gdk_window_foreign_new_for_display (GdkDisplay *display,
+ GdkNativeWindow anid);
+GdkWindow* gdk_window_lookup_for_display (GdkDisplay *display,
+ GdkNativeWindow anid);
+
+
/* GdkWindow */
+#ifndef GDK_DISABLE_DEPRECATED
void gdk_window_set_hints (GdkWindow *window,
gint x,
gint y,
gint max_width,
gint max_height,
gint flags);
-void gdk_window_set_geometry_hints (GdkWindow *window,
- GdkGeometry *geometry,
- GdkWindowHints flags);
-void gdk_set_sm_client_id (const gchar *sm_client_id);
-
-void gdk_window_begin_paint_rect (GdkWindow *window,
- GdkRectangle *rectangle);
-void gdk_window_begin_paint_region (GdkWindow *window,
- GdkRegion *region);
-void gdk_window_end_paint (GdkWindow *window);
+#endif
+void gdk_window_set_type_hint (GdkWindow *window,
+ GdkWindowTypeHint hint);
+GdkWindowTypeHint gdk_window_get_type_hint (GdkWindow *window);
+
+void gdk_window_set_modal_hint (GdkWindow *window,
+ gboolean modal);
+
+void gdk_window_set_skip_taskbar_hint (GdkWindow *window,
+ gboolean skips_taskbar);
+void gdk_window_set_skip_pager_hint (GdkWindow *window,
+ gboolean skips_pager);
+void gdk_window_set_urgency_hint (GdkWindow *window,
+ gboolean urgent);
+
+void gdk_window_set_geometry_hints (GdkWindow *window,
+ const GdkGeometry *geometry,
+ GdkWindowHints geom_mask);
+void gdk_set_sm_client_id (const gchar *sm_client_id);
+
+void gdk_window_begin_paint_rect (GdkWindow *window,
+ const GdkRectangle *rectangle);
+void gdk_window_begin_paint_region (GdkWindow *window,
+ const GdkRegion *region);
+void gdk_window_end_paint (GdkWindow *window);
void gdk_window_set_title (GdkWindow *window,
const gchar *title);
void gdk_window_set_role (GdkWindow *window,
const gchar *role);
+void gdk_window_set_startup_id (GdkWindow *window,
+ const gchar *startup_id);
void gdk_window_set_transient_for (GdkWindow *window,
- GdkWindow *leader);
+ GdkWindow *parent);
void gdk_window_set_background (GdkWindow *window,
- GdkColor *color);
+ const GdkColor *color);
void gdk_window_set_back_pixmap (GdkWindow *window,
GdkPixmap *pixmap,
gboolean parent_relative);
gint gdk_window_get_origin (GdkWindow *window,
gint *x,
gint *y);
+
+#if !defined (GDK_DISABLE_DEPRECATED) || defined (GTK_COMPILATION)
+/* Used by gtk_handle_box_button_changed () */
gboolean gdk_window_get_deskrelative_origin (GdkWindow *window,
gint *x,
gint *y);
+#endif
+
void gdk_window_get_root_origin (GdkWindow *window,
gint *x,
gint *y);
+void gdk_window_get_frame_extents (GdkWindow *window,
+ GdkRectangle *rect);
GdkWindow* gdk_window_get_pointer (GdkWindow *window,
gint *x,
gint *y,
void gdk_window_set_events (GdkWindow *window,
GdkEventMask event_mask);
+void gdk_window_set_icon_list (GdkWindow *window,
+ GList *pixbufs);
void gdk_window_set_icon (GdkWindow *window,
GdkWindow *icon_window,
GdkPixmap *pixmap,
const gchar *name);
void gdk_window_set_group (GdkWindow *window,
GdkWindow *leader);
+GdkWindow* gdk_window_get_group (GdkWindow *window);
void gdk_window_set_decorations (GdkWindow *window,
GdkWMDecoration decorations);
gboolean gdk_window_get_decorations (GdkWindow *window,
GdkWMDecoration *decorations);
void gdk_window_set_functions (GdkWindow *window,
GdkWMFunction functions);
+#if !defined(GDK_MULTIHEAD_SAFE) && !defined(GDK_DISABLE_DEPRECATED)
GList * gdk_window_get_toplevels (void);
-void gdk_window_iconify (GdkWindow *window);
+#endif
+void gdk_window_beep (GdkWindow *window);
+void gdk_window_iconify (GdkWindow *window);
+void gdk_window_deiconify (GdkWindow *window);
+void gdk_window_stick (GdkWindow *window);
+void gdk_window_unstick (GdkWindow *window);
+void gdk_window_maximize (GdkWindow *window);
+void gdk_window_unmaximize (GdkWindow *window);
+void gdk_window_fullscreen (GdkWindow *window);
+void gdk_window_unfullscreen (GdkWindow *window);
+void gdk_window_set_keep_above (GdkWindow *window,
+ gboolean setting);
+void gdk_window_set_keep_below (GdkWindow *window,
+ gboolean setting);
+void gdk_window_set_opacity (GdkWindow *window,
+ gdouble opacity);
void gdk_window_register_dnd (GdkWindow *window);
+void gdk_window_begin_resize_drag (GdkWindow *window,
+ GdkWindowEdge edge,
+ gint button,
+ gint root_x,
+ gint root_y,
+ guint32 timestamp);
+void gdk_window_begin_move_drag (GdkWindow *window,
+ gint button,
+ gint root_x,
+ gint root_y,
+ guint32 timestamp);
+
/* Interface for dirty-region queueing */
-void gdk_window_invalidate_rect (GdkWindow *window,
- GdkRectangle *rect,
- gboolean invalidate_children);
-void gdk_window_invalidate_region (GdkWindow *window,
- GdkRegion *region,
- gboolean invalidate_children);
+void gdk_window_invalidate_rect (GdkWindow *window,
+ const GdkRectangle *rect,
+ gboolean invalidate_children);
+void gdk_window_invalidate_region (GdkWindow *window,
+ const GdkRegion *region,
+ gboolean invalidate_children);
+void gdk_window_invalidate_maybe_recurse (GdkWindow *window,
+ const GdkRegion *region,
+ gboolean (*child_func) (GdkWindow *, gpointer),
+ gpointer user_data);
GdkRegion *gdk_window_get_update_area (GdkWindow *window);
void gdk_window_freeze_updates (GdkWindow *window);
void gdk_window_thaw_updates (GdkWindow *window);
+void gdk_window_freeze_toplevel_updates_libgtk_only (GdkWindow *window);
+void gdk_window_thaw_toplevel_updates_libgtk_only (GdkWindow *window);
+
void gdk_window_process_all_updates (void);
void gdk_window_process_updates (GdkWindow *window,
gboolean update_children);
-
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
+/* Enable/disable flicker, so you can tell if your code is inefficient. */
+void gdk_window_set_debug_updates (gboolean setting);
+
+void gdk_window_constrain_size (GdkGeometry *geometry,
+ guint flags,
+ gint width,
+ gint height,
+ gint *new_width,
+ gint *new_height);
+
+void gdk_window_get_internal_paint_info (GdkWindow *window,
+ GdkDrawable **real_drawable,
+ gint *x_offset,
+ gint *y_offset);
+
+void gdk_window_enable_synchronized_configure (GdkWindow *window);
+void gdk_window_configure_finished (GdkWindow *window);
+
+#ifndef GDK_MULTIHEAD_SAFE
+GdkPointerHooks *gdk_set_pointer_hooks (const GdkPointerHooks *new_hooks);
+#endif /* GDK_MULTIHEAD_SAFE */
+
+GdkWindow *gdk_get_default_root_window (void);
+
+/* Offscreen redirection */
+GdkPixmap *gdk_window_get_offscreen_pixmap (GdkWindow *window);
+
+void gdk_window_redirect_to_drawable (GdkWindow *window,
+ GdkDrawable *drawable,
+ gint src_x,
+ gint src_y,
+ gint dest_x,
+ gint dest_y,
+ gint width,
+ gint height);
+void gdk_window_remove_redirection (GdkWindow *window);
+
+void gdk_window_set_offscreen_hooks (GdkWindow *offscreen_window,
+ const GdkOffscreenChildHooks *hooks);
+
+#ifndef GDK_DISABLE_DEPRECATED
+#define GDK_ROOT_PARENT() (gdk_get_default_root_window ())
+#define gdk_window_get_size gdk_drawable_get_size
+#define gdk_window_get_type gdk_window_get_window_type
+#define gdk_window_get_colormap gdk_drawable_get_colormap
+#define gdk_window_set_colormap gdk_drawable_set_colormap
+#define gdk_window_get_visual gdk_drawable_get_visual
+#define gdk_window_ref gdk_drawable_ref
+#define gdk_window_unref gdk_drawable_unref
+
+#define gdk_window_copy_area(drawable,gc,x,y,source_drawable,source_x,source_y,width,height) \
+ gdk_draw_pixmap(drawable,gc,source_drawable,source_x,source_y,x,y,width,height)
+#endif /* GDK_DISABLE_DEPRECATED */
+
+G_END_DECLS
#endif /* __GDK_WINDOW_H__ */
projects / ~andy / gtk / blobdiff