]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkwidget.h
set RECEIVES_DEFAULT on init, and a button press on the widget doesn't
[~andy/gtk] / gtk / gtkwidget.h
index 505b701759d9f9a327602e6eb28ea7f8322d5b4e..f41442cb46319438ef89f4d4b4f96e12563895f2 100644 (file)
 #ifndef __GTK_WIDGET_H__
 #define __GTK_WIDGET_H__
 
-
 #include <gdk/gdk.h>
 #include <gtk/gtkaccelgroup.h>
 #include <gtk/gtkobject.h>
+#include <gtk/gtkadjustment.h>
 #include <gtk/gtkstyle.h>
 
 
@@ -50,7 +50,9 @@ typedef enum
   GTK_HAS_GRAB        = 1 << 15,
   GTK_RC_STYLE        = 1 << 16,
   GTK_COMPOSITE_CHILD  = 1 << 17,
-  GTK_BASIC           = 1 << 18
+  GTK_NO_REPARENT      = 1 << 18,
+  GTK_APP_PAINTABLE    = 1 << 19,
+  GTK_RECEIVES_DEFAULT = 1 << 20
 } GtkWidgetFlags;
 
 /* Macro for casting a pointer to a GtkWidget or GtkWidgetClass pointer.
@@ -76,11 +78,11 @@ typedef enum
 #define GTK_WIDGET_REALIZED(wid)         ((GTK_WIDGET_FLAGS (wid) & GTK_REALIZED) != 0)
 #define GTK_WIDGET_MAPPED(wid)           ((GTK_WIDGET_FLAGS (wid) & GTK_MAPPED) != 0)
 #define GTK_WIDGET_VISIBLE(wid)                  ((GTK_WIDGET_FLAGS (wid) & GTK_VISIBLE) != 0)
-#define GTK_WIDGET_DRAWABLE(wid)         ((GTK_WIDGET_VISIBLE (wid) && GTK_WIDGET_MAPPED (wid)) != 0)
+#define GTK_WIDGET_DRAWABLE(wid)         (GTK_WIDGET_VISIBLE (wid) && GTK_WIDGET_MAPPED (wid))
 #define GTK_WIDGET_SENSITIVE(wid)        ((GTK_WIDGET_FLAGS (wid) & GTK_SENSITIVE) != 0)
 #define GTK_WIDGET_PARENT_SENSITIVE(wid)  ((GTK_WIDGET_FLAGS (wid) & GTK_PARENT_SENSITIVE) != 0)
-#define GTK_WIDGET_IS_SENSITIVE(wid)     (((GTK_WIDGET_SENSITIVE (wid) && \
-                                           GTK_WIDGET_PARENT_SENSITIVE (wid)) != 0) != 0)
+#define GTK_WIDGET_IS_SENSITIVE(wid)     (GTK_WIDGET_SENSITIVE (wid) && \
+                                          GTK_WIDGET_PARENT_SENSITIVE (wid))
 #define GTK_WIDGET_CAN_FOCUS(wid)        ((GTK_WIDGET_FLAGS (wid) & GTK_CAN_FOCUS) != 0)
 #define GTK_WIDGET_HAS_FOCUS(wid)        ((GTK_WIDGET_FLAGS (wid) & GTK_HAS_FOCUS) != 0)
 #define GTK_WIDGET_CAN_DEFAULT(wid)      ((GTK_WIDGET_FLAGS (wid) & GTK_CAN_DEFAULT) != 0)
@@ -88,7 +90,8 @@ typedef enum
 #define GTK_WIDGET_HAS_GRAB(wid)         ((GTK_WIDGET_FLAGS (wid) & GTK_HAS_GRAB) != 0)
 #define GTK_WIDGET_RC_STYLE(wid)         ((GTK_WIDGET_FLAGS (wid) & GTK_RC_STYLE) != 0)
 #define GTK_WIDGET_COMPOSITE_CHILD(wid)          ((GTK_WIDGET_FLAGS (wid) & GTK_COMPOSITE_CHILD) != 0)
-#define GTK_WIDGET_BASIC(wid)            ((GTK_WIDGET_FLAGS (wid) & GTK_BASIC) != 0)
+#define GTK_WIDGET_APP_PAINTABLE(wid)    ((GTK_WIDGET_FLAGS (wid) & GTK_APP_PAINTABLE) != 0)
+#define GTK_WIDGET_RECEIVES_DEFAULT(wid)  ((GTK_WIDGET_FLAGS (wid) & GTK_RECEIVES_DEFAULT) != 0)
   
 /* Macros for setting and clearing widget flags.
  */
@@ -100,7 +103,6 @@ typedef enum
 typedef struct _GtkRequisition   GtkRequisition;
 typedef struct _GtkAllocation    GtkAllocation;
 typedef struct _GtkSelectionData GtkSelectionData;
-typedef struct _GtkWidget        GtkWidget;
 typedef struct _GtkWidgetClass   GtkWidgetClass;
 typedef struct _GtkWidgetAuxInfo  GtkWidgetAuxInfo;
 typedef struct _GtkWidgetShapeInfo GtkWidgetShapeInfo;
@@ -113,8 +115,8 @@ typedef void (*GtkCallback) (GtkWidget *widget,
  */
 struct _GtkRequisition
 {
-  guint16 width;
-  guint16 height;
+  gint16 width;
+  gint16 height;
 };
 
 /* An allocation is a size and position. Where a widget
@@ -227,11 +229,18 @@ struct _GtkWidgetClass
    */
   GtkObjectClass parent_class;
   
-  /* The signal to emit when an object of this class is activated.
-   *  This is used when activating the current focus widget and
-   *  the default widget.
+  /* The signal to emit when a widget of this class is activated,
+   * gtk_widget_activate() handles the emission.
+   * Implementation of this signal is optional.
    */
   guint activate_signal;
+
+  /* This signal is emitted  when a widget of this class is added
+   * to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
+   * handles the emission.
+   * Implementation of this signal is optional.
+   */
+  guint set_scroll_adjustments_signal;
   
   /* basics */
   void (* show)                       (GtkWidget      *widget);
@@ -268,6 +277,9 @@ struct _GtkWidgetClass
                                GtkAccelGroup  *accel_group,
                                guint           accel_key,
                                GdkModifierType accel_mods);
+
+  /* explicit focus */
+  void (* grab_focus)          (GtkWidget      *widget);
   
   /* events */
   gint (* event)                  (GtkWidget          *widget,
@@ -359,6 +371,8 @@ struct _GtkWidgetClass
                                    guint               time);
   void (* drag_data_received)      (GtkWidget          *widget,
                                    GdkDragContext     *context,
+                                   gint                x,
+                                   gint                y,
                                    GtkSelectionData   *selection_data,
                                    guint               info,
                                    guint32             time);
@@ -417,13 +431,27 @@ void         gtk_widget_map                 (GtkWidget           *widget);
 void      gtk_widget_unmap               (GtkWidget           *widget);
 void      gtk_widget_realize             (GtkWidget           *widget);
 void      gtk_widget_unrealize           (GtkWidget           *widget);
+
+/* Queuing draws */
 void      gtk_widget_queue_draw          (GtkWidget           *widget);
+void      gtk_widget_queue_draw_area     (GtkWidget           *widget,
+                                          gint                 x,
+                                          gint                 y,
+                                          gint                 width,
+                                          gint                 height);
+void      gtk_widget_queue_clear         (GtkWidget           *widget);
+void      gtk_widget_queue_clear_area    (GtkWidget           *widget,
+                                          gint                 x,
+                                          gint                 y,
+                                          gint                 width,
+                                          gint                 height);
+
+
 void      gtk_widget_queue_resize        (GtkWidget           *widget);
 void      gtk_widget_draw                (GtkWidget           *widget,
                                           GdkRectangle        *area);
 void      gtk_widget_draw_focus          (GtkWidget           *widget);
 void      gtk_widget_draw_default        (GtkWidget           *widget);
-void      gtk_widget_draw_children       (GtkWidget           *widget);
 void      gtk_widget_size_request        (GtkWidget           *widget,
                                           GtkRequisition      *requisition);
 void      gtk_widget_size_allocate       (GtkWidget           *widget,
@@ -445,12 +473,16 @@ guint        gtk_widget_accelerator_signal  (GtkWidget           *widget,
                                           GtkAccelGroup       *accel_group,
                                           guint                accel_key,
                                           guint                accel_mods);
-void      gtk_widget_freeze_accelerators (GtkWidget           *widget);
-void      gtk_widget_thaw_accelerators   (GtkWidget           *widget);
+void      gtk_widget_lock_accelerators   (GtkWidget           *widget);
+void      gtk_widget_unlock_accelerators (GtkWidget           *widget);
 gint      gtk_widget_event               (GtkWidget           *widget,
                                           GdkEvent            *event);
 
-void      gtk_widget_activate            (GtkWidget           *widget);
+gboolean   gtk_widget_activate              (GtkWidget        *widget);
+gboolean   gtk_widget_set_scroll_adjustments (GtkWidget        *widget,
+                                             GtkAdjustment    *hadjustment,
+                                             GtkAdjustment    *vadjustment);
+     
 void      gtk_widget_reparent            (GtkWidget           *widget,
                                           GtkWidget           *new_parent);
 void      gtk_widget_popup               (GtkWidget           *widget,
@@ -459,7 +491,6 @@ void           gtk_widget_popup               (GtkWidget           *widget,
 gint      gtk_widget_intersect           (GtkWidget           *widget,
                                           GdkRectangle        *area,
                                           GdkRectangle        *intersection);
-gint      gtk_widget_basic               (GtkWidget           *widget);
 
 void      gtk_widget_grab_focus          (GtkWidget           *widget);
 void      gtk_widget_grab_default        (GtkWidget           *widget);
@@ -470,7 +501,9 @@ gchar*         gtk_widget_get_name            (GtkWidget           *widget);
 void      gtk_widget_set_state           (GtkWidget           *widget,
                                           GtkStateType         state);
 void      gtk_widget_set_sensitive       (GtkWidget           *widget,
-                                          gint                 sensitive);
+                                          gboolean             sensitive);
+void      gtk_widget_set_app_paintable   (GtkWidget           *widget,
+                                          gboolean             app_paintable);
 void      gtk_widget_set_parent          (GtkWidget           *widget,
                                           GtkWidget           *parent);
 void      gtk_widget_set_parent_window   (GtkWidget           *widget,
@@ -502,8 +535,6 @@ void             gtk_widget_get_pointer     (GtkWidget      *widget,
 
 gint        gtk_widget_is_ancestor     (GtkWidget      *widget,
                                         GtkWidget      *ancestor);
-gint        gtk_widget_is_child        (GtkWidget      *widget,
-                                        GtkWidget      *child);
 
 /* Hide widget and return TRUE.
  */
@@ -518,6 +549,16 @@ void          gtk_widget_ensure_style      (GtkWidget      *widget);
 GtkStyle*  gtk_widget_get_style                (GtkWidget      *widget);
 void      gtk_widget_restore_default_style (GtkWidget  *widget);
 
+void       gtk_widget_modify_style      (GtkWidget      *widget,
+                                        GtkRcStyle     *style);
+
+/* handle composite names for GTK_COMPOSITE_CHILD widgets,
+ * the returned name is newly allocated.
+ */
+void   gtk_widget_set_composite_name   (GtkWidget      *widget,
+                                        gchar          *name);
+gchar* gtk_widget_get_composite_name   (GtkWidget      *widget);
+     
 /* Descend recursively and set rc-style on all widgets without user styles */
 void       gtk_widget_reset_rc_styles   (GtkWidget      *widget);
 
@@ -525,14 +566,14 @@ void       gtk_widget_reset_rc_styles   (GtkWidget      *widget);
  * This will override the values that got set by the
  * gtk_widget_set_default_* () functions.
  */
-void        gtk_widget_push_style          (GtkStyle    *style);
-void        gtk_widget_push_colormap       (GdkColormap *cmap);
-void        gtk_widget_push_visual         (GdkVisual   *visual);
-void        gtk_widget_push_composite_flag (void);
-void        gtk_widget_pop_composite_flag  (void);
-void        gtk_widget_pop_style           (void);
-void        gtk_widget_pop_colormap        (void);
-void        gtk_widget_pop_visual          (void);
+void        gtk_widget_push_style           (GtkStyle   *style);
+void        gtk_widget_push_colormap        (GdkColormap *cmap);
+void        gtk_widget_push_visual          (GdkVisual  *visual);
+void        gtk_widget_push_composite_child (void);
+void        gtk_widget_pop_composite_child  (void);
+void        gtk_widget_pop_style            (void);
+void        gtk_widget_pop_colormap         (void);
+void        gtk_widget_pop_visual           (void);
 
 /* Set certain default values to be used at widget creation time.
  */
@@ -550,6 +591,9 @@ void             gtk_widget_shape_combine_mask (GtkWidget *widget,
                                            gint       offset_x,
                                            gint       offset_y);
 
+/* internal function */
+void        gtk_widget_reset_shapes       (GtkWidget *widget);
+
 /* Compute a widget's path in the form "GtkWindow.MyLabel", and
  * return newly alocated strings.
  */
@@ -568,6 +612,7 @@ void             gtk_widget_class_path         (GtkWidget *widget,
 #endif /* GTK_TRACE_OBJECTS && __GNUC__ */
 
 
+
 #ifdef __cplusplus
 }
 #endif /* __cplusplus */