X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkwidget.h;h=bdf8e5e607f16bb4bd371c3e4e661b4846a7b540;hb=fd51c8f5e9d6fb68c8e81b9b1e2ab80931f963f0;hp=af72dea7250e2fad3eb44ff037b4e8020c3bc842;hpb=f53ad339941a6cab1468eef279bd518992ae68bc;p=~andy%2Fgtk
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index af72dea72..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,101 +22,21 @@
* 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
-/**
- * GtkWidgetFlags:
- * @GTK_TOPLEVEL: widgets without a real parent, as there are #GtkWindows and
- * #GtkMenus have this flag set throughout their lifetime.
- * Toplevel widgets always contain their own #GdkWindow.
- * @GTK_NO_WINDOW: Indicative for a widget that does not provide its own #GdkWindow.
- * Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
- * @GTK_REALIZED: Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
- * A realized widget has an associated #GdkWindow.
- * @GTK_MAPPED: Set by gtk_widget_map(), unset by gtk_widget_unmap().
- * Only realized widgets can be mapped. It means that gdk_window_show()
- * has been called on the widgets window(s).
- * @GTK_VISIBLE: Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
- * widget will be mapped as soon as its parent is mapped.
- * @GTK_SENSITIVE: Set and unset by gtk_widget_set_sensitive().
- * The sensitivity of a widget determines whether it will receive
- * certain events (e.g. button or key presses). One premise for
- * the widget's sensitivity is to have this flag set.
- * @GTK_PARENT_SENSITIVE: Set and unset by gtk_widget_set_sensitive() operations on the
- * parents of the widget.
- * This is the second premise for the widget's sensitivity. Once
- * it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
- * effectively sensitive. This is expressed (and can be examined) by
- * the #GTK_WIDGET_IS_SENSITIVE macro.
- * @GTK_CAN_FOCUS: Determines whether a widget is able to handle focus grabs.
- * @GTK_HAS_FOCUS: Set by gtk_widget_grab_focus() for widgets that also
- * have %GTK_CAN_FOCUS set. The flag will be unset once another widget
- * grabs the focus.
- * @GTK_CAN_DEFAULT: The widget is allowed to receive the default action via
- * gtk_widget_grab_default() and will reserve space to draw the default if possible
- * @GTK_HAS_DEFAULT: The widget currently is receiving the default action and
- * should be drawn appropriately if possible
- * @GTK_HAS_GRAB: Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
- * widget is in the grab_widgets stack, and will be the preferred one for
- * receiving events other than ones of cosmetic value.
- * @GTK_RC_STYLE: Indicates that the widget's style has been looked up through the rc
- * mechanism. It does not imply that the widget actually had a style
- * defined through the rc mechanism.
- * @GTK_COMPOSITE_CHILD: Indicates that the widget is a composite child of its parent; see
- * gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
- * @GTK_APP_PAINTABLE: Set and unset by gtk_widget_set_app_paintable().
- * Must be set on widgets whose window the application directly draws on,
- * in order to keep GTK+ from overwriting the drawn stuff. See
- * for a detailed
- * description of this flag.
- * @GTK_RECEIVES_DEFAULT: The widget when focused will receive the default action and have
- * %GTK_HAS_DEFAULT set even if there is a different widget set as default.
- * @GTK_DOUBLE_BUFFERED: Set and unset by gtk_widget_set_double_buffered().
- * Indicates that exposes done on the widget should be
- * double-buffered. See for a
- * detailed discussion of how double-buffering works in GTK+ and
- * why you may want to disable it for special cases.
- * @GTK_NO_SHOW_ALL:
- *
- * Tells about certain properties of the widget.
- */
-typedef enum
-{
- GTK_TOPLEVEL = 1 << 4,
- GTK_NO_WINDOW = 1 << 5,
- GTK_REALIZED = 1 << 6,
- GTK_MAPPED = 1 << 7,
- GTK_VISIBLE = 1 << 8,
- GTK_SENSITIVE = 1 << 9,
- GTK_PARENT_SENSITIVE = 1 << 10,
- GTK_CAN_FOCUS = 1 << 11,
- GTK_HAS_FOCUS = 1 << 12,
- GTK_CAN_DEFAULT = 1 << 13,
- GTK_HAS_DEFAULT = 1 << 14,
- GTK_HAS_GRAB = 1 << 15,
- GTK_RC_STYLE = 1 << 16,
- GTK_COMPOSITE_CHILD = 1 << 17,
- GTK_APP_PAINTABLE = 1 << 18,
- GTK_RECEIVES_DEFAULT = 1 << 19,
- GTK_DOUBLE_BUFFERED = 1 << 20,
- GTK_NO_SHOW_ALL = 1 << 21,
- GTK_MULTIDEVICE = 1 << 22
-} GtkWidgetFlags;
-
/* Kinds of widget-specific help */
typedef enum
{
@@ -136,72 +54,12 @@ typedef enum
#define GTK_IS_WIDGET_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_WIDGET))
#define GTK_WIDGET_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_WIDGET, GtkWidgetClass))
-/* Macros for extracting the widget flags from GtkWidget.
- */
-/**
- * GTK_WIDGET_FLAGS:
- * @wid: a #GtkWidget.
- *
- * Returns the widget flags from @wid.
- *
- * Deprecated: 2.20: Use the proper function to test individual states:
- * gtk_widget_get_app_paintable(), gtk_widget_get_can_default(),
- * gtk_widget_get_can_focus(), gtk_widget_get_double_buffered(),
- * gtk_widget_has_default(), gtk_widget_is_drawable(),
- * gtk_widget_has_focus(), gtk_widget_has_grab(), gtk_widget_get_mapped(),
- * gtk_widget_get_has_window(), gtk_widget_has_rc_style(),
- * gtk_widget_get_realized(), gtk_widget_get_receives_default(),
- * gtk_widget_get_sensitive(), gtk_widget_is_sensitive(),
- * gtk_widget_is_toplevel() or gtk_widget_get_visible().
- */
-#define GTK_WIDGET_FLAGS(wid) (GTK_OBJECT_FLAGS (wid))
-/* FIXME: Deprecating GTK_WIDGET_FLAGS requires fixing GTK internals. */
-
-/* Macros for setting and clearing widget flags.
- */
-/**
- * GTK_WIDGET_SET_FLAGS:
- * @wid: a #GtkWidget.
- * @flag: the flags to set.
- *
- * Turns on certain widget flags.
- *
- * Deprecated: 2.22: Use the proper function instead: gtk_widget_set_app_paintable(),
- * gtk_widget_set_can_default(), gtk_widget_set_can_focus(),
- * gtk_widget_set_double_buffered(), gtk_widget_set_has_window(),
- * gtk_widget_set_mapped(), gtk_widget_set_no_show_all(),
- * gtk_widget_set_realized(), gtk_widget_set_receives_default(),
- * gtk_widget_set_sensitive() or gtk_widget_set_visible().
- *
- */
-#define GTK_WIDGET_SET_FLAGS(wid,flag) G_STMT_START{ (GTK_WIDGET_FLAGS (wid) |= (flag)); }G_STMT_END
-/* FIXME: Deprecating GTK_WIDGET_SET_FLAGS requires fixing GTK internals. */
-
-/**
- * GTK_WIDGET_UNSET_FLAGS:
- * @wid: a #GtkWidget.
- * @flag: the flags to unset.
- *
- * Turns off certain widget flags.
- *
- * Deprecated: 2.22: Use the proper function instead. See GTK_WIDGET_SET_FLAGS().
- */
-#define GTK_WIDGET_UNSET_FLAGS(wid,flag) G_STMT_START{ (GTK_WIDGET_FLAGS (wid) &= ~(flag)); }G_STMT_END
-/* FIXME: Deprecating GTK_WIDGET_UNSET_FLAGS requires fixing GTK internals. */
-
#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:
@@ -210,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().
@@ -227,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
{
@@ -262,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
@@ -292,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,
@@ -316,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,
@@ -338,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);
@@ -361,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);
@@ -416,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,
@@ -459,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);
@@ -477,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);
@@ -499,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
@@ -546,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);
@@ -568,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);
@@ -596,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,
@@ -613,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);
@@ -628,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);
@@ -650,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,
@@ -670,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);
@@ -684,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);
@@ -724,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);
@@ -758,14 +690,24 @@ 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);
GdkVisual* gtk_widget_get_visual (GtkWidget *widget);
+void gtk_widget_set_visual (GtkWidget *widget,
+ GdkVisual *visual);
GdkScreen * gtk_widget_get_screen (GtkWidget *widget);
gboolean gtk_widget_has_screen (GtkWidget *widget);
@@ -775,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);
@@ -808,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);
@@ -826,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.
@@ -877,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.
@@ -908,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);
@@ -933,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);
@@ -979,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__ */