]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkwindow.h
Remove explicit pointer grabs, since they are no longer necessary.
[~andy/gtk] / gtk / gtkwindow.h
index 7f0b616d39d6bf100e14c96c8b5446db493df4ea..5264ccd47682a855fbc5f7782727bc50ad340753 100644 (file)
@@ -2,20 +2,28 @@
  * 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 Library General Public
+ * 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
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
+ * 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 __GTK_WINDOW_H__
 #define __GTK_WINDOW_H__
 
@@ -32,14 +40,16 @@ extern "C" {
 
 
 #define GTK_TYPE_WINDOW                        (gtk_window_get_type ())
-#define GTK_WINDOW(obj)                        (GTK_CHECK_CAST (obj, GTK_TYPE_WINDOW, GtkWindow))
-#define GTK_WINDOW_CLASS(klass)                (GTK_CHECK_CLASS_CAST (klass, GTK_TYPE_WINDOW, GtkWindowClass))
-#define GTK_IS_WINDOW(obj)             (GTK_CHECK_TYPE (obj, GTK_TYPE_WINDOW))
-#define GTK_IS_WINDOW_CLASS(klass)     (GTK_CHECK_CLASS_TYPE (klass, GTK_TYPE_WINDOW))
+#define GTK_WINDOW(obj)                        (GTK_CHECK_CAST ((obj), GTK_TYPE_WINDOW, GtkWindow))
+#define GTK_WINDOW_CLASS(klass)                (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_WINDOW, GtkWindowClass))
+#define GTK_IS_WINDOW(obj)             (GTK_CHECK_TYPE ((obj), GTK_TYPE_WINDOW))
+#define GTK_IS_WINDOW_CLASS(klass)     (GTK_CHECK_CLASS_TYPE ((klass), GTK_TYPE_WINDOW))
+#define GTK_WINDOW_GET_CLASS(obj)       (GTK_CHECK_GET_CLASS ((obj), GTK_TYPE_WINDOW, GtkWindowClass))
 
 
-typedef struct _GtkWindow       GtkWindow;
-typedef struct _GtkWindowClass  GtkWindowClass;
+typedef struct _GtkWindow             GtkWindow;
+typedef struct _GtkWindowClass        GtkWindowClass;
+typedef struct _GtkWindowGeometryInfo GtkWindowGeometryInfo;
 
 struct _GtkWindow
 {
@@ -48,60 +58,186 @@ struct _GtkWindow
   gchar *title;
   gchar *wmclass_name;
   gchar *wmclass_class;
-  GtkWindowType type;
+  gchar *wm_role;
 
   GtkWidget *focus_widget;
   GtkWidget *default_widget;
+  GtkWindow *transient_parent;
+  GtkWindowGeometryInfo *geometry_info;
+  GdkWindow *frame;
 
-  gushort resize_count;
+  guint16 resize_count;
+
+  GtkWindowType type : 4;
+  guint has_user_ref_count : 1;
   guint allow_shrink : 1;
   guint allow_grow : 1;
   guint auto_shrink : 1;
   guint handling_resize : 1;
   guint position : 2;
+
+  /* The following flag is initially TRUE when a window is mapped.
+   * and will be set to FALSE after it is first positioned.
+   * It is also temporarily reset when the window's size changes.
+   * 
+   * When TRUE, we move the window to the position the app set.
+   */
   guint use_uposition : 1;
   guint modal : 1;
+  guint destroy_with_parent : 1;
+  
+  guint has_frame : 1;
+
+  /* gtk_window_iconify() called before realization */
+  guint iconify_initially : 1;
+  guint stick_initially : 1;
+  guint maximize_initially : 1;
+  guint decorated : 1;
+  
+  GdkWindowTypeHint type_hint : 3;
+  GdkGravity gravity : 5;
+  
+  guint frame_left;
+  guint frame_top;
+  guint frame_right;
+  guint frame_bottom;
+  
+  GdkModifierType mnemonic_modifier;
 };
 
 struct _GtkWindowClass
 {
   GtkBinClass parent_class;
 
-  void (* set_focus)   (GtkWindow *window,
-                       GtkWidget *focus);
+  void     (* set_focus)   (GtkWindow *window,
+                           GtkWidget *focus);
+  gboolean (* frame_event) (GtkWidget *widget,
+                           GdkEvent  *event);
 };
 
 
-GtkType    gtk_window_get_type                 (void);
+GtkType    gtk_window_get_type                 (void) G_GNUC_CONST;
 GtkWidget* gtk_window_new                      (GtkWindowType        type);
 void       gtk_window_set_title                (GtkWindow           *window,
                                                const gchar         *title);
 void       gtk_window_set_wmclass              (GtkWindow           *window,
                                                const gchar         *wmclass_name,
                                                const gchar         *wmclass_class);
-void       gtk_window_set_focus                (GtkWindow           *window,
-                                               GtkWidget           *focus);
-void       gtk_window_set_default              (GtkWindow           *window,
-                                               GtkWidget           *defaultw);
-void       gtk_window_set_policy               (GtkWindow           *window,
-                                               gint                 allow_shrink,
-                                               gint                 allow_grow,
-                                               gint                 auto_shrink);
+void       gtk_window_set_role                 (GtkWindow           *window,
+                                                const gchar         *role);
 void       gtk_window_add_accel_group          (GtkWindow           *window,
                                                GtkAccelGroup       *accel_group);
 void       gtk_window_remove_accel_group       (GtkWindow           *window,
                                                GtkAccelGroup       *accel_group);
-void       gtk_window_position                 (GtkWindow           *window,
+void       gtk_window_set_position             (GtkWindow           *window,
                                                GtkWindowPosition    position);
-gint      gtk_window_activate_focus           (GtkWindow           *window);
-gint      gtk_window_activate_default         (GtkWindow           *window);
+gboolean   gtk_window_activate_focus          (GtkWindow           *window);
+gboolean   gtk_window_activate_default        (GtkWindow           *window);
+
+void       gtk_window_set_transient_for        (GtkWindow           *window, 
+                                               GtkWindow           *parent);
+void       gtk_window_set_type_hint            (GtkWindow           *window, 
+                                               GdkWindowTypeHint    hint);
+void       gtk_window_set_destroy_with_parent  (GtkWindow           *window,
+                                                gboolean             setting);
+void       gtk_window_set_decorations_hint     (GtkWindow          *window,
+                                                GdkWMDecoration      decorations);
+void       gtk_window_set_functions_hint       (GtkWindow          *window,
+                                                GdkWMFunction       functions);
+
+void       gtk_window_set_resizeable           (GtkWindow           *window,
+                                                gboolean             resizeable);
+gboolean   gtk_window_get_resizeable           (GtkWindow           *window);
+
+void       gtk_window_set_gravity              (GtkWindow           *window,
+                                                GdkGravity           gravity);
+GdkGravity gtk_window_get_gravity              (GtkWindow           *window);
+
+
+void       gtk_window_set_geometry_hints       (GtkWindow           *window,
+                                               GtkWidget           *geometry_widget,
+                                               GdkGeometry         *geometry,
+                                               GdkWindowHints       geom_mask);
+
+/* gtk_window_set_has_frame () must be called before realizing the window_*/
+void       gtk_window_set_has_frame            (GtkWindow *window);
+void       gtk_window_set_frame_dimensions     (GtkWindow *window, 
+                                               gint       left,
+                                               gint       top,
+                                               gint       right,
+                                               gint       bottom);
+
+void       gtk_window_set_decorated           (GtkWindow *window,
+                                               gboolean   setting);
 
 /* If window is set modal, input will be grabbed when show and released when hide */
 void       gtk_window_set_modal                (GtkWindow           *window,
-                                                gboolean modal);
+                                                gboolean             modal);
+GList*    gtk_window_list_toplevels           (void);
+
+void     gtk_window_add_mnemonic          (GtkWindow       *window,
+                                          guint            keyval,
+                                          GtkWidget       *target);
+void     gtk_window_remove_mnemonic       (GtkWindow       *window,
+                                          guint            keyval,
+                                          GtkWidget       *target);
+gboolean gtk_window_mnemonic_activate     (GtkWindow       *window,
+                                          guint            keyval,
+                                          GdkModifierType  modifier);
+void     gtk_window_set_mnemonic_modifier (GtkWindow       *window,
+                                          GdkModifierType  modifier);
+
+void     gtk_window_present       (GtkWindow *window);
+void     gtk_window_iconify       (GtkWindow *window);
+void     gtk_window_deiconify     (GtkWindow *window);
+void     gtk_window_stick         (GtkWindow *window);
+void     gtk_window_unstick       (GtkWindow *window);
+void     gtk_window_maximize      (GtkWindow *window);
+void     gtk_window_unmaximize    (GtkWindow *window);
+
+void gtk_window_begin_resize_drag (GtkWindow     *window,
+                                   GdkWindowEdge  edge,
+                                   gint           button,
+                                   gint           root_x,
+                                   gint           root_y,
+                                   guint32        timestamp);
+void gtk_window_begin_move_drag   (GtkWindow     *window,
+                                   gint           button,
+                                   gint           root_x,
+                                   gint           root_y,
+                                   guint32        timestamp);
+
+#ifndef GTK_DISABLE_DEPRECATED
+void       gtk_window_set_policy               (GtkWindow           *window,
+                                               gint                 allow_shrink,
+                                               gint                 allow_grow,
+                                               gint                 auto_shrink);
+/* The following differs from gtk_widget_set_usize, in that
+ * gtk_widget_set_usize() overrides the requisition, so sets a minimum
+ * size, while this only sets the size requested from the WM.
+ */
+void       gtk_window_set_default_size         (GtkWindow           *window,
+                                               gint                 width,
+                                               gint                 height);
+#endif
 
-void gtk_window_remove_embedded_xid (GtkWindow *window, guint xid);
-void gtk_window_add_embedded_xid    (GtkWindow *window, guint xid);
+/* --- internal functions --- */
+void       gtk_window_set_focus                (GtkWindow           *window,
+                                               GtkWidget           *focus);
+void       gtk_window_set_default              (GtkWindow           *window,
+                                               GtkWidget           *defaultw);
+void       gtk_window_remove_embedded_xid      (GtkWindow           *window,
+                                               guint                xid);
+void       gtk_window_add_embedded_xid         (GtkWindow           *window,
+                                               guint                xid);
+void       _gtk_window_reposition              (GtkWindow           *window,
+                                               gint                 x,
+                                               gint                 y);
+void       _gtk_window_constrain_size          (GtkWindow           *window,
+                                               gint                 width,
+                                               gint                 height,
+                                               gint                *new_width,
+                                               gint                *new_height);
 
 #ifdef __cplusplus
 }