/* GTK - The GIMP Toolkit * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 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, see . */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #pragma once #include "gtkwidget.h" #include "gtkactionmuxerprivate.h" #include "gtkatcontextprivate.h" #include "gtkborder.h" #include "gtkcsstypesprivate.h" #include "gtkeventcontrollerprivate.h" #include "gtklistlistmodelprivate.h" #include "gtkrootprivate.h" #include "gtksizerequestcacheprivate.h" #include "gtkwindowprivate.h" #include "gtkgesture.h" #include "gsk/gskrendernodeprivate.h" G_BEGIN_DECLS typedef gboolean (*GtkSurfaceTransformChangedCallback) (GtkWidget *widget, const graphene_matrix_t *surface_transform, gpointer user_data); #define GTK_STATE_FLAGS_BITS 15 typedef struct _GtkWidgetSurfaceTransformData { GtkWidget *tracked_parent; guint parent_surface_transform_changed_id; gboolean cached_surface_transform_valid; graphene_matrix_t cached_surface_transform; GList *callbacks; } GtkWidgetSurfaceTransformData; struct _GtkWidgetPrivate { /* The state of the widget. Needs to be able to hold all GtkStateFlags bits * (defined in "gtkenums.h"). */ guint state_flags : GTK_STATE_FLAGS_BITS; guint direction : 2; guint in_destruction : 1; guint realized : 1; guint mapped : 1; guint visible : 1; guint sensitive : 1; guint can_focus : 1; guint focusable : 1; guint has_focus : 1; guint focus_on_click : 1; guint has_default : 1; guint receives_default : 1; guint has_grab : 1; guint child_visible : 1; guint can_target : 1; /* Queue-resize related flags */ guint resize_needed : 1; /* queue_resize() has been called but no get_preferred_size() yet */ guint alloc_needed : 1; /* this widget needs a size_allocate() call */ guint alloc_needed_on_child : 1; /* 0 or more children - or this widget - need a size_allocate() call */ /* Queue-draw related flags */ guint draw_needed : 1; /* Expand-related flags */ guint need_compute_expand : 1; /* Need to recompute computed_[hv]_expand */ guint computed_hexpand : 1; /* computed results (composite of child flags) */ guint computed_vexpand : 1; guint hexpand : 1; /* application-forced expand */ guint vexpand : 1; guint hexpand_set : 1; /* whether to use application-forced */ guint vexpand_set : 1; /* instead of computing from children */ guint has_tooltip : 1; /* SizeGroup related flags */ guint have_size_groups : 1; /* Alignment */ guint halign : 4; guint valign : 4; guint user_alpha : 8; GtkOverflow overflow; #ifdef G_ENABLE_CONSISTENCY_CHECKS /* Number of gtk_widget_push_verify_invariants () */ guint8 verifying_invariants_count; #endif int width_request; int height_request; /* Animations and other things to update on clock ticks */ guint clock_tick_id; guint8 n_active; GList *tick_callbacks; void (* resize_func) (GtkWidget *); GtkBorder margin; /* Surface relative transform updates callbacks */ GtkWidgetSurfaceTransformData *surface_transform_data; /* 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. */ char *name; /* The root this widget belongs to or %NULL if widget is not * rooted or is a GtkRoot itself. */ GtkRoot *root; /* 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. */ GtkCssNode *cssnode; GtkStyleContext *context; /* The widget's allocated size */ GskTransform *allocated_transform; int allocated_width; int allocated_height; int allocated_baseline; int width; int height; int baseline; GskTransform *transform; /* The widget's requested sizes */ SizeRequestCache requests; /* The render node we draw or %NULL if not yet created.*/ GskRenderNode *render_node; /* The layout manager, or %NULL */ GtkLayoutManager *layout_manager; GSList *paintables; GList *event_controllers; /* Widget tree */ GtkWidget *parent; GtkWidget *prev_sibling; GtkWidget *next_sibling; GtkWidget *first_child; GtkWidget *last_child; /* only created on-demand */ GtkListListModel *children_observer; GtkListListModel *controller_observer; GtkActionMuxer *muxer; GtkWidget *focus_child; /* Pointer cursor */ GdkCursor *cursor; /* Tooltip */ char *tooltip_markup; char *tooltip_text; /* Accessibility */ GtkATContext *at_context; GtkAccessibleRole accessible_role; }; typedef struct { GBytes *data; GSList *children; GtkBuilderScope *scope; } GtkWidgetTemplate; struct _GtkWidgetClassPrivate { GtkWidgetTemplate *template; GListStore *shortcuts; GType layout_manager_type; GtkWidgetAction *actions; GtkAccessibleRole accessible_role; guint activate_signal; GQuark css_name; }; void gtk_widget_root (GtkWidget *widget); void gtk_widget_unroot (GtkWidget *widget); GtkCssNode * gtk_widget_get_css_node (GtkWidget *widget); void _gtk_widget_set_visible_flag (GtkWidget *widget, gboolean visible); gboolean _gtk_widget_get_alloc_needed (GtkWidget *widget); gboolean gtk_widget_needs_allocate (GtkWidget *widget); void gtk_widget_ensure_resize (GtkWidget *widget); void gtk_widget_ensure_allocate (GtkWidget *widget); void _gtk_widget_scale_changed (GtkWidget *widget); GdkSurface * gtk_widget_get_surface (GtkWidget *widget); void gtk_widget_render (GtkWidget *widget, GdkSurface *surface, const cairo_region_t *region); void _gtk_widget_add_sizegroup (GtkWidget *widget, gpointer group); void _gtk_widget_remove_sizegroup (GtkWidget *widget, gpointer group); GSList *_gtk_widget_get_sizegroups (GtkWidget *widget); void _gtk_widget_set_has_default (GtkWidget *widget, gboolean has_default); void _gtk_widget_set_has_grab (GtkWidget *widget, gboolean has_grab); gboolean gtk_widget_has_grab (GtkWidget *widget); void _gtk_widget_propagate_display_changed (GtkWidget *widget, GdkDisplay *previous_display); void _gtk_widget_set_device_surface (GtkWidget *widget, GdkDevice *device, GdkSurface *pointer_window); void _gtk_widget_synthesize_crossing (GtkWidget *from, GtkWidget *to, GdkDevice *device, GdkCrossingMode mode); GtkStyleContext * _gtk_widget_peek_style_context (GtkWidget *widget); gboolean _gtk_widget_captured_event (GtkWidget *widget, GdkEvent *event, GtkWidget *target); void gtk_widget_css_changed (GtkWidget *widget, GtkCssStyleChange *change); void gtk_widget_system_setting_changed (GtkWidget *widget, GtkSystemSetting setting); void gtk_system_setting_changed (GdkDisplay *display, GtkSystemSetting setting); void _gtk_widget_update_parent_muxer (GtkWidget *widget); GtkActionMuxer * _gtk_widget_get_action_muxer (GtkWidget *widget, gboolean create); gboolean gtk_widget_has_tick_callback (GtkWidget *widget); gboolean gtk_widget_has_size_request (GtkWidget *widget); void gtk_widget_reset_controllers (GtkWidget *widget); GtkEventController **gtk_widget_list_controllers (GtkWidget *widget, GtkPropagationPhase phase, guint *out_n_controllers); gboolean gtk_widget_query_tooltip (GtkWidget *widget, int x, int y, gboolean keyboard_mode, GtkTooltip *tooltip); void gtk_widget_snapshot (GtkWidget *widget, GtkSnapshot *snapshot); void gtk_widget_adjust_size_request (GtkWidget *widget, GtkOrientation orientation, int *minimum_size, int *natural_size); void gtk_widget_adjust_baseline_request (GtkWidget *widget, int *minimum_baseline, int *natural_baseline); typedef void (*GtkCallback) (GtkWidget *widget, gpointer data); void gtk_widget_forall (GtkWidget *widget, GtkCallback callback, gpointer user_data); void gtk_widget_focus_sort (GtkWidget *widget, GtkDirectionType direction, GPtrArray *focus_order); gboolean gtk_widget_focus_move (GtkWidget *widget, GtkDirectionType direction); void gtk_widget_set_has_focus (GtkWidget *widget, gboolean has_focus); GtkWidget * gtk_widget_common_ancestor (GtkWidget *widget_a, GtkWidget *widget_b); void gtk_widget_set_active_state (GtkWidget *widget, gboolean active); void gtk_widget_cancel_event_sequence (GtkWidget *widget, GtkGesture *gesture, GdkEventSequence *sequence, GtkEventSequenceState state); gboolean gtk_widget_event (GtkWidget *widget, GdkEvent *event, GtkWidget *target); gboolean gtk_widget_run_controllers (GtkWidget *widget, GdkEvent *event, GtkWidget *target, double x, double y, GtkPropagationPhase phase); void gtk_widget_handle_crossing (GtkWidget *widget, const GtkCrossingData *crossing, double x, double y); guint gtk_widget_add_surface_transform_changed_callback (GtkWidget *widget, GtkSurfaceTransformChangedCallback callback, gpointer user_data, GDestroyNotify notify); void gtk_widget_remove_surface_transform_changed_callback (GtkWidget *widget, guint id); gboolean gtk_widget_can_activate (GtkWidget *widget); /* focus vfuncs for non-focusable containers with focusable children */ gboolean gtk_widget_grab_focus_child (GtkWidget *widget); gboolean gtk_widget_focus_child (GtkWidget *widget, GtkDirectionType direction); /* focus vfuncs for focusable widgets with children that don't receive focus */ gboolean gtk_widget_grab_focus_self (GtkWidget *widget); gboolean gtk_widget_focus_self (GtkWidget *widget, GtkDirectionType direction); void gtk_widget_update_orientation (GtkWidget *widget, GtkOrientation orientation); void gtk_widget_realize_at_context (GtkWidget *widget); void gtk_widget_unrealize_at_context (GtkWidget *widget); gboolean gtk_widget_update_pango_context (GtkWidget *widget, PangoContext *context, GtkTextDirection direction); /* inline getters */ static inline GtkWidget * _gtk_widget_get_parent (GtkWidget *widget) { return widget->priv->parent; } static inline GtkWidget * _gtk_widget_get_focus_child (GtkWidget *widget) { return widget->priv->focus_child; } static inline gboolean _gtk_widget_get_visible (GtkWidget *widget) { return widget->priv->visible; } static inline gboolean _gtk_widget_get_child_visible (GtkWidget *widget) { return widget->priv->child_visible; } static inline gboolean _gtk_widget_get_mapped (GtkWidget *widget) { return widget->priv->mapped; } static inline gboolean _gtk_widget_get_realized (GtkWidget *widget) { return widget->priv->realized; } static inline GtkStateFlags _gtk_widget_get_state_flags (GtkWidget *widget) { return widget->priv->state_flags; } extern GtkTextDirection gtk_default_direction; static inline GtkTextDirection _gtk_widget_get_direction (GtkWidget *widget) { if (widget->priv->direction == GTK_TEXT_DIR_NONE) return gtk_default_direction; else return widget->priv->direction; } static inline GtkRoot * _gtk_widget_get_root (GtkWidget *widget) { return widget->priv->root; } static inline GdkDisplay * _gtk_widget_get_display (GtkWidget *widget) { GtkRoot *root = _gtk_widget_get_root (widget); if (root == NULL) return gdk_display_get_default (); return gtk_root_get_display (root); } static inline gpointer _gtk_widget_peek_request_cache (GtkWidget *widget) { return &widget->priv->requests; } static inline GtkWidget * _gtk_widget_get_prev_sibling (GtkWidget *widget) { return widget->priv->prev_sibling; } static inline GtkWidget * _gtk_widget_get_next_sibling (GtkWidget *widget) { return widget->priv->next_sibling; } static inline GtkWidget * _gtk_widget_get_first_child (GtkWidget *widget) { return widget->priv->first_child; } static inline GtkWidget * _gtk_widget_get_last_child (GtkWidget *widget) { return widget->priv->last_child; } static inline gboolean _gtk_widget_is_sensitive (GtkWidget *widget) { return !(widget->priv->state_flags & GTK_STATE_FLAG_INSENSITIVE); } G_END_DECLS