]> Pileus Git - ~andy/gtk/blobdiff - gdk/gdkwindow.h
guard for windows with GDK_WINDOW_DESTROYED set. (Fixes #482531, reported
[~andy/gtk] / gdk / gdkwindow.h
index 13d1aac25312d16a9e92f7ee4da95aba7fa88f44..3e169c43981858fde560df4e22508ae15305e8ad 100644 (file)
@@ -1,17 +1,41 @@
+/* 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/. 
+ */
+
 #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 _GdkPointerHooks              GdkPointerHooks;
 
 /* Classes of windows.
  *   InputOutput: Almost every window should be of this type. Such windows
@@ -61,14 +85,15 @@ typedef enum
  */
 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.
@@ -81,9 +106,42 @@ typedef enum
   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
@@ -128,6 +186,19 @@ typedef enum
   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;
@@ -143,9 +214,11 @@ struct _GdkWindowAttr
   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;
@@ -159,6 +232,17 @@ struct _GdkGeometry {
   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);
+};
+
 typedef struct _GdkWindowObject GdkWindowObject;
 typedef struct _GdkWindowObjectClass GdkWindowObjectClass;
 
@@ -204,15 +288,23 @@ struct _GdkWindowObject
   
   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;
 };
 
 struct _GdkWindowObjectClass
 {
   GdkDrawableClass parent_class;
-
-
 };
 
 /* Windows
@@ -228,6 +320,7 @@ GdkWindow*    gdk_window_at_pointer            (gint          *win_x,
 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);
@@ -262,6 +355,10 @@ 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);
@@ -271,6 +368,10 @@ void          gdk_window_remove_filter         (GdkWindow     *window,
 void          gdk_window_scroll                (GdkWindow *window,
                                                 gint       dx,
                                                 gint       dy);
+void         gdk_window_move_region           (GdkWindow *window,
+                                               GdkRegion *region,
+                                               gint       dx,
+                                               gint       dy);
 
 /* 
  * This allows for making shaped (partially transparent) windows
@@ -279,9 +380,9 @@ void          gdk_window_scroll                (GdkWindow *window,
  *  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);
+                                     GdkBitmap     *mask,
+                                     gint           x,
+                                     gint           y);
 void gdk_window_shape_combine_region (GdkWindow            *window,
                                       GdkRegion     *shape_region,
                                       gint          offset_x,
@@ -296,6 +397,9 @@ void gdk_window_shape_combine_region (GdkWindow         *window,
  */
 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
@@ -305,6 +409,18 @@ void gdk_window_set_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,
+                                            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
  * parents up to a toplevel have been shown, respectively.
@@ -322,8 +438,20 @@ GdkWindowState gdk_window_get_state (GdkWindow *window);
 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,
@@ -332,9 +460,24 @@ void             gdk_window_set_hints       (GdkWindow       *window,
                                          gint             max_width,
                                          gint             max_height,
                                          gint             flags);
+#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,
                                             GdkGeometry      *geometry,
-                                            GdkWindowHints    flags);
+                                            GdkWindowHints    geom_mask);
 void          gdk_set_sm_client_id         (const gchar *sm_client_id);
 
 void         gdk_window_begin_paint_rect   (GdkWindow    *window,
@@ -347,10 +490,12 @@ 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);
@@ -370,12 +515,19 @@ void            gdk_window_get_position    (GdkWindow       *window,
 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,
@@ -389,6 +541,8 @@ GdkEventMask  gdk_window_get_events  (GdkWindow       *window);
 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,
@@ -397,35 +551,65 @@ void            gdk_window_set_icon_name   (GdkWindow       *window,
                                          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);
+#ifndef GDK_MULTIHEAD_SAFE
 GList *       gdk_window_get_toplevels   (void);
+#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,
+                                                GdkRectangle *rect,
+                                                gboolean      invalidate_children);
+void       gdk_window_invalidate_region         (GdkWindow    *window,
+                                                GdkRegion    *region,
+                                                gboolean      invalidate_children);
+void       gdk_window_invalidate_maybe_recurse  (GdkWindow *window,
+                                                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);
@@ -433,8 +617,41 @@ void       gdk_window_process_updates     (GdkWindow    *window,
 /* Enable/disable flicker, so you can tell if your code is inefficient. */
 void       gdk_window_set_debug_updates   (gboolean      setting);
 
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
+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);
+
+#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__ */