X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkwidget.h;h=bdf8e5e607f16bb4bd371c3e4e661b4846a7b540;hb=1865b9a1116d166c9abc5c75f5d01270574007c5;hp=f05240df8b9d7676952bd8b11cbf0d2cd57d305d;hpb=c44c026ee9ece6ef116f73f7635a0ac1e583e9a4;p=~andy%2Fgtk diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index f05240df8..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,103 +22,21 @@ * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ -#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) -#error "Only can be included directly." -#endif - #ifndef __GTK_WIDGET_H__ #define __GTK_WIDGET_H__ +#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) +#error "Only can be included directly." +#endif + #include #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_NO_REPARENT: Unused since before GTK+ 1.2, will be removed in a future version. - * @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_NO_REPARENT = 1 << 18, - GTK_APP_PAINTABLE = 1 << 19, - GTK_RECEIVES_DEFAULT = 1 << 20, - GTK_DOUBLE_BUFFERED = 1 << 21, - GTK_NO_SHOW_ALL = 1 << 22 -} GtkWidgetFlags; - /* Kinds of widget-specific help */ typedef enum { @@ -138,304 +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 various fields from GtkWidget and GtkWidgetClass. - */ -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_TYPE: - * @wid: a #GtkWidget. - * - * Gets the type of a widget. - * - * Deprecated: 2.20: Use G_OBJECT_TYPE() instead. - */ -#define GTK_WIDGET_TYPE(wid) (GTK_OBJECT_TYPE (wid)) -#endif - -/** - * GTK_WIDGET_STATE: - * @wid: a #GtkWidget. - * - * Returns the current state of the widget, as a #GtkStateType. - * - * Deprecated: 2.20: Use gtk_widget_get_state() instead. - */ -#define GTK_WIDGET_STATE(wid) (GTK_WIDGET (wid)->state) -/* FIXME: Deprecating GTK_WIDGET_STATE requires fixing GTK internals. */ - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_SAVED_STATE: - * @wid: a #GtkWidget. - * - * Returns the saved state of the widget, as a #GtkStateType. - * - * The saved state will be restored when a widget gets sensitive - * again, after it has been made insensitive with gtk_widget_set_state() - * or gtk_widget_set_sensitive(). - * - * Deprecated: 2.20: Do not used it. - */ -#define GTK_WIDGET_SAVED_STATE(wid) (GTK_WIDGET (wid)->saved_state) -#endif - - -/* Macros for extracting the widget flags from GtkWidget. - */ -/** - * GTK_WIDGET_FLAGS: - * @wid: a #GtkWidget. - * - * Returns the widget flags from @wid. - * - * Deprecated: 2.20: Do not use it. - */ -#define GTK_WIDGET_FLAGS(wid) (GTK_OBJECT_FLAGS (wid)) -/* FIXME: Deprecating GTK_WIDGET_FLAGS requires fixing GTK internals. */ - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_TOPLEVEL: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is a toplevel widget. - * - * Deprecated: 2.20: Use gtk_widget_is_toplevel() instead. - */ -#define GTK_WIDGET_TOPLEVEL(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_TOPLEVEL) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_NO_WINDOW: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget doesn't have an own #GdkWindow. - * - * Deprecated: 2.20: Use gtk_widget_get_has_window() instead. - */ -#define GTK_WIDGET_NO_WINDOW(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_NO_WINDOW) != 0) -#endif - -/** - * GTK_WIDGET_REALIZED: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is realized. - */ -#define GTK_WIDGET_REALIZED(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_REALIZED) != 0) - -/** - * GTK_WIDGET_MAPPED: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is mapped. - */ -#define GTK_WIDGET_MAPPED(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_MAPPED) != 0) - -/** - * GTK_WIDGET_VISIBLE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is visible. - */ -#define GTK_WIDGET_VISIBLE(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_VISIBLE) != 0) - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_DRAWABLE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is mapped and visible. - * - * Deprecated: 2.20: Use gtk_widget_is_drawable() instead. - */ -#define GTK_WIDGET_DRAWABLE(wid) (GTK_WIDGET_VISIBLE (wid) && GTK_WIDGET_MAPPED (wid)) -#endif - -/** - * GTK_WIDGET_SENSITIVE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget. - */ -#define GTK_WIDGET_SENSITIVE(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_SENSITIVE) != 0) - -/** - * GTK_WIDGET_PARENT_SENSITIVE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget. - */ -#define GTK_WIDGET_PARENT_SENSITIVE(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_PARENT_SENSITIVE) != 0) - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_IS_SENSITIVE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is effectively sensitive. - * - * Deprecated: 2.20: Use gtk_widget_is_sensitive() instead. - */ -#define GTK_WIDGET_IS_SENSITIVE(wid) (GTK_WIDGET_SENSITIVE (wid) && \ - GTK_WIDGET_PARENT_SENSITIVE (wid)) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_CAN_FOCUS: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is able to handle focus grabs. - * - * Deprecated: 2.20: Use gtk_widget_get_can_focus() instead. - */ -#define GTK_WIDGET_CAN_FOCUS(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_CAN_FOCUS) != 0) -#endif - -/** - * GTK_WIDGET_HAS_FOCUS: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget has grabbed the focus and no other - * widget has done so more recently. - */ -#define GTK_WIDGET_HAS_FOCUS(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_HAS_FOCUS) != 0) - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_CAN_DEFAULT: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is allowed to receive the default action - * via gtk_widget_grab_default(). - * - * Deprecated: 2.20: Use gtk_widget_get_can_default() instead. - */ -#define GTK_WIDGET_CAN_DEFAULT(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_CAN_DEFAULT) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_HAS_DEFAULT: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget currently is receiving the default action. - * - * Deprecated: 2.20: Use gtk_widget_has_default() instead. - */ -#define GTK_WIDGET_HAS_DEFAULT(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_HAS_DEFAULT) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_HAS_GRAB: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be - * the preferred one for receiving events other than ones of cosmetic value. - * - * Deprecated: 2.20: Use gtk_widget_has_grab() instead. - */ -#define GTK_WIDGET_HAS_GRAB(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_HAS_GRAB) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_RC_STYLE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget's style has been looked up through the rc - * mechanism. - * - * Deprecated: 2.20: Use gtk_widget_has_rc_style() instead. - */ -#define GTK_WIDGET_RC_STYLE(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_RC_STYLE) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_COMPOSITE_CHILD: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget is a composite child of its parent. - * - * Deprecated: 2.20: Use the #GtkWidget:composite-child property instead. - */ -#define GTK_WIDGET_COMPOSITE_CHILD(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_COMPOSITE_CHILD) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_APP_PAINTABLE: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget. - * - * Deprecated: 2.20: Use gtk_widget_get_app_paintable() instead. - */ -#define GTK_WIDGET_APP_PAINTABLE(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_APP_PAINTABLE) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_RECEIVES_DEFAULT: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the widget when focused will receive the default action - * even if there is a different widget set as default. - * - * Deprecated: 2.20: Use gtk_widget_get_receives_default() instead. - */ -#define GTK_WIDGET_RECEIVES_DEFAULT(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_RECEIVES_DEFAULT) != 0) -#endif - -#ifndef GTK_DISABLE_DEPRECATED -/** - * GTK_WIDGET_DOUBLE_BUFFERED: - * @wid: a #GtkWidget. - * - * Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget. - * - * Deprecated: 2.20: Use gtk_widget_get_double_buffered() instead. - */ -#define GTK_WIDGET_DOUBLE_BUFFERED(wid) ((GTK_WIDGET_FLAGS (wid) & GTK_DOUBLE_BUFFERED) != 0) -#endif - - -/* Macros for setting and clearing widget flags. - */ -/** - * GTK_WIDGET_SET_FLAGS: - * @wid: a #GtkWidget. - * @flag: the flags to set. - * - * Turns on certain widget flags. - */ -#define GTK_WIDGET_SET_FLAGS(wid,flag) G_STMT_START{ (GTK_WIDGET_FLAGS (wid) |= (flag)); }G_STMT_END - -/** - * GTK_WIDGET_UNSET_FLAGS: - * @wid: a #GtkWidget. - * @flag: the flags to unset. - * - * Turns off certain widget flags. - */ -#define GTK_WIDGET_UNSET_FLAGS(wid,flag) G_STMT_START{ (GTK_WIDGET_FLAGS (wid) &= ~(flag)); }G_STMT_END - #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 _GtkWidgetClass GtkWidgetClass; -typedef struct _GtkWidgetAuxInfo GtkWidgetAuxInfo; -typedef struct _GtkWidgetShapeInfo GtkWidgetShapeInfo; -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: @@ -444,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(). @@ -461,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 { @@ -482,126 +124,117 @@ struct _GtkRequisition */ struct _GtkWidget { - /* The object structure needs to be the first - * element in the widget structure in order for - * the object mechanism to work correctly. This - * allows a GtkWidget pointer to be cast to a - * GtkObject pointer. - */ - GtkObject object; - - /* 16 bits of internally used private flags. - * this will be packed into the same 4 byte alignment frame that - * state and saved_state go. we therefore don't waste any new - * space on this. - */ - guint16 GSEAL (private_flags); - - /* The state of the widget. There are actually only - * 5 widget states (defined in "gtkenums.h"). - */ - guint8 GSEAL (state); - - /* The saved state of the widget. When a widget's state - * is changed to GTK_STATE_INSENSITIVE via - * "gtk_widget_set_state" or "gtk_widget_set_sensitive" - * the old state is kept around in this field. The state - * will be restored once the widget gets sensitive again. - */ - guint8 GSEAL (saved_state); - - /* The widget's name. If the widget does not have a name - * (the name is NULL), then its name (as returned by - * "gtk_widget_get_name") is its class's name. - * Among other things, the widget name is used to determine - * the style to use for a widget. - */ - gchar *GSEAL (name); - - /*< public >*/ + GInitiallyUnowned parent_instance; - /* The style for the widget. The style contains the - * colors the widget should be drawn in for each state - * along with graphics contexts used to draw with and - * the font to use for text. - */ - GtkStyle *GSEAL (style); - - /* The widget's desired size. - */ - GtkRequisition GSEAL (requisition); - - /* The widget's allocated size. - */ - GtkAllocation GSEAL (allocation); - - /* The widget's window or its parent window if it does - * not have a window. (Which will be indicated by the - * GTK_NO_WINDOW flag being set). - */ - GdkWindow *GSEAL (window); - - /* The widget's parent. - */ - GtkWidget *GSEAL (parent); + GtkWidgetPrivate *priv; }; /** * GtkWidgetClass: - * @parent_class: - * @activate_signal: - * @set_scroll_adjustments_signal: - * - * 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_adjustment_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. + * @parent_class: The object class structure needs to be the first + * element in the widget class structure in order for the class mechanism + * to work correctly. This allows a GtkWidgetClass pointer to be cast to + * a GObjectClass pointer. + * @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. + * @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 + * #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 + * use for layout. The @for_size argument will be -1 if the request should + * not be for a particular size in the opposing orientation, i.e. if the + * request is not height-for-width or width-for-height. If @for_size is + * greater than -1, it is the proposed allocation in the opposing + * orientation that we need the request for. Implementations of + * adjust_size_request should chain up to the default implementation, + * which applies #GtkWidget's margin properties and imposes any values + * from gtk_widget_set_size_request(). Chaining up should be last, + * after your subclass adjusts the request, so + * #GtkWidget can apply constraints and add the margin properly. + * @adjust_size_allocation: Convert an initial size allocation assigned + * by a #GtkContainer using gtk_widget_size_allocate(), into an actual + * size allocation to be used by the widget. adjust_size_allocation + * adjusts to a child widget's actual allocation + * from what a parent container computed for the + * child. The adjusted allocation must be entirely within the original + * allocation. In any custom implementation, chain up to the default + * #GtkWidget implementation of this method, which applies the margin + * 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. 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 { - /* The object class structure needs to be the first - * element in the widget class structure in order for - * the class mechanism to work correctly. This allows a - * GtkWidgetClass pointer to be cast to a GtkObjectClass - * pointer. - */ - GtkObjectClass parent_class; + 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, GParamSpec **pspecs); /* basics */ + void (* destroy) (GtkWidget *widget); 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, @@ -613,17 +246,43 @@ 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); + + void (* get_preferred_height) (GtkWidget *widget, + gint *minimum_height, + gint *natural_height); + void (* get_preferred_width_for_height) (GtkWidget *widget, + gint height, + gint *minimum_width, + gint *natural_width); + void (* get_preferred_width) (GtkWidget *widget, + gint *minimum_width, + gint *natural_width); + void (* get_preferred_height_for_width) (GtkWidget *widget, + gint width, + gint *minimum_height, + 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); @@ -639,8 +298,6 @@ struct _GtkWidgetClass GdkEventAny *event); gboolean (* destroy_event) (GtkWidget *widget, GdkEventAny *event); - gboolean (* expose_event) (GtkWidget *widget, - GdkEventExpose *event); gboolean (* key_press_event) (GtkWidget *widget, GdkEventKey *event); gboolean (* key_release_event) (GtkWidget *widget, @@ -673,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, @@ -716,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); @@ -734,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); @@ -755,12 +412,35 @@ struct _GtkWidgetClass gint y, gboolean keyboard_tooltip, GtkTooltip *tooltip); - /* Signals without a C default handler class slot: - * gboolean (*damage_event) (GtkWidget *widget, - * GdkEventExpose *event); - */ + + void (* compute_expand) (GtkWidget *widget, + gboolean *hexpand_p, + gboolean *vexpand_p); + + void (* adjust_size_request) (GtkWidget *widget, + GtkOrientation orientation, + gint *minimum_size, + gint *natural_size); + void (* adjust_size_allocation) (GtkWidget *widget, + 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 >*/ + + GtkWidgetClassPrivate *priv; /* Padding for future expansion */ + void (*_gtk_reserved2) (void); + void (*_gtk_reserved3) (void); + void (*_gtk_reserved4) (void); void (*_gtk_reserved5) (void); void (*_gtk_reserved6) (void); void (*_gtk_reserved7) (void); @@ -768,22 +448,13 @@ struct _GtkWidgetClass struct _GtkWidgetAuxInfo { - gint x; - gint y; gint width; gint height; - guint x_set : 1; - guint y_set : 1; + guint halign : 4; + guint valign : 4; - GtkRequisition natural_size; -}; - -struct _GtkWidgetShapeInfo -{ - gint16 offset_x; - gint16 offset_y; - GdkBitmap *shape_mask; + GtkBorder margin; }; GType gtk_widget_get_type (void) G_GNUC_CONST; @@ -793,27 +464,21 @@ GtkWidget* gtk_widget_new (GType type, void gtk_widget_destroy (GtkWidget *widget); void gtk_widget_destroyed (GtkWidget *widget, GtkWidget **widget_pointer); -#ifndef GTK_DISABLE_DEPRECATED -GtkWidget* gtk_widget_ref (GtkWidget *widget); -void gtk_widget_unref (GtkWidget *widget); -void gtk_widget_set (GtkWidget *widget, - const gchar *first_property_name, - ...) G_GNUC_NULL_TERMINATED; -#endif /* GTK_DISABLE_DEPRECATED */ 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); void gtk_widget_realize (GtkWidget *widget); void gtk_widget_unrealize (GtkWidget *widget); +void gtk_widget_draw (GtkWidget *widget, + cairo_t *cr); /* Queuing draws */ void gtk_widget_queue_draw (GtkWidget *widget); void gtk_widget_queue_draw_area (GtkWidget *widget, @@ -821,31 +486,41 @@ void gtk_widget_queue_draw_area (GtkWidget *widget, gint y, gint width, gint height); -#ifndef GTK_DISABLE_DEPRECATED -void gtk_widget_queue_clear (GtkWidget *widget); -void gtk_widget_queue_clear_area (GtkWidget *widget, - gint x, - gint y, - gint width, - gint height); -#endif /* GTK_DISABLE_DEPRECATED */ - - +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_draw (GtkWidget *widget, - const GdkRectangle *area); -#endif /* GTK_DISABLE_DEPRECATED */ -void gtk_widget_size_request (GtkWidget *widget, - GtkRequisition *requisition); +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); -void gtk_widget_get_desired_size (GtkWidget *widget, - GtkRequisition *minimum_size, - GtkRequisition *natural_size); -void gtk_widget_get_child_requisition (GtkWidget *widget, - GtkRequisition *requisition); + +GtkSizeRequestMode gtk_widget_get_request_mode (GtkWidget *widget); +void gtk_widget_get_preferred_width (GtkWidget *widget, + gint *minimum_width, + gint *natural_width); +void gtk_widget_get_preferred_height_for_width (GtkWidget *widget, + gint width, + gint *minimum_height, + gint *natural_height); +void gtk_widget_get_preferred_height (GtkWidget *widget, + gint *minimum_height, + gint *natural_height); +void gtk_widget_get_preferred_width_for_height (GtkWidget *widget, + gint height, + gint *minimum_width, + gint *natural_width); +void gtk_widget_get_preferred_size (GtkWidget *widget, + GtkRequisition *minimum_size, + GtkRequisition *natural_size); + +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, @@ -859,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); @@ -870,19 +543,18 @@ gboolean gtk_widget_event (GtkWidget *widget, GdkEvent *event); gint gtk_widget_send_expose (GtkWidget *widget, GdkEvent *event); +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); gboolean gtk_widget_intersect (GtkWidget *widget, const GdkRectangle *area, GdkRectangle *intersection); -GdkRegion *gtk_widget_region_intersect (GtkWidget *widget, - const GdkRegion *region); +cairo_region_t *gtk_widget_region_intersect (GtkWidget *widget, + const cairo_region_t *region); void gtk_widget_freeze_child_notify (GtkWidget *widget); void gtk_widget_child_notify (GtkWidget *widget, @@ -894,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, @@ -908,14 +582,25 @@ gboolean gtk_widget_get_receives_default (GtkWidget *widget); gboolean gtk_widget_has_grab (GtkWidget *widget); +gboolean gtk_widget_device_is_shadowed (GtkWidget *widget, + GdkDevice *device); + + 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); @@ -924,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); @@ -964,6 +650,15 @@ 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); void gtk_widget_get_allocation (GtkWidget *widget, GtkAllocation *allocation); @@ -985,28 +680,34 @@ void gtk_widget_set_size_request (GtkWidget *widget, void gtk_widget_get_size_request (GtkWidget *widget, gint *width, gint *height); -#ifndef GTK_DISABLE_DEPRECATED -void gtk_widget_set_uposition (GtkWidget *widget, - gint x, - gint y); -void gtk_widget_set_usize (GtkWidget *widget, - gint width, - gint height); -#endif - void gtk_widget_set_events (GtkWidget *widget, gint events); void gtk_widget_add_events (GtkWidget *widget, gint events); -void gtk_widget_set_extension_events (GtkWidget *widget, - GdkExtensionMode mode); +void gtk_widget_set_device_events (GtkWidget *widget, + GdkDevice *device, + GdkEventMask events); +void gtk_widget_add_device_events (GtkWidget *widget, + GdkDevice *device, + GdkEventMask events); +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); -GdkColormap* gtk_widget_get_colormap (GtkWidget *widget); 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); @@ -1015,58 +716,66 @@ GdkWindow * gtk_widget_get_root_window (GtkWidget *widget); GtkSettings* gtk_widget_get_settings (GtkWidget *widget); GtkClipboard *gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection); -GdkPixmap * gtk_widget_get_snapshot (GtkWidget *widget, - GdkRectangle *clip_rect); - -#ifndef GTK_DISABLE_DEPRECATED - -/** - * gtk_widget_set_visual: - * @widget: a #GtkWidget - * @visual: a visual - * - * This function is deprecated; it does nothing. - */ -#define gtk_widget_set_visual(widget,visual) ((void) 0) - -/** - * gtk_widget_push_visual: - * @visual: a visual - * - * This function is deprecated; it does nothing. - */ -#define gtk_widget_push_visual(visual) ((void) 0) -/** - * gtk_widget_pop_visual: - * - * This function is deprecated; it does nothing. - */ -#define gtk_widget_pop_visual() ((void) 0) -/** - * gtk_widget_set_default_visual: - * @visual: a visual - * - * This function is deprecated; it does nothing. - */ -#define gtk_widget_set_default_visual(visual) ((void) 0) - -#endif /* GTK_DISABLE_DEPRECATED */ +/* 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); -/* The following functions must not be called on an already - * realized widget. Because it is possible that somebody - * can call get_colormap() or get_visual() and save the - * result, these functions are probably only safe to - * call in a widget's init() function. - */ -void gtk_widget_set_colormap (GtkWidget *widget, - GdkColormap *colormap); + +/* Margin and alignment */ +GtkAlign gtk_widget_get_halign (GtkWidget *widget); +void gtk_widget_set_halign (GtkWidget *widget, + GtkAlign align); +GtkAlign gtk_widget_get_valign (GtkWidget *widget); +void gtk_widget_set_valign (GtkWidget *widget, + GtkAlign align); +gint gtk_widget_get_margin_left (GtkWidget *widget); +void gtk_widget_set_margin_left (GtkWidget *widget, + gint margin); +gint gtk_widget_get_margin_right (GtkWidget *widget); +void gtk_widget_set_margin_right (GtkWidget *widget, + gint margin); +gint gtk_widget_get_margin_top (GtkWidget *widget); +void gtk_widget_set_margin_top (GtkWidget *widget, + gint margin); +gint gtk_widget_get_margin_bottom (GtkWidget *widget); +void gtk_widget_set_margin_bottom (GtkWidget *widget, + gint margin); + 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); @@ -1085,69 +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 *style); - -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); - -#ifndef GTK_DISABLE_DEPRECATED +/* 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); -/** - * gtk_widget_set_rc_style: - * @widget: a #GtkWidget. - * - * Equivalent to gtk_widget_set_style (widget, NULL). - * - * Deprecated: 2.0: Use gtk_widget_set_style() with a %NULL @style argument instead. - */ -#define gtk_widget_set_rc_style(widget) (gtk_widget_set_style (widget, NULL)) +void gtk_widget_override_font (GtkWidget *widget, + const PangoFontDescription *font_desc); -/** - * gtk_widget_restore_default_style: - * @widget: a #GtkWidget. - * - * Equivalent to gtk_widget_set_style (widget, NULL). - * - * Deprecated: 2.0: Use gtk_widget_set_style() with a %NULL @style argument instead. - */ -#define gtk_widget_restore_default_style(widget) (gtk_widget_set_style (widget, NULL)) -#endif +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. @@ -1156,17 +830,12 @@ 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. */ -void gtk_widget_push_colormap (GdkColormap *cmap); void gtk_widget_push_composite_child (void); void gtk_widget_pop_composite_child (void); -void gtk_widget_pop_colormap (void); /* widget style properties */ @@ -1189,18 +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. - */ -void gtk_widget_set_default_colormap (GdkColormap *colormap); -GtkStyle* gtk_widget_get_default_style (void); -#ifndef GDK_MULTIHEAD_SAFE -GdkColormap* gtk_widget_get_default_colormap (void); -GdkVisual* gtk_widget_get_default_visual (void); -#endif - -/* Functions for setting directionality for widgets - */ +/* Functions for setting directionality for widgets */ void gtk_widget_set_direction (GtkWidget *widget, GtkTextDirection dir); @@ -1212,31 +870,12 @@ GtkTextDirection gtk_widget_get_default_direction (void); /* Compositing manager functionality */ gboolean gtk_widget_is_composited (GtkWidget *widget); -/* Counterpart to gdk_window_shape_combine_mask. - */ -void gtk_widget_shape_combine_mask (GtkWidget *widget, - GdkBitmap *shape_mask, - gint offset_x, - gint offset_y); -void gtk_widget_input_shape_combine_mask (GtkWidget *widget, - GdkBitmap *shape_mask, - 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. +/* Counterpart to gdk_window_shape_combine_region. */ -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); +void gtk_widget_shape_combine_region (GtkWidget *widget, + cairo_region_t *region); +void gtk_widget_input_shape_combine_region (GtkWidget *widget, + cairo_region_t *region); GList* gtk_widget_list_mnemonic_labels (GtkWidget *widget); void gtk_widget_add_mnemonic_label (GtkWidget *widget, @@ -1258,39 +897,43 @@ void gtk_widget_set_has_tooltip (GtkWidget *widget, gboolean has_tooltip); gboolean gtk_widget_get_has_tooltip (GtkWidget *widget); +gboolean gtk_cairo_should_draw_window (cairo_t *cr, + GdkWindow *window); +void gtk_cairo_transform_to_window (cairo_t *cr, + GtkWidget *widget, + GdkWindow *window); + GType gtk_requisition_get_type (void) G_GNUC_CONST; +GtkRequisition *gtk_requisition_new (void) G_GNUC_MALLOC; GtkRequisition *gtk_requisition_copy (const GtkRequisition *requisition); void gtk_requisition_free (GtkRequisition *requisition); -#if defined (GTK_TRACE_OBJECTS) && defined (__GNUC__) -# define gtk_widget_ref g_object_ref -# define gtk_widget_unref g_object_unref -#endif /* GTK_TRACE_OBJECTS && __GNUC__ */ - -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_pointer_window (GtkWidget *widget, - GdkWindow *pointer_window); -GdkWindow *_gtk_widget_get_pointer_window (GtkWidget *widget); -gboolean _gtk_widget_is_pointer_widget (GtkWidget *widget); -void _gtk_widget_synthesize_crossing (GtkWidget *from, - GtkWidget *to, - GdkCrossingMode mode); - -GdkColormap* _gtk_widget_peek_colormap (void); - -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