X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkwidget.h;h=bdf8e5e607f16bb4bd371c3e4e661b4846a7b540;hb=0ba92bc26d1b716f2f9c0543593f13cd5a92c521;hp=c94dd6a005fb573ed01da0d0fe52a417c8b19bbb;hpb=5ac623481593875556850e2fedb625e944194759;p=~andy%2Fgtk diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index c94dd6a00..bdf8e5e60 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -12,9 +12,7 @@ * 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. + * License along with this library. If not, see . */ /* @@ -24,18 +22,17 @@ * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ +#ifndef __GTK_WIDGET_H__ +#define __GTK_WIDGET_H__ + #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif -#ifndef __GTK_WIDGET_H__ -#define __GTK_WIDGET_H__ - #include #include -#include -#include -#include +#include +#include #include G_BEGIN_DECLS @@ -59,17 +56,10 @@ typedef enum #define GTK_TYPE_REQUISITION (gtk_requisition_get_type ()) -/* forward declaration to avoid excessive includes (and concurrent includes) - */ -typedef struct _GtkRequisition GtkRequisition; -typedef struct _GtkSelectionData GtkSelectionData; -typedef struct _GtkWidgetPrivate GtkWidgetPrivate; -typedef struct _GtkWidgetClass GtkWidgetClass; -typedef struct _GtkWidgetAuxInfo GtkWidgetAuxInfo; -typedef struct _GtkClipboard GtkClipboard; -typedef struct _GtkTooltip GtkTooltip; -typedef struct _GtkWindow GtkWindow; - +typedef struct _GtkWidgetPrivate GtkWidgetPrivate; +typedef struct _GtkWidgetClass GtkWidgetClass; +typedef struct _GtkWidgetClassPrivate GtkWidgetClassPrivate; +typedef struct _GtkWidgetAuxInfo GtkWidgetAuxInfo; /** * GtkAllocation: @@ -78,16 +68,17 @@ typedef struct _GtkWindow GtkWindow; * @width: the width of the widget's allocated area. * @height: the height of the widget's allocated area. * - * A GtkAllocation of a widget represents region which has been allocated to the - * widget by its parent. It is a subregion of its parents allocation. See - * for more information. + * A GtkAllocation of a widget represents region + * which has been allocated to the widget by its parent. It is a subregion + * of its parents allocation. See for + * more information. */ typedef GdkRectangle GtkAllocation; /** * GtkCallback: * @widget: the widget to operate on - * @data: user-supplied data + * @data: (closure): user-supplied data * * The type of the callback functions used for e.g. iterating over * the children of a container, see gtk_container_foreach(). @@ -95,13 +86,30 @@ typedef GdkRectangle GtkAllocation; typedef void (*GtkCallback) (GtkWidget *widget, gpointer data); +/** + * GtkTickCallback: + * @widget: the widget + * @frame_clock: the frame clock for the widget (same as calling gtk_widget_get_frame_clock()) + * @user_data: user data passed to gtk_widget_add_tick_callback(). + * + * Callback type for adding a function to update animations. See gtk_widget_add_tick_callback(). + * + * Returns: %G_SOURCE_CONTINUE if the tick callback should continue to be called, + * %G_SOURCE_REMOVE if the tick callback should be removed. + * + * Since: 3.8 + */ +typedef gboolean (*GtkTickCallback) (GtkWidget *widget, + GdkFrameClock *frame_clock, + gpointer user_data); + /** * GtkRequisition: * @width: the widget's desired width * @height: the widget's desired height * * A GtkRequisition represents the desired size of a widget. See - * for more information. + * for more information. */ struct _GtkRequisition { @@ -130,12 +138,46 @@ struct _GtkWidget * @activate_signal: The signal to emit when a widget of this class is * activated, gtk_widget_activate() handles the emission. * Implementation of this signal is optional. - * @set_scroll_adjustments_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. + * @get_request_mode: This allows a widget to tell its parent container whether + * it prefers to be allocated in %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or + * %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT mode. + * %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH means the widget prefers to have + * #GtkWidgetClass.get_preferred_width() called and then + * #GtkWidgetClass.get_preferred_height_for_width(). + * %GTK_SIZE_REQUEST_CONSTANT_SIZE disables any height-for-width or + * width-for-height geometry management for a said widget and is the + * default return. + * It's important to note (as described below) that any widget + * which trades height-for-width or width-for-height must respond properly + * to both of the virtual methods #GtkWidgetClass.get_preferred_height_for_width() + * and #GtkWidgetClass.get_preferred_width_for_height() since it might be + * queried in either #GtkSizeRequestMode by its parent container. + * @get_preferred_height: This is called by containers to obtain the minimum + * and natural height of a widget. A widget that does not actually trade + * any height for width or width for height only has to implement these + * two virtual methods (#GtkWidgetClass.get_preferred_width() and + * #GtkWidgetClass.get_preferred_height()). + * @get_preferred_width_for_height: This is analogous to + * #GtkWidgetClass.get_preferred_height_for_width() except that it + * operates in the oposite orientation. It's rare that a widget actually + * does %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT requests but this can happen + * when, for example, a widget or container gets additional columns to + * compensate for a smaller allocated height. + * @get_preferred_width: This is called by containers to obtain the minimum + * and natural width of a widget. A widget will never be allocated a width + * less than its minimum and will only ever be allocated a width greater + * than the natural width once all of the said widget's siblings have + * received their natural widths. + * Furthermore, a widget will only ever be allocated a width greater than + * its natural width if it was configured to receive extra expand space + * from its parent container. + * @get_preferred_height_for_width: This is similar to + * #GtkWidgetClass.get_preferred_height() except that it is passed a + * contextual width to request height for. By implementing this virtual + * method it is possible for a #GtkLabel to tell its parent how much height + * would be required if the label were to be allocated a said width. * @adjust_size_request: Convert an initial size request from a widget's - * #GtkSizeRequest virtual method implementations into a size request to + * #GtkSizeRequestMode virtual method implementations into a size request to * be used by parent containers in laying out the widget. * adjust_size_request adjusts from a child widget's * original request to what a parent container should @@ -160,20 +202,19 @@ struct _GtkWidget * and alignment properties of #GtkWidget. Chain up * before performing your own adjustments so your * own adjustments remove more allocation after the #GtkWidget base - * class has already removed margin and alignment. + * class has already removed margin and alignment. The natural size + * passed in should be adjusted in the same way as the allocated size, + * which allows adjustments to perform alignments or other changes + * based on natural size. */ struct _GtkWidgetClass { GInitiallyUnownedClass parent_class; /*< public >*/ - - guint activate_signal; - guint set_scroll_adjustments_signal; + guint activate_signal; - /*< private >*/ - /* seldomly overidden */ void (*dispatch_child_properties_changed) (GtkWidget *widget, guint n_pspecs, @@ -184,17 +225,16 @@ struct _GtkWidgetClass void (* show) (GtkWidget *widget); void (* show_all) (GtkWidget *widget); void (* hide) (GtkWidget *widget); - void (* hide_all) (GtkWidget *widget); void (* map) (GtkWidget *widget); void (* unmap) (GtkWidget *widget); void (* realize) (GtkWidget *widget); void (* unrealize) (GtkWidget *widget); - void (* size_request) (GtkWidget *widget, - GtkRequisition *requisition); void (* size_allocate) (GtkWidget *widget, GtkAllocation *allocation); void (* state_changed) (GtkWidget *widget, GtkStateType previous_state); + void (* state_flags_changed) (GtkWidget *widget, + GtkStateFlags previous_state_flags); void (* parent_set) (GtkWidget *widget, GtkWidget *previous_parent); void (* hierarchy_changed) (GtkWidget *widget, @@ -206,10 +246,10 @@ struct _GtkWidgetClass void (* grab_notify) (GtkWidget *widget, gboolean was_grabbed); void (* child_notify) (GtkWidget *widget, - GParamSpec *pspec); + GParamSpec *child_property); gboolean (* draw) (GtkWidget *widget, cairo_t *cr); - + /* size requests */ GtkSizeRequestMode (* get_request_mode) (GtkWidget *widget); @@ -229,14 +269,20 @@ struct _GtkWidgetClass gint *natural_height); /* Mnemonics */ - gboolean (* mnemonic_activate) (GtkWidget *widget, - gboolean group_cycling); - + gboolean (* mnemonic_activate) (GtkWidget *widget, + gboolean group_cycling); + /* explicit focus */ - void (* grab_focus) (GtkWidget *widget); - gboolean (* focus) (GtkWidget *widget, - GtkDirectionType direction); - + void (* grab_focus) (GtkWidget *widget); + gboolean (* focus) (GtkWidget *widget, + GtkDirectionType direction); + + /* keyboard navigation */ + void (* move_focus) (GtkWidget *widget, + GtkDirectionType direction); + gboolean (* keynav_failed) (GtkWidget *widget, + GtkDirectionType direction); + /* events */ gboolean (* event) (GtkWidget *widget, GdkEvent *event); @@ -284,37 +330,37 @@ struct _GtkWidgetClass GdkEventProximity *event); gboolean (* visibility_notify_event) (GtkWidget *widget, GdkEventVisibility *event); - gboolean (* client_event) (GtkWidget *widget, - GdkEventClient *event); - gboolean (* no_expose_event) (GtkWidget *widget, - GdkEventAny *event); gboolean (* window_state_event) (GtkWidget *widget, GdkEventWindowState *event); - + gboolean (* damage_event) (GtkWidget *widget, + GdkEventExpose *event); + gboolean (* grab_broken_event) (GtkWidget *widget, + GdkEventGrabBroken *event); + /* selection */ - void (* selection_get) (GtkWidget *widget, + void (* selection_get) (GtkWidget *widget, GtkSelectionData *selection_data, guint info, guint time_); - void (* selection_received) (GtkWidget *widget, + void (* selection_received) (GtkWidget *widget, GtkSelectionData *selection_data, guint time_); /* Source side drag signals */ - void (* drag_begin) (GtkWidget *widget, + void (* drag_begin) (GtkWidget *widget, GdkDragContext *context); - void (* drag_end) (GtkWidget *widget, + void (* drag_end) (GtkWidget *widget, GdkDragContext *context); - void (* drag_data_get) (GtkWidget *widget, + void (* drag_data_get) (GtkWidget *widget, GdkDragContext *context, GtkSelectionData *selection_data, guint info, guint time_); - void (* drag_data_delete) (GtkWidget *widget, + void (* drag_data_delete) (GtkWidget *widget, GdkDragContext *context); /* Target side drag signals */ - void (* drag_leave) (GtkWidget *widget, + void (* drag_leave) (GtkWidget *widget, GdkDragContext *context, guint time_); gboolean (* drag_motion) (GtkWidget *widget, @@ -327,13 +373,16 @@ struct _GtkWidgetClass gint x, gint y, guint time_); - void (* drag_data_received) (GtkWidget *widget, + void (* drag_data_received) (GtkWidget *widget, GdkDragContext *context, gint x, gint y, GtkSelectionData *selection_data, guint info, guint time_); + gboolean (* drag_failed) (GtkWidget *widget, + GdkDragContext *context, + GtkDragResult result); /* Signals used only for keybindings */ gboolean (* popup_menu) (GtkWidget *widget); @@ -345,19 +394,16 @@ struct _GtkWidgetClass */ gboolean (* show_help) (GtkWidget *widget, GtkWidgetHelpType help_type); - - /* accessibility support + + /* accessibility support */ - AtkObject* (*get_accessible) (GtkWidget *widget); + AtkObject * (* get_accessible) (GtkWidget *widget); - void (*screen_changed) (GtkWidget *widget, - GdkScreen *previous_screen); - gboolean (*can_activate_accel) (GtkWidget *widget, - guint signal_id); + void (* screen_changed) (GtkWidget *widget, + GdkScreen *previous_screen); + gboolean (* can_activate_accel) (GtkWidget *widget, + guint signal_id); - /* Sent when a grab is broken. */ - gboolean (*grab_broken_event) (GtkWidget *widget, - GdkEventGrabBroken *event); void (* composited_changed) (GtkWidget *widget); @@ -367,32 +413,37 @@ struct _GtkWidgetClass gboolean keyboard_tooltip, GtkTooltip *tooltip); - /*< public >*/ + void (* compute_expand) (GtkWidget *widget, + gboolean *hexpand_p, + gboolean *vexpand_p); void (* adjust_size_request) (GtkWidget *widget, GtkOrientation orientation, - gint for_size, gint *minimum_size, gint *natural_size); void (* adjust_size_allocation) (GtkWidget *widget, - GtkAllocation *allocation); + GtkOrientation orientation, + gint *minimum_size, + gint *natural_size, + gint *allocated_pos, + gint *allocated_size); + + void (* style_updated) (GtkWidget *widget); + + gboolean (* touch_event) (GtkWidget *widget, + GdkEventTouch *event); /*< private >*/ - /* Signals without a C default handler class slot: - * gboolean (*damage_event) (GtkWidget *widget, - * GdkEventExpose *event); - */ + GtkWidgetClassPrivate *priv; /* Padding for future expansion */ - void (*_gtk_reserved1) (void); void (*_gtk_reserved2) (void); void (*_gtk_reserved3) (void); void (*_gtk_reserved4) (void); void (*_gtk_reserved5) (void); void (*_gtk_reserved6) (void); void (*_gtk_reserved7) (void); - void (*_gtk_reserved8) (void); }; struct _GtkWidgetAuxInfo @@ -414,13 +465,12 @@ void gtk_widget_destroy (GtkWidget *widget); void gtk_widget_destroyed (GtkWidget *widget, GtkWidget **widget_pointer); void gtk_widget_unparent (GtkWidget *widget); -void gtk_widget_show (GtkWidget *widget); +void gtk_widget_show (GtkWidget *widget); +void gtk_widget_hide (GtkWidget *widget); void gtk_widget_show_now (GtkWidget *widget); -void gtk_widget_hide (GtkWidget *widget); -void gtk_widget_show_all (GtkWidget *widget); -void gtk_widget_hide_all (GtkWidget *widget); +void gtk_widget_show_all (GtkWidget *widget); void gtk_widget_set_no_show_all (GtkWidget *widget, - gboolean no_show_all); + gboolean no_show_all); gboolean gtk_widget_get_no_show_all (GtkWidget *widget); void gtk_widget_map (GtkWidget *widget); void gtk_widget_unmap (GtkWidget *widget); @@ -436,12 +486,16 @@ void gtk_widget_queue_draw_area (GtkWidget *widget, gint y, gint width, gint height); +void gtk_widget_queue_draw_region (GtkWidget *widget, + const cairo_region_t*region); void gtk_widget_queue_resize (GtkWidget *widget); void gtk_widget_queue_resize_no_redraw (GtkWidget *widget); -#ifndef GTK_DISABLE_DEPRECATED -void gtk_widget_size_request (GtkWidget *widget, - GtkRequisition *requisition); -#endif +GDK_AVAILABLE_IN_3_8 +GdkFrameClock* gtk_widget_get_frame_clock (GtkWidget *widget); + +GDK_DEPRECATED_IN_3_0_FOR(gtk_widget_get_preferred_size) +void gtk_widget_size_request (GtkWidget *widget, + GtkRequisition *requisition); void gtk_widget_size_allocate (GtkWidget *widget, GtkAllocation *allocation); @@ -464,10 +518,9 @@ void gtk_widget_get_preferred_size (GtkWidget *w GtkRequisition *minimum_size, GtkRequisition *natural_size); -#ifndef GTK_DISABLE_DEPRECATED -void gtk_widget_get_child_requisition (GtkWidget *widget, - GtkRequisition *requisition); -#endif +GDK_DEPRECATED_IN_3_0_FOR(gtk_widget_get_preferred_size) +void gtk_widget_get_child_requisition (GtkWidget *widget, + GtkRequisition *requisition); void gtk_widget_add_accelerator (GtkWidget *widget, const gchar *accel_signal, GtkAccelGroup *accel_group, @@ -481,8 +534,6 @@ gboolean gtk_widget_remove_accelerator (GtkWidget *widget, void gtk_widget_set_accel_path (GtkWidget *widget, const gchar *accel_path, GtkAccelGroup *accel_group); -const gchar* _gtk_widget_get_accel_path (GtkWidget *widget, - gboolean *locked); GList* gtk_widget_list_accel_closures (GtkWidget *widget); gboolean gtk_widget_can_activate_accel (GtkWidget *widget, guint signal_id); @@ -496,9 +547,6 @@ gboolean gtk_widget_send_focus_change (GtkWidget *widget, GdkEvent *event); 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); @@ -518,6 +566,8 @@ void gtk_widget_set_can_focus (GtkWidget *widget, gboolean gtk_widget_get_can_focus (GtkWidget *widget); gboolean gtk_widget_has_focus (GtkWidget *widget); gboolean gtk_widget_is_focus (GtkWidget *widget); +GDK_AVAILABLE_IN_3_2 +gboolean gtk_widget_has_visible_focus (GtkWidget *widget); void gtk_widget_grab_focus (GtkWidget *widget); void gtk_widget_set_can_default (GtkWidget *widget, @@ -538,12 +588,19 @@ gboolean gtk_widget_device_is_shadowed (GtkWidget *widget, void gtk_widget_set_name (GtkWidget *widget, const gchar *name); -G_CONST_RETURN gchar* gtk_widget_get_name (GtkWidget *widget); +const gchar * gtk_widget_get_name (GtkWidget *widget); void gtk_widget_set_state (GtkWidget *widget, GtkStateType state); GtkStateType gtk_widget_get_state (GtkWidget *widget); +void gtk_widget_set_state_flags (GtkWidget *widget, + GtkStateFlags flags, + gboolean clear); +void gtk_widget_unset_state_flags (GtkWidget *widget, + GtkStateFlags flags); +GtkStateFlags gtk_widget_get_state_flags (GtkWidget *widget); + void gtk_widget_set_sensitive (GtkWidget *widget, gboolean sensitive); gboolean gtk_widget_get_sensitive (GtkWidget *widget); @@ -552,6 +609,7 @@ gboolean gtk_widget_is_sensitive (GtkWidget *widget); void gtk_widget_set_visible (GtkWidget *widget, gboolean visible); gboolean gtk_widget_get_visible (GtkWidget *widget); +gboolean gtk_widget_is_visible (GtkWidget *widget); void gtk_widget_set_has_window (GtkWidget *widget, gboolean has_window); @@ -592,6 +650,12 @@ gboolean gtk_widget_get_child_visible (GtkWidget *widget); void gtk_widget_set_window (GtkWidget *widget, GdkWindow *window); GdkWindow * gtk_widget_get_window (GtkWidget *widget); +GDK_AVAILABLE_IN_3_8 +void gtk_widget_register_window (GtkWidget *widget, + GdkWindow *window); +GDK_AVAILABLE_IN_3_8 +void gtk_widget_unregister_window (GtkWidget *widget, + GdkWindow *window); int gtk_widget_get_allocated_width (GtkWidget *widget); int gtk_widget_get_allocated_height (GtkWidget *widget); @@ -626,10 +690,18 @@ void gtk_widget_set_device_events (GtkWidget *widget, void gtk_widget_add_device_events (GtkWidget *widget, GdkDevice *device, GdkEventMask events); -void gtk_widget_set_extension_events (GtkWidget *widget, - GdkExtensionMode mode); +GDK_AVAILABLE_IN_3_8 +void gtk_widget_set_opacity (GtkWidget *widget, + double opacity); +GDK_AVAILABLE_IN_3_8 +double gtk_widget_get_opacity (GtkWidget *widget); + +void gtk_widget_set_device_enabled (GtkWidget *widget, + GdkDevice *device, + gboolean enabled); +gboolean gtk_widget_get_device_enabled (GtkWidget *widget, + GdkDevice *device); -GdkExtensionMode gtk_widget_get_extension_events (GtkWidget *widget); GtkWidget* gtk_widget_get_toplevel (GtkWidget *widget); GtkWidget* gtk_widget_get_ancestor (GtkWidget *widget, GType widget_type); @@ -645,12 +717,37 @@ GtkSettings* gtk_widget_get_settings (GtkWidget *widget); GtkClipboard *gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection); + +/* Expand flags and related support */ +gboolean gtk_widget_get_hexpand (GtkWidget *widget); +void gtk_widget_set_hexpand (GtkWidget *widget, + gboolean expand); +gboolean gtk_widget_get_hexpand_set (GtkWidget *widget); +void gtk_widget_set_hexpand_set (GtkWidget *widget, + gboolean set); +gboolean gtk_widget_get_vexpand (GtkWidget *widget); +void gtk_widget_set_vexpand (GtkWidget *widget, + gboolean expand); +gboolean gtk_widget_get_vexpand_set (GtkWidget *widget); +void gtk_widget_set_vexpand_set (GtkWidget *widget, + gboolean set); +void gtk_widget_queue_compute_expand (GtkWidget *widget); +gboolean gtk_widget_compute_expand (GtkWidget *widget, + GtkOrientation orientation); + + /* Multidevice support */ gboolean gtk_widget_get_support_multidevice (GtkWidget *widget); void gtk_widget_set_support_multidevice (GtkWidget *widget, gboolean support_multidevice); /* Accessibility support */ +GDK_AVAILABLE_IN_3_2 +void gtk_widget_class_set_accessible_type (GtkWidgetClass *widget_class, + GType type); +GDK_AVAILABLE_IN_3_2 +void gtk_widget_class_set_accessible_role (GtkWidgetClass *widget_class, + AtkRole role); AtkObject* gtk_widget_get_accessible (GtkWidget *widget); @@ -678,6 +775,7 @@ void gtk_widget_set_margin_bottom (GtkWidget *widget, gint gtk_widget_get_events (GtkWidget *widget); GdkEventMask gtk_widget_get_device_events (GtkWidget *widget, GdkDevice *device); +GDK_DEPRECATED_IN_3_4_FOR(gdk_window_get_device_position) void gtk_widget_get_pointer (GtkWidget *widget, gint *x, gint *y); @@ -696,49 +794,34 @@ gboolean gtk_widget_translate_coordinates (GtkWidget *src_widget, */ gboolean gtk_widget_hide_on_delete (GtkWidget *widget); -/* Widget styles. - */ -void gtk_widget_style_attach (GtkWidget *widget); - -gboolean gtk_widget_has_rc_style (GtkWidget *widget); -void gtk_widget_set_style (GtkWidget *widget, - GtkStyle *style); -void gtk_widget_ensure_style (GtkWidget *widget); -GtkStyle * gtk_widget_get_style (GtkWidget *widget); - -void gtk_widget_modify_style (GtkWidget *widget, - GtkRcStyle *style); -GtkRcStyle *gtk_widget_get_modifier_style (GtkWidget *widget); -void gtk_widget_modify_fg (GtkWidget *widget, - GtkStateType state, - const GdkColor *color); -void gtk_widget_modify_bg (GtkWidget *widget, - GtkStateType state, - const GdkColor *color); -void gtk_widget_modify_text (GtkWidget *widget, - GtkStateType state, - const GdkColor *color); -void gtk_widget_modify_base (GtkWidget *widget, - GtkStateType state, - const GdkColor *color); -void gtk_widget_modify_cursor (GtkWidget *widget, - const GdkColor *primary, - const GdkColor *secondary); -void gtk_widget_modify_font (GtkWidget *widget, - PangoFontDescription *font_desc); -void gtk_widget_modify_symbolic_color (GtkWidget *widget, - const gchar *name, - const GdkColor *color); +/* Functions to override widget styling */ +void gtk_widget_override_color (GtkWidget *widget, + GtkStateFlags state, + const GdkRGBA *color); +void gtk_widget_override_background_color (GtkWidget *widget, + GtkStateFlags state, + const GdkRGBA *color); + +void gtk_widget_override_font (GtkWidget *widget, + const PangoFontDescription *font_desc); + +void gtk_widget_override_symbolic_color (GtkWidget *widget, + const gchar *name, + const GdkRGBA *color); +void gtk_widget_override_cursor (GtkWidget *widget, + const GdkRGBA *cursor, + const GdkRGBA *secondary_cursor); + +void gtk_widget_reset_style (GtkWidget *widget); PangoContext *gtk_widget_create_pango_context (GtkWidget *widget); PangoContext *gtk_widget_get_pango_context (GtkWidget *widget); PangoLayout *gtk_widget_create_pango_layout (GtkWidget *widget, const gchar *text); -GdkPixbuf *gtk_widget_render_icon (GtkWidget *widget, +GdkPixbuf *gtk_widget_render_icon_pixbuf (GtkWidget *widget, const gchar *stock_id, - GtkIconSize size, - const gchar *detail); + GtkIconSize size); /* handle composite names for GTK_COMPOSITE_CHILD widgets, * the returned name is newly allocated. @@ -747,9 +830,6 @@ void gtk_widget_set_composite_name (GtkWidget *widget, const 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); - /* Push/pop pairs, to change default values upon a widget's creation. * This will override the values that got set by the * gtk_widget_set_default_* () functions. @@ -778,13 +858,7 @@ void gtk_widget_style_get (GtkWidget *widget, const gchar *first_property_name, ...) G_GNUC_NULL_TERMINATED; - -/* Set certain default values to be used at widget creation time. - */ -GtkStyle* gtk_widget_get_default_style (void); - -/* Functions for setting directionality for widgets - */ +/* Functions for setting directionality for widgets */ void gtk_widget_set_direction (GtkWidget *widget, GtkTextDirection dir); @@ -803,21 +877,6 @@ void gtk_widget_shape_combine_region (GtkWidget *widget, void gtk_widget_input_shape_combine_region (GtkWidget *widget, cairo_region_t *region); -/* internal function */ -void gtk_widget_reset_shapes (GtkWidget *widget); - -/* Compute a widget's path in the form "GtkWindow.MyLabel", and - * return newly alocated strings. - */ -void gtk_widget_path (GtkWidget *widget, - guint *path_length, - gchar **path, - gchar **path_reversed); -void gtk_widget_class_path (GtkWidget *widget, - guint *path_length, - gchar **path, - gchar **path_reversed); - GList* gtk_widget_list_mnemonic_labels (GtkWidget *widget); void gtk_widget_add_mnemonic_label (GtkWidget *widget, GtkWidget *label); @@ -849,49 +908,33 @@ GtkRequisition *gtk_requisition_new (void) G_GNUC_MALLOC; GtkRequisition *gtk_requisition_copy (const GtkRequisition *requisition); void gtk_requisition_free (GtkRequisition *requisition); -GdkEventExpose * _gtk_cairo_get_event (cairo_t *cr); - -void _gtk_widget_draw_internal (GtkWidget *widget, - cairo_t *cr, - gboolean clip_to_size); -void _gtk_widget_set_has_default (GtkWidget *widget, - gboolean has_default); -void _gtk_widget_set_has_grab (GtkWidget *widget, - gboolean has_grab); -void _gtk_widget_set_is_toplevel (GtkWidget *widget, - gboolean is_toplevel); - -void _gtk_widget_grab_notify (GtkWidget *widget, - gboolean was_grabbed); - -GtkWidgetAuxInfo *_gtk_widget_get_aux_info (GtkWidget *widget, - gboolean create); -void _gtk_widget_propagate_hierarchy_changed (GtkWidget *widget, - GtkWidget *previous_toplevel); -void _gtk_widget_propagate_screen_changed (GtkWidget *widget, - GdkScreen *previous_screen); -void _gtk_widget_propagate_composited_changed (GtkWidget *widget); - -void _gtk_widget_set_device_window (GtkWidget *widget, - GdkDevice *device, - GdkWindow *pointer_window); -GdkWindow *_gtk_widget_get_device_window (GtkWidget *widget, - GdkDevice *device); -GList * _gtk_widget_list_devices (GtkWidget *widget); - -void _gtk_widget_synthesize_crossing (GtkWidget *from, - GtkWidget *to, - GdkDevice *device, - GdkCrossingMode mode); - -gpointer _gtk_widget_peek_request_cache (GtkWidget *widget); - -void _gtk_widget_buildable_finish_accelerator (GtkWidget *widget, - GtkWidget *toplevel, - gpointer user_data); - gboolean gtk_widget_in_destruction (GtkWidget *widget); +GtkStyleContext * gtk_widget_get_style_context (GtkWidget *widget); + +GtkWidgetPath * gtk_widget_get_path (GtkWidget *widget); + +GDK_AVAILABLE_IN_3_4 +GdkModifierType gtk_widget_get_modifier_mask (GtkWidget *widget, + GdkModifierIntent intent); + +GDK_AVAILABLE_IN_3_6 +void gtk_widget_insert_action_group (GtkWidget *widget, + const gchar *name, + GActionGroup *group); + + + +GDK_AVAILABLE_IN_3_8 +guint gtk_widget_add_tick_callback (GtkWidget *widget, + GtkTickCallback callback, + gpointer user_data, + GDestroyNotify notify); + +GDK_AVAILABLE_IN_3_8 +void gtk_widget_remove_tick_callback (GtkWidget *widget, + guint id); + G_END_DECLS #endif /* __GTK_WIDGET_H__ */