/* 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/. */ #include "config.h" #include "gtkwindowprivate.h" #include "gtkaccelgroupprivate.h" #include "gtkapplicationprivate.h" #include "gtkbindings.h" #include "gtkbox.h" #include "gtkbuildable.h" #include "gtkbuilderprivate.h" #include "gtkbutton.h" #include "gtkcheckbutton.h" #include "gtkcheckmenuitem.h" #include "gtkcontainerprivate.h" #include "gtkcsscornervalueprivate.h" #include "gtkcssiconthemevalueprivate.h" #include "gtkcssrgbavalueprivate.h" #include "gtkcssshadowsvalueprivate.h" #include "gtkcssstylepropertyprivate.h" #include "gtkdragdest.h" #include "gtkeventcontrollerkey.h" #include "gtkeventcontrollermotion.h" #include "gtkgesturedrag.h" #include "gtkgestureclick.h" #include "gtkgestureprivate.h" #include "gtkheaderbarprivate.h" #include "gtkicontheme.h" #include "gtkintl.h" #include "gtkkeyhash.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkmessagedialog.h" #include "gtkmnemonichash.h" #include "gtkmenu.h" #include "gtkmenubarprivate.h" #include "gtkmenushellprivate.h" #include "gtkpointerfocusprivate.h" #include "gtkpopoverprivate.h" #include "gtkprivate.h" #include "gtkroot.h" #include "gtknative.h" #include "gtkseparatormenuitem.h" #include "gtksettings.h" #include "gtksnapshot.h" #include "gtkstylecontextprivate.h" #include "gtktypebuiltins.h" #include "gtkwidgetprivate.h" #include "gtkwindowgroup.h" #include "a11y/gtkwindowaccessibleprivate.h" #include "a11y/gtkcontaineraccessibleprivate.h" #include "inspector/init.h" #include "inspector/window.h" #include "gdk/gdktextureprivate.h" #include "gdk/gdk-private.h" #include #include #include #include #include #include #ifdef GDK_WINDOWING_X11 #include "x11/gdkx.h" #endif #ifdef GDK_WINDOWING_WIN32 #include "win32/gdkwin32.h" #endif #ifdef GDK_WINDOWING_WAYLAND #include "wayland/gdkwayland.h" #endif #ifdef GDK_WINDOWING_BROADWAY #include "broadway/gdkbroadway.h" #endif #ifdef GDK_WINDOWING_MIR #include "mir/gdkmir.h" #endif /** * SECTION:gtkwindow * @title: GtkWindow * @short_description: Toplevel which can contain other widgets * * A GtkWindow is a toplevel window which can contain other widgets. * Windows normally have decorations that are under the control * of the windowing system and allow the user to manipulate the window * (resize it, move it, close it,...). * * # GtkWindow as GtkBuildable * * The GtkWindow implementation of the #GtkBuildable interface supports a * custom element, which supports any number of * elements representing the #GtkAccelGroup objects you want to add to * your window (synonymous with gtk_window_add_accel_group(). * * An example of a UI definition fragment with accel groups: * |[ * * * * * * * ... * * * ]| * * The GtkWindow implementation of the #GtkBuildable interface supports * setting a child as the titlebar by specifying “titlebar” as the “type” * attribute of a element. * * # CSS nodes * * |[ * window.background * ├── decoration * ├── .titlebar [.default-decoration] * ╰── * ]| * * GtkWindow has a main CSS node with name window and style class .background, * and a subnode with name decoration. * * Style classes that are typically used with the main CSS node are .csd (when * client-side decorations are in use), .solid-csd (for client-side decorations * without invisible borders), .ssd (used by mutter when rendering server-side * decorations). GtkWindow also represents window states with the following * style classes on the main node: .tiled, .maximized, .fullscreen. Specialized * types of window often add their own discriminating style classes, such as * .popup or .tooltip. * * GtkWindow adds the .titlebar and .default-decoration style classes to the * widget that is added as a titlebar child. */ #define MENU_BAR_ACCEL "F10" #define RESIZE_HANDLE_SIZE 20 #define MNEMONICS_DELAY 300 /* ms */ #define NO_CONTENT_CHILD_NAT 200 /* In case the content (excluding header bar and shadows) of the window * would be empty, either because there is no visible child widget or only an * empty container widget, we use NO_CONTENT_CHILD_NAT as natural width/height * instead. */ typedef struct _GtkWindowPopover GtkWindowPopover; struct _GtkWindowPopover { GtkWidget *widget; GtkWidget *parent; GtkPositionType pos; cairo_rectangle_int_t rect; guint clamp_allocation : 1; }; typedef struct { GtkMnemonicHash *mnemonic_hash; GtkWidget *attach_widget; GtkWidget *default_widget; GtkWidget *initial_focus; GtkWidget *focus_widget; GtkWindow *transient_parent; GtkWindowGeometryInfo *geometry_info; GtkWindowGroup *group; GdkDisplay *display; GtkApplication *application; GQueue popovers; GdkModifierType mnemonic_modifier; gchar *startup_id; gchar *title; guint keys_changed_handler; guint32 initial_timestamp; guint16 configure_request_count; guint mnemonics_display_timeout_id; gint scale; gint title_height; GtkWidget *title_box; GtkWidget *titlebar; GtkWidget *popup_menu; GdkMonitor *initial_fullscreen_monitor; guint edge_constraints; GdkSurfaceState state; /* The following flags are initially TRUE (before a window is mapped). * They cause us to compute a configure request that involves * default-only parameters. Once mapped, we set them to FALSE. * Then we set them to TRUE again on unmap (for position) * and on unrealize (for size). */ guint need_default_size : 1; guint above_initially : 1; guint accept_focus : 1; guint below_initially : 1; guint builder_visible : 1; guint configure_notify_received : 1; guint decorated : 1; guint deletable : 1; guint destroy_with_parent : 1; guint focus_on_map : 1; guint fullscreen_initially : 1; guint has_user_ref_count : 1; guint iconify_initially : 1; /* gtk_window_iconify() called before realization */ guint is_active : 1; guint maximize_initially : 1; guint mnemonics_visible : 1; guint focus_visible : 1; guint modal : 1; guint resizable : 1; guint stick_initially : 1; guint transient_parent_group : 1; guint type : 4; /* GtkWindowType */ guint gravity : 5; /* GdkGravity */ guint csd_requested : 1; guint client_decorated : 1; /* Decorations drawn client-side */ guint use_client_shadow : 1; /* Decorations use client-side shadows */ guint maximized : 1; guint fullscreen : 1; guint tiled : 1; guint hide_on_close : 1; guint in_emit_close_request : 1; GdkSurfaceTypeHint type_hint; GtkGesture *click_gesture; GtkGesture *drag_gesture; GtkGesture *bubble_drag_gesture; GtkEventController *key_controller; GdkSurface *hardcoded_surface; GtkCssNode *decoration_node; GdkSurface *surface; GskRenderer *renderer; GList *foci; GtkConstraintSolver *constraint_solver; } GtkWindowPrivate; #ifdef GDK_WINDOWING_X11 static const char *dnd_dest_targets [] = { "application/x-rootwindow-drop" }; #endif enum { SET_FOCUS, ACTIVATE_FOCUS, ACTIVATE_DEFAULT, KEYS_CHANGED, ENABLE_DEBUGGING, CLOSE_REQUEST, LAST_SIGNAL }; enum { PROP_0, /* Construct */ PROP_TYPE, /* Normal Props */ PROP_TITLE, PROP_RESIZABLE, PROP_MODAL, PROP_DEFAULT_WIDTH, PROP_DEFAULT_HEIGHT, PROP_DESTROY_WITH_PARENT, PROP_HIDE_ON_CLOSE, PROP_ICON_NAME, PROP_DISPLAY, PROP_TYPE_HINT, PROP_ACCEPT_FOCUS, PROP_FOCUS_ON_MAP, PROP_DECORATED, PROP_DELETABLE, PROP_TRANSIENT_FOR, PROP_ATTACHED_TO, PROP_APPLICATION, PROP_DEFAULT_WIDGET, /* Readonly properties */ PROP_IS_ACTIVE, /* Writeonly properties */ PROP_STARTUP_ID, PROP_MNEMONICS_VISIBLE, PROP_FOCUS_VISIBLE, PROP_IS_MAXIMIZED, LAST_ARG }; static GParamSpec *window_props[LAST_ARG] = { NULL, }; /* Must be kept in sync with GdkSurfaceEdge ! */ typedef enum { GTK_WINDOW_REGION_EDGE_NW, GTK_WINDOW_REGION_EDGE_N, GTK_WINDOW_REGION_EDGE_NE, GTK_WINDOW_REGION_EDGE_W, GTK_WINDOW_REGION_EDGE_E, GTK_WINDOW_REGION_EDGE_SW, GTK_WINDOW_REGION_EDGE_S, GTK_WINDOW_REGION_EDGE_SE, GTK_WINDOW_REGION_CONTENT, GTK_WINDOW_REGION_TITLE, } GtkWindowRegion; typedef struct { gchar *icon_name; guint realized : 1; guint using_default_icon : 1; guint using_themed_icon : 1; } GtkWindowIconInfo; typedef struct { GdkGeometry geometry; /* Last set of geometry hints we set */ GdkSurfaceHints flags; GdkRectangle configure_request; } GtkWindowLastGeometryInfo; struct _GtkWindowGeometryInfo { /* from last gtk_window_resize () - if > 0, indicates that * we should resize to this size. */ gint resize_width; gint resize_height; /* Default size - used only the FIRST time we map a window, * only if > 0. */ gint default_width; gint default_height; GtkWindowLastGeometryInfo last; }; static void gtk_window_constructed (GObject *object); static void gtk_window_dispose (GObject *object); static void gtk_window_finalize (GObject *object); static void gtk_window_destroy (GtkWidget *widget); static void gtk_window_show (GtkWidget *widget); static void gtk_window_hide (GtkWidget *widget); static void gtk_window_map (GtkWidget *widget); static void gtk_window_unmap (GtkWidget *widget); static void gtk_window_realize (GtkWidget *widget); static void gtk_window_unrealize (GtkWidget *widget); static void gtk_window_size_allocate (GtkWidget *widget, int width, int height, int baseline); static gboolean gtk_window_close_request (GtkWindow *window); static void gtk_window_focus_in (GtkWidget *widget); static void gtk_window_focus_out (GtkWidget *widget); static gboolean gtk_window_key_pressed (GtkWidget *widget, guint keyval, guint keycode, GdkModifierType state, gpointer data); static gboolean gtk_window_key_released (GtkWidget *widget, guint keyval, guint keycode, GdkModifierType state, gpointer data); static void surface_state_changed (GtkWidget *widget); static void surface_size_changed (GtkWidget *widget, int width, int height); static gboolean surface_render (GdkSurface *surface, cairo_region_t *region, GtkWidget *widget); static gboolean surface_event (GdkSurface *surface, GdkEvent *event, GtkWidget *widget); static void gtk_window_remove (GtkContainer *container, GtkWidget *widget); static void gtk_window_forall (GtkContainer *container, GtkCallback callback, gpointer callback_data); static gint gtk_window_focus (GtkWidget *widget, GtkDirectionType direction); static void gtk_window_move_focus (GtkWidget *widget, GtkDirectionType dir); static void gtk_window_real_activate_default (GtkWindow *window); static void gtk_window_real_activate_focus (GtkWindow *window); static void gtk_window_keys_changed (GtkWindow *window); static gboolean gtk_window_enable_debugging (GtkWindow *window, gboolean toggle); static void gtk_window_snapshot (GtkWidget *widget, GtkSnapshot *snapshot); static void gtk_window_unset_transient_for (GtkWindow *window); static void gtk_window_transient_parent_realized (GtkWidget *parent, GtkWidget *window); static void gtk_window_transient_parent_unrealized (GtkWidget *parent, GtkWidget *window); static GtkWindowGeometryInfo* gtk_window_get_geometry_info (GtkWindow *window, gboolean create); static void gtk_window_move_resize (GtkWindow *window); static gboolean gtk_window_compare_hints (GdkGeometry *geometry_a, guint flags_a, GdkGeometry *geometry_b, guint flags_b); static void gtk_window_constrain_size (GtkWindow *window, GdkGeometry *geometry, guint flags, gint width, gint height, gint *new_width, gint *new_height); static void gtk_window_update_fixed_size (GtkWindow *window, GdkGeometry *new_geometry, gint new_width, gint new_height); static void gtk_window_compute_hints (GtkWindow *window, GdkGeometry *new_geometry, guint *new_flags); static void gtk_window_compute_configure_request (GtkWindow *window, GdkRectangle *request, GdkGeometry *geometry, guint *flags); static void gtk_window_set_default_size_internal (GtkWindow *window, gboolean change_width, gint width, gboolean change_height, gint height); static void update_themed_icon (GtkWindow *window); static GList *icon_list_from_theme (GtkWindow *window, const gchar *name); static void gtk_window_realize_icon (GtkWindow *window); static void gtk_window_unrealize_icon (GtkWindow *window); static void update_window_buttons (GtkWindow *window); static void get_shadow_width (GtkWindow *window, GtkBorder *shadow_width); static GtkKeyHash *gtk_window_get_key_hash (GtkWindow *window); static void gtk_window_free_key_hash (GtkWindow *window); #ifdef GDK_WINDOWING_X11 static void gtk_window_on_theme_variant_changed (GtkSettings *settings, GParamSpec *pspec, GtkWindow *window); #endif static void gtk_window_set_theme_variant (GtkWindow *window); static void gtk_window_activate_default_activate (GtkWidget *widget, const char *action_name, GVariant *parameter); static void gtk_window_do_popup (GtkWindow *window, GdkEventButton *event); static void gtk_window_style_updated (GtkWidget *widget); static void gtk_window_state_flags_changed (GtkWidget *widget, GtkStateFlags previous_state); static void _gtk_window_set_is_active (GtkWindow *window, gboolean is_active); static GListStore *toplevel_list = NULL; static guint window_signals[LAST_SIGNAL] = { 0 }; static gchar *default_icon_name = NULL; static gboolean disable_startup_notification = FALSE; static GQuark quark_gtk_window_key_hash = 0; static GQuark quark_gtk_window_icon_info = 0; static GQuark quark_gtk_buildable_accels = 0; static GtkBuildableIface *parent_buildable_iface; static void gtk_window_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_window_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); /* GtkBuildable */ static void gtk_window_buildable_interface_init (GtkBuildableIface *iface); static void gtk_window_buildable_add_child (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *type); static void gtk_window_buildable_set_buildable_property (GtkBuildable *buildable, GtkBuilder *builder, const gchar *name, const GValue *value); static void gtk_window_buildable_parser_finished (GtkBuildable *buildable, GtkBuilder *builder); static gboolean gtk_window_buildable_custom_tag_start (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *tagname, GMarkupParser *parser, gpointer *data); static void gtk_window_buildable_custom_finished (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *tagname, gpointer user_data); /* GtkRoot */ static void gtk_window_root_interface_init (GtkRootInterface *iface); static void gtk_window_native_interface_init (GtkNativeInterface *iface); static void ensure_state_flag_backdrop (GtkWidget *widget); static void unset_titlebar (GtkWindow *window); static void on_titlebar_title_notify (GtkHeaderBar *titlebar, GParamSpec *pspec, GtkWindow *self); static GtkWindowRegion get_active_region_type (GtkWindow *window, gint x, gint y); static void gtk_window_update_debugging (void); G_DEFINE_TYPE_WITH_CODE (GtkWindow, gtk_window, GTK_TYPE_BIN, G_ADD_PRIVATE (GtkWindow) G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, gtk_window_buildable_interface_init) G_IMPLEMENT_INTERFACE (GTK_TYPE_NATIVE, gtk_window_native_interface_init) G_IMPLEMENT_INTERFACE (GTK_TYPE_ROOT, gtk_window_root_interface_init)) static void add_tab_bindings (GtkBindingSet *binding_set, GdkModifierType modifiers, GtkDirectionType direction) { gtk_binding_entry_add_signal (binding_set, GDK_KEY_Tab, modifiers, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Tab, modifiers, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); } static void add_arrow_bindings (GtkBindingSet *binding_set, guint keysym, GtkDirectionType direction) { guint keypad_keysym = keysym - GDK_KEY_Left + GDK_KEY_KP_Left; gtk_binding_entry_add_signal (binding_set, keysym, 0, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); gtk_binding_entry_add_signal (binding_set, keysym, GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); gtk_binding_entry_add_signal (binding_set, keypad_keysym, 0, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); gtk_binding_entry_add_signal (binding_set, keypad_keysym, GDK_CONTROL_MASK, "move-focus", 1, GTK_TYPE_DIRECTION_TYPE, direction); } static guint32 extract_time_from_startup_id (const gchar* startup_id) { gchar *timestr = g_strrstr (startup_id, "_TIME"); guint32 retval = GDK_CURRENT_TIME; if (timestr) { gchar *end; guint32 timestamp; /* Skip past the "_TIME" part */ timestr += 5; end = NULL; errno = 0; timestamp = g_ascii_strtoull (timestr, &end, 0); if (errno == 0 && end != timestr) retval = timestamp; } return retval; } static gboolean startup_id_is_fake (const gchar* startup_id) { return strncmp (startup_id, "_TIME", 5) == 0; } static void gtk_window_measure (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *child = gtk_bin_get_child (GTK_BIN (widget)); gboolean has_size_request = gtk_widget_has_size_request (widget); int title_min_size = 0; int title_nat_size = 0; int child_min_size = 0; int child_nat_size = 0; GtkBorder window_border = { 0 }; if (priv->decorated && !priv->fullscreen) { get_shadow_width (window, &window_border); if (orientation == GTK_ORIENTATION_HORIZONTAL) for_size -= window_border.left + window_border.right; else for_size -= window_border.top + window_border.bottom; if (priv->title_box != NULL && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box)) { int size = for_size; if (orientation == GTK_ORIENTATION_HORIZONTAL && for_size >= 0) gtk_widget_measure (priv->title_box, GTK_ORIENTATION_VERTICAL, -1, NULL, &size, NULL, NULL); gtk_widget_measure (priv->title_box, orientation, MAX (size, -1), &title_min_size, &title_nat_size, NULL, NULL); } } if (child != NULL && gtk_widget_get_visible (child)) { gtk_widget_measure (child, orientation, MAX (for_size, -1), &child_min_size, &child_nat_size, NULL, NULL); if (child_nat_size == 0 && !has_size_request) child_nat_size = NO_CONTENT_CHILD_NAT; } else if (!has_size_request) { child_nat_size = NO_CONTENT_CHILD_NAT; } if (orientation == GTK_ORIENTATION_HORIZONTAL) { title_min_size += window_border.left + window_border.right; title_nat_size += window_border.left + window_border.right; child_min_size += window_border.left + window_border.right; child_nat_size += window_border.left + window_border.right; *minimum = MAX (title_min_size, child_min_size); *natural = MAX (title_nat_size, child_nat_size); } else { *minimum = title_min_size + child_min_size + window_border.top + window_border.bottom; *natural = title_nat_size + child_nat_size + window_border.top + window_border.bottom; } } static void gtk_window_add (GtkContainer *container, GtkWidget *child) { /* Insert the child's css node now at the end so the order wrt. decoration_node is correct */ gtk_css_node_insert_before (gtk_widget_get_css_node (GTK_WIDGET (container)), gtk_widget_get_css_node (child), NULL); GTK_CONTAINER_CLASS (gtk_window_parent_class)->add (container, child); } static void popover_get_rect (GtkWindowPopover *popover, GtkWindow *window, cairo_rectangle_int_t *rect); GtkWidget * gtk_window_pick_popover (GtkWindow *window, double x, double y, GtkPickFlags flags) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *popovers; for (popovers = priv->popovers.tail; popovers; popovers = popovers->prev) { GtkWindowPopover *popover = popovers->data; int dest_x, dest_y; GtkWidget *picked; gtk_widget_translate_coordinates (GTK_WIDGET (window), popover->widget, x, y, &dest_x, &dest_y); picked = gtk_widget_pick (popover->widget, dest_x, dest_y, flags); if (picked) return picked; } return NULL; } static void gtk_window_class_init (GtkWindowClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class; GtkContainerClass *container_class; GtkBindingSet *binding_set; widget_class = (GtkWidgetClass*) klass; container_class = (GtkContainerClass*) klass; quark_gtk_window_key_hash = g_quark_from_static_string ("gtk-window-key-hash"); quark_gtk_window_icon_info = g_quark_from_static_string ("gtk-window-icon-info"); quark_gtk_buildable_accels = g_quark_from_static_string ("gtk-window-buildable-accels"); if (toplevel_list == NULL) toplevel_list = g_list_store_new (GTK_TYPE_WIDGET); gobject_class->constructed = gtk_window_constructed; gobject_class->dispose = gtk_window_dispose; gobject_class->finalize = gtk_window_finalize; gobject_class->set_property = gtk_window_set_property; gobject_class->get_property = gtk_window_get_property; widget_class->destroy = gtk_window_destroy; widget_class->show = gtk_window_show; widget_class->hide = gtk_window_hide; widget_class->map = gtk_window_map; widget_class->unmap = gtk_window_unmap; widget_class->realize = gtk_window_realize; widget_class->unrealize = gtk_window_unrealize; widget_class->size_allocate = gtk_window_size_allocate; widget_class->focus = gtk_window_focus; widget_class->move_focus = gtk_window_move_focus; widget_class->measure = gtk_window_measure; widget_class->state_flags_changed = gtk_window_state_flags_changed; widget_class->style_updated = gtk_window_style_updated; widget_class->snapshot = gtk_window_snapshot; container_class->add = gtk_window_add; container_class->remove = gtk_window_remove; container_class->forall = gtk_window_forall; klass->activate_default = gtk_window_real_activate_default; klass->activate_focus = gtk_window_real_activate_focus; klass->keys_changed = gtk_window_keys_changed; klass->enable_debugging = gtk_window_enable_debugging; klass->close_request = gtk_window_close_request; window_props[PROP_TYPE] = g_param_spec_enum ("type", P_("Window Type"), P_("The type of the window"), GTK_TYPE_WINDOW_TYPE, GTK_WINDOW_TOPLEVEL, GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY); window_props[PROP_TITLE] = g_param_spec_string ("title", P_("Window Title"), P_("The title of the window"), NULL, GTK_PARAM_READWRITE); /** * GtkWindow:startup-id: * * The :startup-id is a write-only property for setting window's * startup notification identifier. See gtk_window_set_startup_id() * for more details. */ window_props[PROP_STARTUP_ID] = g_param_spec_string ("startup-id", P_("Startup ID"), P_("Unique startup identifier for the window used by startup-notification"), NULL, GTK_PARAM_WRITABLE); window_props[PROP_RESIZABLE] = g_param_spec_boolean ("resizable", P_("Resizable"), P_("If TRUE, users can resize the window"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_MODAL] = g_param_spec_boolean ("modal", P_("Modal"), P_("If TRUE, the window is modal (other windows are not usable while this one is up)"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_DEFAULT_WIDTH] = g_param_spec_int ("default-width", P_("Default Width"), P_("The default width of the window, used when initially showing the window"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_DEFAULT_HEIGHT] = g_param_spec_int ("default-height", P_("Default Height"), P_("The default height of the window, used when initially showing the window"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_DESTROY_WITH_PARENT] = g_param_spec_boolean ("destroy-with-parent", P_("Destroy with Parent"), P_("If this window should be destroyed when the parent is destroyed"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_HIDE_ON_CLOSE] = g_param_spec_boolean ("hide-on-close", P_("Hide on close"), P_("If this window should be hidden when the user clicks the close button"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:mnemonics-visible: * * Whether mnemonics are currently visible in this window. * * This property is maintained by GTK+ based on user input, * and should not be set by applications. */ window_props[PROP_MNEMONICS_VISIBLE] = g_param_spec_boolean ("mnemonics-visible", P_("Mnemonics Visible"), P_("Whether mnemonics are currently visible in this window"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:focus-visible: * * Whether 'focus rectangles' are currently visible in this window. * * This property is maintained by GTK+ based on user input * and should not be set by applications. */ window_props[PROP_FOCUS_VISIBLE] = g_param_spec_boolean ("focus-visible", P_("Focus Visible"), P_("Whether focus rectangles are currently visible in this window"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:icon-name: * * The :icon-name property specifies the name of the themed icon to * use as the window icon. See #GtkIconTheme for more details. */ window_props[PROP_ICON_NAME] = g_param_spec_string ("icon-name", P_("Icon Name"), P_("Name of the themed icon for this window"), NULL, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_DISPLAY] = g_param_spec_object ("display", P_("Display"), P_("The display that will display this window"), GDK_TYPE_DISPLAY, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_IS_ACTIVE] = g_param_spec_boolean ("is-active", P_("Is Active"), P_("Whether the toplevel is the current active window"), FALSE, GTK_PARAM_READABLE); window_props[PROP_TYPE_HINT] = g_param_spec_enum ("type-hint", P_("Type hint"), P_("Hint to help the desktop environment understand what kind of window this is and how to treat it."), GDK_TYPE_SURFACE_TYPE_HINT, GDK_SURFACE_TYPE_HINT_NORMAL, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:accept-focus: * * Whether the window should receive the input focus. */ window_props[PROP_ACCEPT_FOCUS] = g_param_spec_boolean ("accept-focus", P_("Accept focus"), P_("TRUE if the window should receive the input focus."), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:focus-on-map: * * Whether the window should receive the input focus when mapped. */ window_props[PROP_FOCUS_ON_MAP] = g_param_spec_boolean ("focus-on-map", P_("Focus on map"), P_("TRUE if the window should receive the input focus when mapped."), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:decorated: * * Whether the window should be decorated by the window manager. */ window_props[PROP_DECORATED] = g_param_spec_boolean ("decorated", P_("Decorated"), P_("Whether the window should be decorated by the window manager"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:deletable: * * Whether the window frame should have a close button. */ window_props[PROP_DELETABLE] = g_param_spec_boolean ("deletable", P_("Deletable"), P_("Whether the window frame should have a close button"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:transient-for: * * The transient parent of the window. See gtk_window_set_transient_for() for * more details about transient windows. */ window_props[PROP_TRANSIENT_FOR] = g_param_spec_object ("transient-for", P_("Transient for Window"), P_("The transient parent of the dialog"), GTK_TYPE_WINDOW, GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY); /** * GtkWindow:attached-to: * * The widget to which this window is attached. * See gtk_window_set_attached_to(). * * Examples of places where specifying this relation is useful are * for instance a #GtkMenu created by a #GtkComboBox, a completion * popup window created by #GtkEntry or a typeahead search entry * created by #GtkTreeView. */ window_props[PROP_ATTACHED_TO] = g_param_spec_object ("attached-to", P_("Attached to Widget"), P_("The widget where the window is attached"), GTK_TYPE_WIDGET, GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_IS_MAXIMIZED] = g_param_spec_boolean ("is-maximized", P_("Is maximized"), P_("Whether the window is maximized"), FALSE, GTK_PARAM_READABLE); /** * GtkWindow:application: * * The #GtkApplication associated with the window. * * The application will be kept alive for at least as long as it * has any windows associated with it (see g_application_hold() * for a way to keep it alive without windows). * * Normally, the connection between the application and the window * will remain until the window is destroyed, but you can explicitly * remove it by setting the :application property to %NULL. */ window_props[PROP_APPLICATION] = g_param_spec_object ("application", P_("GtkApplication"), P_("The GtkApplication for the window"), GTK_TYPE_APPLICATION, GTK_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY); window_props[PROP_DEFAULT_WIDGET] = g_param_spec_object ("default-widget", P_("Default widget"), P_("The default widget"), GTK_TYPE_WIDGET, GTK_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY); g_object_class_install_properties (gobject_class, LAST_ARG, window_props); gtk_root_install_properties (gobject_class, LAST_ARG); /** * GtkWindow::activate-focus: * @window: the window which received the signal * * The ::activate-focus signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user activates the currently * focused widget of @window. */ window_signals[ACTIVATE_FOCUS] = g_signal_new (I_("activate-focus"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkWindowClass, activate_focus), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkWindow::activate-default: * @window: the window which received the signal * * The ::activate-default signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user activates the default widget * of @window. */ window_signals[ACTIVATE_DEFAULT] = g_signal_new (I_("activate-default"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkWindowClass, activate_default), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkWindow::keys-changed: * @window: the window which received the signal * * The ::keys-changed signal gets emitted when the set of accelerators * or mnemonics that are associated with @window changes. */ window_signals[KEYS_CHANGED] = g_signal_new (I_("keys-changed"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkWindowClass, keys_changed), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkWindow::enable-debugging: * @window: the window on which the signal is emitted * @toggle: toggle the debugger * * The ::enable-debugging signal is a [keybinding signal][GtkBindingSignal] * which gets emitted when the user enables or disables interactive * debugging. When @toggle is %TRUE, interactive debugging is toggled * on or off, when it is %FALSE, the debugger will be pointed at the * widget under the pointer. * * The default bindings for this signal are Ctrl-Shift-I * and Ctrl-Shift-D. * * Return: %TRUE if the key binding was handled */ window_signals[ENABLE_DEBUGGING] = g_signal_new (I_("enable-debugging"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkWindowClass, enable_debugging), NULL, NULL, _gtk_marshal_BOOLEAN__BOOLEAN, G_TYPE_BOOLEAN, 1, G_TYPE_BOOLEAN); /** * GtkWindow::close-request: * @window: the window on which the signal is emitted * * The ::close-request signal is emitted when the user clicks on the close * button of the window. * * Return: %TRUE to stop other handlers from being invoked for the signal */ window_signals[CLOSE_REQUEST] = g_signal_new (I_("close-request"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkWindowClass, close_request), _gtk_boolean_handled_accumulator, NULL, NULL, G_TYPE_BOOLEAN, 0); /* * Key bindings */ gtk_widget_class_install_action (widget_class, "default.activate", NULL, gtk_window_activate_default_activate); binding_set = gtk_binding_set_by_class (klass); gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, 0, "activate-focus", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, 0, "activate-focus", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_Return, 0, "activate-default", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_ISO_Enter, 0, "activate-default", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Enter, 0, "activate-default", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_I, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "enable-debugging", 1, G_TYPE_BOOLEAN, FALSE); gtk_binding_entry_add_signal (binding_set, GDK_KEY_D, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "enable-debugging", 1, G_TYPE_BOOLEAN, TRUE); add_arrow_bindings (binding_set, GDK_KEY_Up, GTK_DIR_UP); add_arrow_bindings (binding_set, GDK_KEY_Down, GTK_DIR_DOWN); add_arrow_bindings (binding_set, GDK_KEY_Left, GTK_DIR_LEFT); add_arrow_bindings (binding_set, GDK_KEY_Right, GTK_DIR_RIGHT); add_tab_bindings (binding_set, 0, GTK_DIR_TAB_FORWARD); add_tab_bindings (binding_set, GDK_CONTROL_MASK, GTK_DIR_TAB_FORWARD); add_tab_bindings (binding_set, GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD); add_tab_bindings (binding_set, GDK_CONTROL_MASK | GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD); gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_WINDOW_ACCESSIBLE); gtk_widget_class_set_css_name (widget_class, I_("window")); } /** * gtk_window_is_maximized: * @window: a #GtkWindow * * Retrieves the current maximized state of @window. * * Note that since maximization is ultimately handled by the window * manager and happens asynchronously to an application request, you * shouldn’t assume the return value of this function changing * immediately (or at all), as an effect of calling * gtk_window_maximize() or gtk_window_unmaximize(). * * Returns: whether the window has a maximized state. */ gboolean gtk_window_is_maximized (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->maximized; } void _gtk_window_toggle_maximized (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->maximized) gtk_window_unmaximize (window); else gtk_window_maximize (window); } /** * gtk_window_close: * @window: a #GtkWindow * * Requests that the window is closed, similar to what happens * when a window manager close button is clicked. * * This function can be used with close buttons in custom * titlebars. */ void gtk_window_close (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (!_gtk_widget_get_realized (GTK_WIDGET (window))) return; if (priv->in_emit_close_request) return; g_object_ref (window); if (!gtk_window_emit_close_request (window)) gtk_widget_destroy (GTK_WIDGET (window)); g_object_unref (window); } static void popover_destroy (GtkWindowPopover *popover) { if (popover->widget && _gtk_widget_get_parent (popover->widget)) gtk_widget_unparent (popover->widget); g_free (popover); } static gboolean gtk_window_titlebar_action (GtkWindow *window, const GdkEvent *event, guint button, gint n_press) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkSettings *settings; gchar *action = NULL; gboolean retval = TRUE; settings = gtk_widget_get_settings (GTK_WIDGET (window)); switch (button) { case GDK_BUTTON_PRIMARY: if (n_press == 2) g_object_get (settings, "gtk-titlebar-double-click", &action, NULL); break; case GDK_BUTTON_MIDDLE: g_object_get (settings, "gtk-titlebar-middle-click", &action, NULL); break; case GDK_BUTTON_SECONDARY: g_object_get (settings, "gtk-titlebar-right-click", &action, NULL); break; default: break; } if (action == NULL) retval = FALSE; else if (g_str_equal (action, "none")) retval = FALSE; /* treat all maximization variants the same */ else if (g_str_has_prefix (action, "toggle-maximize")) { /* * gtk header bar won't show the maximize button if the following * properties are not met, apply the same to title bar actions for * consistency. */ if (gtk_window_get_resizable (window) && gtk_window_get_type_hint (window) == GDK_SURFACE_TYPE_HINT_NORMAL) _gtk_window_toggle_maximized (window); } else if (g_str_equal (action, "lower")) gdk_surface_lower (priv->surface); else if (g_str_equal (action, "minimize")) gdk_surface_iconify (priv->surface); else if (g_str_equal (action, "menu")) gtk_window_do_popup (window, (GdkEventButton*) event); else { g_warning ("Unsupported titlebar action %s", action); retval = FALSE; } g_free (action); return retval; } static void click_gesture_pressed_cb (GtkGestureClick *gesture, gint n_press, gdouble x, gdouble y, GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *event_widget, *widget; GdkEventSequence *sequence; GtkWindowRegion region; const GdkEvent *event; guint button; gboolean window_drag = FALSE; widget = GTK_WIDGET (window); sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); button = gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)); event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); if (!event) return; if (n_press > 1) gtk_gesture_set_state (priv->drag_gesture, GTK_EVENT_SEQUENCE_DENIED); region = get_active_region_type (window, x, y); if (gdk_display_device_is_grabbed (gtk_widget_get_display (widget), gtk_gesture_get_device (GTK_GESTURE (gesture)))) { gtk_gesture_set_state (priv->drag_gesture, GTK_EVENT_SEQUENCE_DENIED); return; } if (button == GDK_BUTTON_SECONDARY && region == GTK_WINDOW_REGION_TITLE) { if (gtk_window_titlebar_action (window, event, button, n_press)) gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (gesture)); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (priv->drag_gesture)); return; } else if (button == GDK_BUTTON_MIDDLE && region == GTK_WINDOW_REGION_TITLE) { if (gtk_window_titlebar_action (window, event, button, n_press)) gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); return; } else if (button != GDK_BUTTON_PRIMARY) return; event_widget = gtk_get_event_widget ((GdkEvent *) event); if (region == GTK_WINDOW_REGION_TITLE) gdk_surface_raise (priv->surface); switch (region) { case GTK_WINDOW_REGION_CONTENT: if (event_widget != widget) { /* TODO: Have some way of enabling/disabling window-dragging on random widgets */ } if (!window_drag) { gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_DENIED); return; } G_GNUC_FALLTHROUGH; case GTK_WINDOW_REGION_TITLE: if (n_press == 2) gtk_window_titlebar_action (window, event, button, n_press); if (gtk_widget_has_grab (widget)) gtk_gesture_set_sequence_state (GTK_GESTURE (gesture), sequence, GTK_EVENT_SEQUENCE_CLAIMED); break; case GTK_WINDOW_REGION_EDGE_NW: case GTK_WINDOW_REGION_EDGE_N: case GTK_WINDOW_REGION_EDGE_NE: case GTK_WINDOW_REGION_EDGE_W: case GTK_WINDOW_REGION_EDGE_E: case GTK_WINDOW_REGION_EDGE_SW: case GTK_WINDOW_REGION_EDGE_S: case GTK_WINDOW_REGION_EDGE_SE: default: if (!priv->maximized) { double tx, ty; gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_CLAIMED); gdk_event_get_coords (event, &tx, &ty); gdk_surface_begin_resize_drag_for_device (priv->surface, (GdkSurfaceEdge) region, gdk_event_get_device ((GdkEvent *) event), GDK_BUTTON_PRIMARY, tx, ty, gdk_event_get_time (event)); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (gesture)); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (priv->drag_gesture)); } break; } } static void drag_gesture_begin_cb (GtkGestureDrag *gesture, gdouble x, gdouble y, GtkWindow *window) { GdkEventSequence *sequence; GtkWindowRegion region; gboolean widget_drag = FALSE; const GdkEvent *event; sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); if (!event) return; region = get_active_region_type (window, x, y); switch (region) { case GTK_WINDOW_REGION_TITLE: /* Claim it */ break; case GTK_WINDOW_REGION_CONTENT: /* TODO: Have some way of enabling/disabling window-dragging on random widgets */ if (!widget_drag) gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_DENIED); break; case GTK_WINDOW_REGION_EDGE_NW: case GTK_WINDOW_REGION_EDGE_N: case GTK_WINDOW_REGION_EDGE_NE: case GTK_WINDOW_REGION_EDGE_W: case GTK_WINDOW_REGION_EDGE_E: case GTK_WINDOW_REGION_EDGE_SW: case GTK_WINDOW_REGION_EDGE_S: case GTK_WINDOW_REGION_EDGE_SE: default: gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_DENIED); } } static void drag_gesture_update_cb (GtkGestureDrag *gesture, gdouble offset_x, gdouble offset_y, GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gint double_click_distance; GtkSettings *settings; settings = gtk_widget_get_settings (GTK_WIDGET (window)); g_object_get (settings, "gtk-double-click-distance", &double_click_distance, NULL); if (ABS (offset_x) > double_click_distance || ABS (offset_y) > double_click_distance) { GdkEventSequence *sequence; gdouble start_x, start_y; sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); if (gtk_event_controller_get_propagation_phase (GTK_EVENT_CONTROLLER (gesture)) == GTK_PHASE_CAPTURE) { const GdkEvent *event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); GtkWidget *event_widget = gtk_get_event_target (event); /* Check whether the target widget should be left alone at handling * the sequence, this is better done late to give room for gestures * there to go denied. * * Besides claiming gestures, we must bail out too if there's gestures * in the "none" state at this point, as those are still handling events * and can potentially go claimed, and we don't want to stop the target * widget from doing anything. */ if (event_widget != GTK_WIDGET (window) && !gtk_widget_has_grab (event_widget) && _gtk_widget_consumes_motion (event_widget, sequence)) { gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_DENIED); return; } } gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_CLAIMED); gtk_gesture_drag_get_start_point (gesture, &start_x, &start_y); gdk_surface_begin_move_drag_for_device (priv->surface, gtk_gesture_get_device (GTK_GESTURE (gesture)), gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)), (int)start_x, (int)start_y, gtk_get_current_event_time ()); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (gesture)); gtk_event_controller_reset (GTK_EVENT_CONTROLLER (priv->click_gesture)); } } static void node_style_changed_cb (GtkCssNode *node, GtkCssStyleChange *change, GtkWidget *widget) { if (gtk_css_style_change_affects (change, GTK_CSS_AFFECTS_SIZE)) gtk_widget_queue_resize (widget); else gtk_widget_queue_draw (widget); } static void device_removed_cb (GdkSeat *seat, GdkDevice *device, gpointer user_data) { GtkWindow *window = user_data; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *l = priv->foci, *cur; while (l) { GtkPointerFocus *focus = l->data; cur = l; focus = cur->data; l = cur->next; if (focus->device == device) { priv->foci = g_list_delete_link (priv->foci, cur); gtk_pointer_focus_unref (focus); } } } static guint constraints_for_edge (GdkSurfaceEdge edge) { switch (edge) { case GDK_SURFACE_EDGE_NORTH_WEST: return GDK_SURFACE_STATE_LEFT_RESIZABLE | GDK_SURFACE_STATE_TOP_RESIZABLE; case GDK_SURFACE_EDGE_NORTH: return GDK_SURFACE_STATE_TOP_RESIZABLE; case GDK_SURFACE_EDGE_NORTH_EAST: return GDK_SURFACE_STATE_RIGHT_RESIZABLE | GDK_SURFACE_STATE_TOP_RESIZABLE; case GDK_SURFACE_EDGE_WEST: return GDK_SURFACE_STATE_LEFT_RESIZABLE; case GDK_SURFACE_EDGE_EAST: return GDK_SURFACE_STATE_RIGHT_RESIZABLE; case GDK_SURFACE_EDGE_SOUTH_WEST: return GDK_SURFACE_STATE_LEFT_RESIZABLE | GDK_SURFACE_STATE_BOTTOM_RESIZABLE; case GDK_SURFACE_EDGE_SOUTH: return GDK_SURFACE_STATE_BOTTOM_RESIZABLE; case GDK_SURFACE_EDGE_SOUTH_EAST: return GDK_SURFACE_STATE_RIGHT_RESIZABLE | GDK_SURFACE_STATE_BOTTOM_RESIZABLE; default: g_warn_if_reached (); return 0; } } static gboolean edge_under_coordinates (GtkWindow *window, gint x, gint y, GdkSurfaceEdge edge) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkAllocation allocation; GtkStyleContext *context; gint handle_v, handle_h; GtkBorder border; gboolean supports_edge_constraints; guint constraints; if (priv->type != GTK_WINDOW_TOPLEVEL || !priv->client_decorated || !priv->resizable || priv->fullscreen || priv->maximized) return FALSE; supports_edge_constraints = gdk_surface_supports_edge_constraints (priv->surface); constraints = constraints_for_edge (edge); if (!supports_edge_constraints && priv->tiled) return FALSE; if (supports_edge_constraints && (priv->edge_constraints & constraints) != constraints) return FALSE; gtk_widget_get_allocation (GTK_WIDGET (window), &allocation); context = _gtk_widget_get_style_context (GTK_WIDGET (window)); gtk_style_context_save_to_node (context, priv->decoration_node); if (priv->use_client_shadow) { handle_h = MIN (RESIZE_HANDLE_SIZE, allocation.width / 2); handle_v = MIN (RESIZE_HANDLE_SIZE, allocation.height / 2); get_shadow_width (window, &border); } else { handle_h = 0; handle_v = 0; gtk_style_context_get_padding (context, &border); } gtk_style_context_restore (context); /* Check whether the click falls outside the handle area */ if (x >= allocation.x + border.left && x < allocation.x + allocation.width - border.right && y >= allocation.y + border.top && y < allocation.y + allocation.height - border.bottom) return FALSE; /* Check X axis */ if (x < allocation.x + border.left + handle_h) { if (edge != GDK_SURFACE_EDGE_NORTH_WEST && edge != GDK_SURFACE_EDGE_WEST && edge != GDK_SURFACE_EDGE_SOUTH_WEST && edge != GDK_SURFACE_EDGE_NORTH && edge != GDK_SURFACE_EDGE_SOUTH) return FALSE; if ((edge == GDK_SURFACE_EDGE_NORTH || edge == GDK_SURFACE_EDGE_SOUTH) && (priv->edge_constraints & constraints_for_edge (GDK_SURFACE_EDGE_WEST))) return FALSE; } else if (x >= allocation.x + allocation.width - border.right - handle_h) { if (edge != GDK_SURFACE_EDGE_NORTH_EAST && edge != GDK_SURFACE_EDGE_EAST && edge != GDK_SURFACE_EDGE_SOUTH_EAST && edge != GDK_SURFACE_EDGE_NORTH && edge != GDK_SURFACE_EDGE_SOUTH) return FALSE; if ((edge == GDK_SURFACE_EDGE_NORTH || edge == GDK_SURFACE_EDGE_SOUTH) && (priv->edge_constraints & constraints_for_edge (GDK_SURFACE_EDGE_EAST))) return FALSE; } else if (edge != GDK_SURFACE_EDGE_NORTH && edge != GDK_SURFACE_EDGE_SOUTH) return FALSE; /* Check Y axis */ if (y < allocation.y + border.top + handle_v) { if (edge != GDK_SURFACE_EDGE_NORTH_WEST && edge != GDK_SURFACE_EDGE_NORTH && edge != GDK_SURFACE_EDGE_NORTH_EAST && edge != GDK_SURFACE_EDGE_EAST && edge != GDK_SURFACE_EDGE_WEST) return FALSE; if ((edge == GDK_SURFACE_EDGE_EAST || edge == GDK_SURFACE_EDGE_WEST) && (priv->edge_constraints & constraints_for_edge (GDK_SURFACE_EDGE_NORTH))) return FALSE; } else if (y > allocation.y + allocation.height - border.bottom - handle_v) { if (edge != GDK_SURFACE_EDGE_SOUTH_WEST && edge != GDK_SURFACE_EDGE_SOUTH && edge != GDK_SURFACE_EDGE_SOUTH_EAST && edge != GDK_SURFACE_EDGE_EAST && edge != GDK_SURFACE_EDGE_WEST) return FALSE; if ((edge == GDK_SURFACE_EDGE_EAST || edge == GDK_SURFACE_EDGE_WEST) && (priv->edge_constraints & constraints_for_edge (GDK_SURFACE_EDGE_SOUTH))) return FALSE; } else if (edge != GDK_SURFACE_EDGE_WEST && edge != GDK_SURFACE_EDGE_EAST) return FALSE; return TRUE; } static void gtk_window_capture_motion (GtkWidget *widget, gdouble x, gdouble y) { gint i; const gchar *cursor_names[8] = { "nw-resize", "n-resize", "ne-resize", "w-resize", "e-resize", "sw-resize", "s-resize", "se-resize" }; for (i = 0; i < 8; i++) { if (edge_under_coordinates (GTK_WINDOW (widget), x, y, i)) { gtk_widget_set_cursor_from_name (widget, cursor_names[i]); return; } } gtk_widget_set_cursor (widget, NULL); } static void gtk_window_activate_default_activate (GtkWidget *widget, const char *name, GVariant *parameter) { gtk_window_real_activate_default (GTK_WINDOW (widget)); } static void gtk_window_init (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; GtkCssNode *widget_node; GdkSeat *seat; GtkEventController *motion_controller; #ifdef GDK_WINDOWING_X11 GdkContentFormats *targets; #endif widget = GTK_WIDGET (window); priv->title = NULL; priv->geometry_info = NULL; priv->type = GTK_WINDOW_TOPLEVEL; priv->focus_widget = NULL; priv->default_widget = NULL; priv->configure_request_count = 0; priv->resizable = TRUE; priv->configure_notify_received = FALSE; priv->need_default_size = TRUE; priv->modal = FALSE; priv->gravity = GDK_GRAVITY_NORTH_WEST; priv->decorated = TRUE; priv->mnemonic_modifier = GDK_MOD1_MASK; priv->display = gdk_display_get_default (); priv->state = GDK_SURFACE_STATE_WITHDRAWN; priv->accept_focus = TRUE; priv->focus_on_map = TRUE; priv->deletable = TRUE; priv->type_hint = GDK_SURFACE_TYPE_HINT_NORMAL; priv->startup_id = NULL; priv->initial_timestamp = GDK_CURRENT_TIME; priv->mnemonics_visible = FALSE; priv->focus_visible = TRUE; priv->initial_fullscreen_monitor = NULL; g_object_ref_sink (window); priv->has_user_ref_count = TRUE; gtk_window_update_debugging (); #ifdef GDK_WINDOWING_X11 g_signal_connect (gtk_settings_get_for_display (priv->display), "notify::gtk-application-prefer-dark-theme", G_CALLBACK (gtk_window_on_theme_variant_changed), window); #endif widget_node = gtk_widget_get_css_node (GTK_WIDGET (window)); priv->decoration_node = gtk_css_node_new (); gtk_css_node_set_name (priv->decoration_node, I_("decoration")); gtk_css_node_set_parent (priv->decoration_node, widget_node); gtk_css_node_set_state (priv->decoration_node, gtk_css_node_get_state (widget_node)); g_signal_connect_object (priv->decoration_node, "style-changed", G_CALLBACK (node_style_changed_cb), window, 0); g_object_unref (priv->decoration_node); gtk_css_node_add_class (widget_node, g_quark_from_static_string (GTK_STYLE_CLASS_BACKGROUND)); priv->scale = gtk_widget_get_scale_factor (widget); #ifdef GDK_WINDOWING_X11 targets = gdk_content_formats_new (dnd_dest_targets, G_N_ELEMENTS (dnd_dest_targets)); gtk_drag_dest_set (GTK_WIDGET (window), GTK_DEST_DEFAULT_MOTION | GTK_DEST_DEFAULT_DROP, targets, GDK_ACTION_MOVE); gdk_content_formats_unref (targets); #endif seat = gdk_display_get_default_seat (gtk_widget_get_display (widget)); g_signal_connect (seat, "device-removed", G_CALLBACK (device_removed_cb), window); motion_controller = gtk_event_controller_motion_new (); gtk_event_controller_set_propagation_phase (motion_controller, GTK_PHASE_CAPTURE); g_signal_connect_swapped (motion_controller, "motion", G_CALLBACK (gtk_window_capture_motion), window); gtk_widget_add_controller (widget, motion_controller); priv->key_controller = gtk_event_controller_key_new (); gtk_event_controller_set_propagation_phase (priv->key_controller, GTK_PHASE_CAPTURE); g_signal_connect_swapped (priv->key_controller, "focus-in", G_CALLBACK (gtk_window_focus_in), window); g_signal_connect_swapped (priv->key_controller, "focus-out", G_CALLBACK (gtk_window_focus_out), window); g_signal_connect_swapped (priv->key_controller, "key-pressed", G_CALLBACK (gtk_window_key_pressed), window); g_signal_connect_swapped (priv->key_controller, "key-released", G_CALLBACK (gtk_window_key_released), window); gtk_widget_add_controller (widget, priv->key_controller); /* Shared constraint solver */ priv->constraint_solver = gtk_constraint_solver_new (); } static GtkGesture * create_drag_gesture (GtkWindow *window) { GtkGesture *gesture; gesture = gtk_gesture_drag_new (); g_signal_connect (gesture, "drag-begin", G_CALLBACK (drag_gesture_begin_cb), window); g_signal_connect (gesture, "drag-update", G_CALLBACK (drag_gesture_update_cb), window); gtk_widget_add_controller (GTK_WIDGET (window), GTK_EVENT_CONTROLLER (gesture)); return gesture; } static void gtk_window_constructed (GObject *object) { GtkWindow *window = GTK_WINDOW (object); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); G_OBJECT_CLASS (gtk_window_parent_class)->constructed (object); if (priv->type == GTK_WINDOW_TOPLEVEL) { priv->click_gesture = gtk_gesture_click_new (); gtk_gesture_single_set_button (GTK_GESTURE_SINGLE (priv->click_gesture), 0); gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->click_gesture), GTK_PHASE_BUBBLE); g_signal_connect (priv->click_gesture, "pressed", G_CALLBACK (click_gesture_pressed_cb), object); gtk_widget_add_controller (GTK_WIDGET (object), GTK_EVENT_CONTROLLER (priv->click_gesture)); priv->drag_gesture = create_drag_gesture (window); gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->drag_gesture), GTK_PHASE_CAPTURE); priv->bubble_drag_gesture = create_drag_gesture (window); gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->bubble_drag_gesture), GTK_PHASE_BUBBLE); } g_list_store_append (toplevel_list, window); g_object_unref (window); } static void gtk_window_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkWindow *window = GTK_WINDOW (object); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); switch (prop_id) { case PROP_TYPE: priv->type = g_value_get_enum (value); break; case PROP_TITLE: gtk_window_set_title (window, g_value_get_string (value)); break; case PROP_STARTUP_ID: gtk_window_set_startup_id (window, g_value_get_string (value)); break; case PROP_RESIZABLE: gtk_window_set_resizable (window, g_value_get_boolean (value)); break; case PROP_MODAL: gtk_window_set_modal (window, g_value_get_boolean (value)); break; case PROP_DEFAULT_WIDTH: gtk_window_set_default_size_internal (window, TRUE, g_value_get_int (value), FALSE, -1); break; case PROP_DEFAULT_HEIGHT: gtk_window_set_default_size_internal (window, FALSE, -1, TRUE, g_value_get_int (value)); break; case PROP_DESTROY_WITH_PARENT: gtk_window_set_destroy_with_parent (window, g_value_get_boolean (value)); break; case PROP_HIDE_ON_CLOSE: gtk_window_set_hide_on_close (window, g_value_get_boolean (value)); break; case PROP_ICON_NAME: gtk_window_set_icon_name (window, g_value_get_string (value)); break; case PROP_DISPLAY: gtk_window_set_display (window, g_value_get_object (value)); break; case PROP_TYPE_HINT: gtk_window_set_type_hint (window, g_value_get_enum (value)); break; case PROP_ACCEPT_FOCUS: gtk_window_set_accept_focus (window, g_value_get_boolean (value)); break; case PROP_FOCUS_ON_MAP: gtk_window_set_focus_on_map (window, g_value_get_boolean (value)); break; case PROP_DECORATED: gtk_window_set_decorated (window, g_value_get_boolean (value)); break; case PROP_DELETABLE: gtk_window_set_deletable (window, g_value_get_boolean (value)); break; case PROP_TRANSIENT_FOR: gtk_window_set_transient_for (window, g_value_get_object (value)); break; case PROP_ATTACHED_TO: gtk_window_set_attached_to (window, g_value_get_object (value)); break; case PROP_APPLICATION: gtk_window_set_application (window, g_value_get_object (value)); break; case PROP_DEFAULT_WIDGET: gtk_window_set_default_widget (window, g_value_get_object (value)); break; case PROP_MNEMONICS_VISIBLE: gtk_window_set_mnemonics_visible (window, g_value_get_boolean (value)); break; case PROP_FOCUS_VISIBLE: gtk_window_set_focus_visible (window, g_value_get_boolean (value)); break; case LAST_ARG + GTK_ROOT_PROP_FOCUS_WIDGET: gtk_window_set_focus (window, g_value_get_object (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_window_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkWindow *window = GTK_WINDOW (object); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); switch (prop_id) { GtkWindowGeometryInfo *info; case PROP_TYPE: g_value_set_enum (value, priv->type); break; case PROP_TITLE: g_value_set_string (value, priv->title); break; case PROP_RESIZABLE: g_value_set_boolean (value, priv->resizable); break; case PROP_MODAL: g_value_set_boolean (value, priv->modal); break; case PROP_DEFAULT_WIDTH: info = gtk_window_get_geometry_info (window, FALSE); if (!info) g_value_set_int (value, -1); else g_value_set_int (value, info->default_width); break; case PROP_DEFAULT_HEIGHT: info = gtk_window_get_geometry_info (window, FALSE); if (!info) g_value_set_int (value, -1); else g_value_set_int (value, info->default_height); break; case PROP_DESTROY_WITH_PARENT: g_value_set_boolean (value, priv->destroy_with_parent); break; case PROP_HIDE_ON_CLOSE: g_value_set_boolean (value, priv->hide_on_close); break; case PROP_ICON_NAME: g_value_set_string (value, gtk_window_get_icon_name (window)); break; case PROP_DISPLAY: g_value_set_object (value, priv->display); break; case PROP_IS_ACTIVE: g_value_set_boolean (value, priv->is_active); break; case PROP_TYPE_HINT: g_value_set_enum (value, priv->type_hint); break; case PROP_ACCEPT_FOCUS: g_value_set_boolean (value, gtk_window_get_accept_focus (window)); break; case PROP_FOCUS_ON_MAP: g_value_set_boolean (value, gtk_window_get_focus_on_map (window)); break; case PROP_DECORATED: g_value_set_boolean (value, gtk_window_get_decorated (window)); break; case PROP_DELETABLE: g_value_set_boolean (value, gtk_window_get_deletable (window)); break; case PROP_TRANSIENT_FOR: g_value_set_object (value, gtk_window_get_transient_for (window)); break; case PROP_ATTACHED_TO: g_value_set_object (value, gtk_window_get_attached_to (window)); break; case PROP_APPLICATION: g_value_set_object (value, gtk_window_get_application (window)); break; case PROP_DEFAULT_WIDGET: g_value_set_object (value, gtk_window_get_default_widget (window)); break; case PROP_MNEMONICS_VISIBLE: g_value_set_boolean (value, priv->mnemonics_visible); break; case PROP_FOCUS_VISIBLE: g_value_set_boolean (value, priv->focus_visible); break; case PROP_IS_MAXIMIZED: g_value_set_boolean (value, gtk_window_is_maximized (window)); break; case LAST_ARG + GTK_ROOT_PROP_FOCUS_WIDGET: g_value_set_object (value, gtk_window_get_focus (window)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_window_buildable_interface_init (GtkBuildableIface *iface) { parent_buildable_iface = g_type_interface_peek_parent (iface); iface->set_buildable_property = gtk_window_buildable_set_buildable_property; iface->parser_finished = gtk_window_buildable_parser_finished; iface->custom_tag_start = gtk_window_buildable_custom_tag_start; iface->custom_finished = gtk_window_buildable_custom_finished; iface->add_child = gtk_window_buildable_add_child; } static void gtk_window_buildable_add_child (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *type) { if (type && strcmp (type, "titlebar") == 0) gtk_window_set_titlebar (GTK_WINDOW (buildable), GTK_WIDGET (child)); else parent_buildable_iface->add_child (buildable, builder, child, type); } static void gtk_window_buildable_set_buildable_property (GtkBuildable *buildable, GtkBuilder *builder, const gchar *name, const GValue *value) { GtkWindow *window = GTK_WINDOW (buildable); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (strcmp (name, "visible") == 0 && g_value_get_boolean (value)) priv->builder_visible = TRUE; else if (parent_buildable_iface->set_buildable_property) parent_buildable_iface->set_buildable_property (buildable, builder, name, value); else g_object_set_property (G_OBJECT (buildable), name, value); } typedef struct { gchar *name; gint line; gint col; } ItemData; static void item_data_free (gpointer data) { ItemData *item_data = data; g_free (item_data->name); g_free (item_data); } static void item_list_free (gpointer data) { GSList *list = data; g_slist_free_full (list, item_data_free); } static void gtk_window_buildable_parser_finished (GtkBuildable *buildable, GtkBuilder *builder) { GtkWindow *window = GTK_WINDOW (buildable); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GObject *object; GSList *accels, *l; if (priv->builder_visible) gtk_widget_show (GTK_WIDGET (buildable)); accels = g_object_get_qdata (G_OBJECT (buildable), quark_gtk_buildable_accels); for (l = accels; l; l = l->next) { ItemData *data = l->data; object = _gtk_builder_lookup_object (builder, data->name, data->line, data->col); if (!object) continue; gtk_window_add_accel_group (GTK_WINDOW (buildable), GTK_ACCEL_GROUP (object)); } g_object_set_qdata (G_OBJECT (buildable), quark_gtk_buildable_accels, NULL); parent_buildable_iface->parser_finished (buildable, builder); } typedef struct { GObject *object; GtkBuilder *builder; GSList *items; } GSListSubParserData; static void window_start_element (GMarkupParseContext *context, const gchar *element_name, const gchar **names, const gchar **values, gpointer user_data, GError **error) { GSListSubParserData *data = (GSListSubParserData*)user_data; if (strcmp (element_name, "group") == 0) { const gchar *name; ItemData *item_data; if (!_gtk_builder_check_parent (data->builder, context, "accel-groups", error)) return; if (!g_markup_collect_attributes (element_name, names, values, error, G_MARKUP_COLLECT_STRING, "name", &name, G_MARKUP_COLLECT_INVALID)) { _gtk_builder_prefix_error (data->builder, context, error); return; } item_data = g_new (ItemData, 1); item_data->name = g_strdup (name); g_markup_parse_context_get_position (context, &item_data->line, &item_data->col); data->items = g_slist_prepend (data->items, item_data); } else if (strcmp (element_name, "accel-groups") == 0) { if (!_gtk_builder_check_parent (data->builder, context, "object", error)) return; if (!g_markup_collect_attributes (element_name, names, values, error, G_MARKUP_COLLECT_INVALID, NULL, NULL, G_MARKUP_COLLECT_INVALID)) _gtk_builder_prefix_error (data->builder, context, error); } else { _gtk_builder_error_unhandled_tag (data->builder, context, "GtkWindow", element_name, error); } } static const GMarkupParser window_parser = { window_start_element }; static gboolean gtk_window_buildable_custom_tag_start (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *tagname, GMarkupParser *parser, gpointer *parser_data) { if (parent_buildable_iface->custom_tag_start (buildable, builder, child, tagname, parser, parser_data)) return TRUE; if (strcmp (tagname, "accel-groups") == 0) { GSListSubParserData *data; data = g_slice_new0 (GSListSubParserData); data->items = NULL; data->object = G_OBJECT (buildable); data->builder = builder; *parser = window_parser; *parser_data = data; return TRUE; } return FALSE; } static void gtk_window_buildable_custom_finished (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *tagname, gpointer user_data) { parent_buildable_iface->custom_finished (buildable, builder, child, tagname, user_data); if (strcmp (tagname, "accel-groups") == 0) { GSListSubParserData *data = (GSListSubParserData*)user_data; g_object_set_qdata_full (G_OBJECT (buildable), quark_gtk_buildable_accels, data->items, (GDestroyNotify) item_list_free); g_slice_free (GSListSubParserData, data); } } static GdkDisplay * gtk_window_root_get_display (GtkRoot *root) { GtkWindow *window = GTK_WINDOW (root); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); return priv->display; } static GdkSurface * gtk_window_native_get_surface (GtkNative *native) { GtkWindow *self = GTK_WINDOW (native); GtkWindowPrivate *priv = gtk_window_get_instance_private (self); return priv->surface; } static GskRenderer * gtk_window_native_get_renderer (GtkNative *native) { GtkWindow *self = GTK_WINDOW (native); GtkWindowPrivate *priv = gtk_window_get_instance_private (self); return priv->renderer; } static GtkConstraintSolver * gtk_window_root_get_constraint_solver (GtkRoot *root) { GtkWindow *self = GTK_WINDOW (root); GtkWindowPrivate *priv = gtk_window_get_instance_private (self); return priv->constraint_solver; } static void gtk_window_native_get_surface_transform (GtkNative *native, int *x, int *y) { GtkWindow *self = GTK_WINDOW (native); GtkStyleContext *context; GtkBorder margin, border, padding; context = gtk_widget_get_style_context (GTK_WIDGET (self)); gtk_style_context_get_margin (context, &margin); gtk_style_context_get_border (context, &border); gtk_style_context_get_padding (context, &padding); *x = margin.left + border.left + padding.left; *y = margin.top + border.top + padding.top; } static void gtk_window_native_check_resize (GtkNative *native) { gtk_window_check_resize (GTK_WINDOW (native)); } static void gtk_window_root_interface_init (GtkRootInterface *iface) { iface->get_display = gtk_window_root_get_display; iface->get_constraint_solver = gtk_window_root_get_constraint_solver; } static void gtk_window_native_interface_init (GtkNativeInterface *iface) { iface->get_surface = gtk_window_native_get_surface; iface->get_renderer = gtk_window_native_get_renderer; iface->get_surface_transform = gtk_window_native_get_surface_transform; iface->check_resize = gtk_window_native_check_resize; } /** * gtk_window_new: * @type: type of window * * Creates a new #GtkWindow, which is a toplevel window that can * contain other widgets. Nearly always, the type of the window should * be #GTK_WINDOW_TOPLEVEL. If you’re implementing something like a * popup menu from scratch (which is a bad idea, just use #GtkMenu), * you might use #GTK_WINDOW_POPUP. #GTK_WINDOW_POPUP is not for * dialogs, though in some other toolkits dialogs are called “popups”. * In GTK+, #GTK_WINDOW_POPUP means a pop-up menu or pop-up tooltip. * On X11, popup windows are not controlled by the * [window manager][gtk-X11-arch]. * * If you simply want an undecorated window (no window borders), use * gtk_window_set_decorated(), don’t use #GTK_WINDOW_POPUP. * * All top-level windows created by gtk_window_new() are stored in * an internal top-level window list. This list can be obtained from * gtk_window_list_toplevels(). Due to Gtk+ keeping a reference to * the window internally, gtk_window_new() does not return a reference * to the caller. * * To delete a #GtkWindow, call gtk_widget_destroy(). * * Returns: a new #GtkWindow. **/ GtkWidget* gtk_window_new (GtkWindowType type) { GtkWindow *window; g_return_val_if_fail (type >= GTK_WINDOW_TOPLEVEL && type <= GTK_WINDOW_POPUP, NULL); window = g_object_new (GTK_TYPE_WINDOW, "type", type, NULL); return GTK_WIDGET (window); } static void gtk_window_set_title_internal (GtkWindow *window, const gchar *title, gboolean update_titlebar) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); char *new_title; g_return_if_fail (GTK_IS_WINDOW (window)); new_title = g_strdup (title); g_free (priv->title); priv->title = new_title; if (_gtk_widget_get_realized (GTK_WIDGET (window))) gdk_surface_set_title (priv->surface, new_title != NULL ? new_title : ""); if (update_titlebar && GTK_IS_HEADER_BAR (priv->title_box)) gtk_header_bar_set_title (GTK_HEADER_BAR (priv->title_box), new_title != NULL ? new_title : ""); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_TITLE]); } /** * gtk_window_set_title: * @window: a #GtkWindow * @title: title of the window * * Sets the title of the #GtkWindow. The title of a window will be * displayed in its title bar; on the X Window System, the title bar * is rendered by the [window manager][gtk-X11-arch], * so exactly how the title appears to users may vary * according to a user’s exact configuration. The title should help a * user distinguish this window from other windows they may have * open. A good title might include the application name and current * document filename, for example. * **/ void gtk_window_set_title (GtkWindow *window, const gchar *title) { g_return_if_fail (GTK_IS_WINDOW (window)); gtk_window_set_title_internal (window, title, TRUE); } /** * gtk_window_get_title: * @window: a #GtkWindow * * Retrieves the title of the window. See gtk_window_set_title(). * * Returns: (nullable): the title of the window, or %NULL if none has * been set explicitly. The returned string is owned by the widget * and must not be modified or freed. **/ const gchar * gtk_window_get_title (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); return priv->title; } /** * gtk_window_set_startup_id: * @window: a #GtkWindow * @startup_id: a string with startup-notification identifier * * Startup notification identifiers are used by desktop environment to * track application startup, to provide user feedback and other * features. This function changes the corresponding property on the * underlying GdkSurface. Normally, startup identifier is managed * automatically and you should only use this function in special cases * like transferring focus from other processes. You should use this * function before calling gtk_window_present() or any equivalent * function generating a window map event. * * This function is only useful on X11, not with other GTK+ targets. **/ void gtk_window_set_startup_id (GtkWindow *window, const gchar *startup_id) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; g_return_if_fail (GTK_IS_WINDOW (window)); widget = GTK_WIDGET (window); g_free (priv->startup_id); priv->startup_id = g_strdup (startup_id); if (_gtk_widget_get_realized (widget)) { guint32 timestamp = extract_time_from_startup_id (priv->startup_id); #ifdef GDK_WINDOWING_X11 if (timestamp != GDK_CURRENT_TIME && GDK_IS_X11_SURFACE (priv->surface)) gdk_x11_surface_set_user_time (priv->surface, timestamp); #endif /* Here we differentiate real and "fake" startup notification IDs, * constructed on purpose just to pass interaction timestamp */ if (startup_id_is_fake (priv->startup_id)) gtk_window_present_with_time (window, timestamp); else { gdk_surface_set_startup_id (priv->surface, priv->startup_id); /* If window is mapped, terminate the startup-notification too */ if (_gtk_widget_get_mapped (widget) && !disable_startup_notification) gdk_display_notify_startup_complete (gtk_widget_get_display (widget), priv->startup_id); } } g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_STARTUP_ID]); } /** * gtk_window_set_default_widget: * @window: a #GtkWindow * @default_widget: (allow-none): widget to be the default, or %NULL * to unset the default widget for the toplevel * * The default widget is the widget that’s activated when the user * presses Enter in a dialog (for example). This function sets or * unsets the default widget for a #GtkWindow. */ void gtk_window_set_default_widget (GtkWindow *window, GtkWidget *default_widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->default_widget != default_widget) { GtkWidget *old_default_widget = NULL; if (default_widget) g_object_ref (default_widget); if (priv->default_widget) { old_default_widget = priv->default_widget; if (priv->focus_widget != priv->default_widget || !gtk_widget_get_receives_default (priv->default_widget)) _gtk_widget_set_has_default (priv->default_widget, FALSE); gtk_widget_queue_draw (priv->default_widget); } priv->default_widget = default_widget; if (priv->default_widget) { if (priv->focus_widget == NULL || !gtk_widget_get_receives_default (priv->focus_widget)) _gtk_widget_set_has_default (priv->default_widget, TRUE); gtk_widget_queue_draw (priv->default_widget); } if (old_default_widget) g_object_notify (G_OBJECT (old_default_widget), "has-default"); if (default_widget) { g_object_notify (G_OBJECT (default_widget), "has-default"); g_object_unref (default_widget); } g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DEFAULT_WIDGET]); } } /** * gtk_window_get_default_widget: * @window: a #GtkWindow * * Returns the default widget for @window. See * gtk_window_set_default() for more details. * * Returns: (nullable) (transfer none): the default widget, or %NULL * if there is none. **/ GtkWidget * gtk_window_get_default_widget (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); return priv->default_widget; } static gboolean handle_keys_changed (gpointer data) { GtkWindow *window = GTK_WINDOW (data); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->keys_changed_handler) { g_source_remove (priv->keys_changed_handler); priv->keys_changed_handler = 0; } g_signal_emit (window, window_signals[KEYS_CHANGED], 0); return FALSE; } void _gtk_window_notify_keys_changed (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (!priv->keys_changed_handler) { priv->keys_changed_handler = g_idle_add (handle_keys_changed, window); g_source_set_name_by_id (priv->keys_changed_handler, "[gtk] handle_keys_changed"); } } /** * gtk_window_add_accel_group: * @window: window to attach accelerator group to * @accel_group: a #GtkAccelGroup * * Associate @accel_group with @window, such that calling * gtk_accel_groups_activate() on @window will activate accelerators * in @accel_group. **/ void gtk_window_add_accel_group (GtkWindow *window, GtkAccelGroup *accel_group) { g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_ACCEL_GROUP (accel_group)); _gtk_accel_group_attach (accel_group, G_OBJECT (window)); g_signal_connect_object (accel_group, "accel-changed", G_CALLBACK (_gtk_window_notify_keys_changed), window, G_CONNECT_SWAPPED); _gtk_window_notify_keys_changed (window); } /** * gtk_window_remove_accel_group: * @window: a #GtkWindow * @accel_group: a #GtkAccelGroup * * Reverses the effects of gtk_window_add_accel_group(). **/ void gtk_window_remove_accel_group (GtkWindow *window, GtkAccelGroup *accel_group) { g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_ACCEL_GROUP (accel_group)); g_signal_handlers_disconnect_by_func (accel_group, _gtk_window_notify_keys_changed, window); _gtk_accel_group_detach (accel_group, G_OBJECT (window)); _gtk_window_notify_keys_changed (window); } static GtkMnemonicHash * gtk_window_get_mnemonic_hash (GtkWindow *window, gboolean create) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (!priv->mnemonic_hash && create) priv->mnemonic_hash = _gtk_mnemonic_hash_new (); return priv->mnemonic_hash; } /** * gtk_window_add_mnemonic: * @window: a #GtkWindow * @keyval: the mnemonic * @target: the widget that gets activated by the mnemonic * * Adds a mnemonic to this window. */ void gtk_window_add_mnemonic (GtkWindow *window, guint keyval, GtkWidget *target) { g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (target)); _gtk_mnemonic_hash_add (gtk_window_get_mnemonic_hash (window, TRUE), keyval, target); _gtk_window_notify_keys_changed (window); } /** * gtk_window_remove_mnemonic: * @window: a #GtkWindow * @keyval: the mnemonic * @target: the widget that gets activated by the mnemonic * * Removes a mnemonic from this window. */ void gtk_window_remove_mnemonic (GtkWindow *window, guint keyval, GtkWidget *target) { g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (target)); _gtk_mnemonic_hash_remove (gtk_window_get_mnemonic_hash (window, TRUE), keyval, target); _gtk_window_notify_keys_changed (window); } /** * gtk_window_mnemonic_activate: * @window: a #GtkWindow * @keyval: the mnemonic * @modifier: the modifiers * * Activates the targets associated with the mnemonic. * * Returns: %TRUE if the activation is done. */ gboolean gtk_window_mnemonic_activate (GtkWindow *window, guint keyval, GdkModifierType modifier) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); if (priv->mnemonic_modifier == (modifier & gtk_accelerator_get_default_mod_mask ())) { GtkMnemonicHash *mnemonic_hash = gtk_window_get_mnemonic_hash (window, FALSE); if (mnemonic_hash) return _gtk_mnemonic_hash_activate (mnemonic_hash, keyval); } return FALSE; } /** * gtk_window_set_mnemonic_modifier: * @window: a #GtkWindow * @modifier: the modifier mask used to activate * mnemonics on this window. * * Sets the mnemonic modifier for this window. **/ void gtk_window_set_mnemonic_modifier (GtkWindow *window, GdkModifierType modifier) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail ((modifier & ~GDK_MODIFIER_MASK) == 0); priv->mnemonic_modifier = modifier; _gtk_window_notify_keys_changed (window); } /** * gtk_window_get_mnemonic_modifier: * @window: a #GtkWindow * * Returns the mnemonic modifier for this window. See * gtk_window_set_mnemonic_modifier(). * * Returns: the modifier mask used to activate * mnemonics on this window. **/ GdkModifierType gtk_window_get_mnemonic_modifier (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), 0); return priv->mnemonic_modifier; } /** * gtk_window_get_focus: * @window: a #GtkWindow * * Retrieves the current focused widget within the window. * Note that this is the widget that would have the focus * if the toplevel window focused; if the toplevel window * is not focused then `gtk_widget_has_focus (widget)` will * not be %TRUE for the widget. * * Returns: (nullable) (transfer none): the currently focused widget, * or %NULL if there is none. **/ GtkWidget * gtk_window_get_focus (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); if (priv->initial_focus) return priv->initial_focus; else return priv->focus_widget; } static void gtk_window_real_activate_default (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->default_widget && gtk_widget_is_sensitive (priv->default_widget) && (!priv->focus_widget || !gtk_widget_get_receives_default (priv->focus_widget))) gtk_widget_activate (priv->default_widget); else if (priv->focus_widget && gtk_widget_is_sensitive (priv->focus_widget)) gtk_widget_activate (priv->focus_widget); } /** * gtk_window_set_modal: * @window: a #GtkWindow * @modal: whether the window is modal * * Sets a window modal or non-modal. Modal windows prevent interaction * with other windows in the same application. To keep modal dialogs * on top of main application windows, use * gtk_window_set_transient_for() to make the dialog transient for the * parent; most [window managers][gtk-X11-arch] * will then disallow lowering the dialog below the parent. * * **/ void gtk_window_set_modal (GtkWindow *window, gboolean modal) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; g_return_if_fail (GTK_IS_WINDOW (window)); modal = modal != FALSE; if (priv->modal == modal) return; priv->modal = modal; widget = GTK_WIDGET (window); /* adjust desired modality state */ if (_gtk_widget_get_realized (widget)) gdk_surface_set_modal_hint (priv->surface, priv->modal); if (gtk_widget_get_visible (widget)) { if (priv->modal) gtk_grab_add (widget); else gtk_grab_remove (widget); } update_window_buttons (window); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_MODAL]); } /** * gtk_window_get_modal: * @window: a #GtkWindow * * Returns whether the window is modal. See gtk_window_set_modal(). * * Returns: %TRUE if the window is set to be modal and * establishes a grab when shown **/ gboolean gtk_window_get_modal (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->modal; } /** * gtk_window_get_toplevels: * * Returns a list of all existing toplevel windows. * * If you want to iterate through the list and perform actions involving * callbacks that might destroy the widgets or add new ones, be aware that * the list of toplevels will change and emit the "items-changed" signal. * * Returns: (element-type GtkWidget) (transfer none): the list of toplevel widgets */ GListModel * gtk_window_get_toplevels (void) { if (toplevel_list == NULL) toplevel_list = g_list_store_new (GTK_TYPE_WIDGET); return G_LIST_MODEL (toplevel_list); } /** * gtk_window_list_toplevels: * * Returns a list of all existing toplevel windows. The widgets * in the list are not individually referenced. If you want * to iterate through the list and perform actions involving * callbacks that might destroy the widgets, you must call * `g_list_foreach (result, (GFunc)g_object_ref, NULL)` first, and * then unref all the widgets afterwards. * * Returns: (element-type GtkWidget) (transfer container): list of toplevel widgets **/ GList* gtk_window_list_toplevels (void) { GListModel *toplevels; GList *list = NULL; guint i; toplevels = gtk_window_get_toplevels (); for (i = 0; i < g_list_model_get_n_items (toplevels); i++) { gpointer item = g_list_model_get_item (toplevels, i); list = g_list_prepend (list, item); g_object_unref (item); } return list; } static void remove_attach_widget (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->attach_widget) { _gtk_widget_remove_attached_window (priv->attach_widget, window); priv->attach_widget = NULL; } } static void gtk_window_dispose (GObject *object) { GtkWindow *window = GTK_WINDOW (object); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_list_free_full (priv->foci, (GDestroyNotify) gtk_pointer_focus_unref); priv->foci = NULL; gtk_window_set_focus (window, NULL); gtk_window_set_default_widget (window, NULL); remove_attach_widget (window); G_OBJECT_CLASS (gtk_window_parent_class)->dispose (object); unset_titlebar (window); while (!g_queue_is_empty (&priv->popovers)) { GtkWindowPopover *popover = g_queue_pop_head (&priv->popovers); popover_destroy (popover); } } static void parent_destroyed_callback (GtkWindow *parent, GtkWindow *child) { gtk_widget_destroy (GTK_WIDGET (child)); } static void connect_parent_destroyed (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->transient_parent) { g_signal_connect (priv->transient_parent, "destroy", G_CALLBACK (parent_destroyed_callback), window); } } static void disconnect_parent_destroyed (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->transient_parent) { g_signal_handlers_disconnect_by_func (priv->transient_parent, parent_destroyed_callback, window); } } static void gtk_window_transient_parent_realized (GtkWidget *parent, GtkWidget *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (GTK_WINDOW (window)); GtkWindowPrivate *parent_priv = gtk_window_get_instance_private (GTK_WINDOW (parent)); if (_gtk_widget_get_realized (window)) gdk_surface_set_transient_for (priv->surface, parent_priv->surface); } static void gtk_window_transient_parent_unrealized (GtkWidget *parent, GtkWidget *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (GTK_WINDOW (window)); if (_gtk_widget_get_realized (window)) gdk_surface_set_transient_for (priv->surface, NULL); } static void gtk_window_transient_parent_display_changed (GtkWindow *parent, GParamSpec *pspec, GtkWindow *window) { GtkWindowPrivate *parent_priv = gtk_window_get_instance_private (parent); gtk_window_set_display (window, parent_priv->display); } static void gtk_window_unset_transient_for (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->transient_parent) { g_signal_handlers_disconnect_by_func (priv->transient_parent, gtk_window_transient_parent_realized, window); g_signal_handlers_disconnect_by_func (priv->transient_parent, gtk_window_transient_parent_unrealized, window); g_signal_handlers_disconnect_by_func (priv->transient_parent, gtk_window_transient_parent_display_changed, window); g_signal_handlers_disconnect_by_func (priv->transient_parent, gtk_widget_destroyed, &priv->transient_parent); if (priv->destroy_with_parent) disconnect_parent_destroyed (window); priv->transient_parent = NULL; if (priv->transient_parent_group) { priv->transient_parent_group = FALSE; gtk_window_group_remove_window (priv->group, window); } } } /** * gtk_window_set_transient_for: * @window: a #GtkWindow * @parent: (allow-none): parent window, or %NULL * * Dialog windows should be set transient for the main application * window they were spawned from. This allows * [window managers][gtk-X11-arch] to e.g. keep the * dialog on top of the main window, or center the dialog over the * main window. gtk_dialog_new_with_buttons() and other convenience * functions in GTK+ will sometimes call * gtk_window_set_transient_for() on your behalf. * * Passing %NULL for @parent unsets the current transient window. * * This function can also be used to attach a new * #GTK_WINDOW_POPUP to a #GTK_WINDOW_TOPLEVEL parent already mapped * on screen so that the #GTK_WINDOW_POPUP will be * positioned relative to the #GTK_WINDOW_TOPLEVEL surface. * * On Windows, this function puts the child window on top of the parent, * much as the window manager would have done on X. */ void gtk_window_set_transient_for (GtkWindow *window, GtkWindow *parent) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (parent == NULL || GTK_IS_WINDOW (parent)); g_return_if_fail (window != parent); if (priv->transient_parent) { if (_gtk_widget_get_realized (GTK_WIDGET (window)) && _gtk_widget_get_realized (GTK_WIDGET (priv->transient_parent)) && (!parent || !_gtk_widget_get_realized (GTK_WIDGET (parent)))) gtk_window_transient_parent_unrealized (GTK_WIDGET (priv->transient_parent), GTK_WIDGET (window)); gtk_window_unset_transient_for (window); } priv->transient_parent = parent; if (parent) { GtkWindowPrivate *parent_priv = gtk_window_get_instance_private (parent); g_signal_connect (parent, "destroy", G_CALLBACK (gtk_widget_destroyed), &priv->transient_parent); g_signal_connect (parent, "realize", G_CALLBACK (gtk_window_transient_parent_realized), window); g_signal_connect (parent, "unrealize", G_CALLBACK (gtk_window_transient_parent_unrealized), window); g_signal_connect (parent, "notify::display", G_CALLBACK (gtk_window_transient_parent_display_changed), window); gtk_window_set_display (window, parent_priv->display); if (priv->destroy_with_parent) connect_parent_destroyed (window); if (_gtk_widget_get_realized (GTK_WIDGET (window)) && _gtk_widget_get_realized (GTK_WIDGET (parent))) gtk_window_transient_parent_realized (GTK_WIDGET (parent), GTK_WIDGET (window)); if (parent_priv->group) { gtk_window_group_add_window (parent_priv->group, window); priv->transient_parent_group = TRUE; } } update_window_buttons (window); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_TRANSIENT_FOR]); } /** * gtk_window_get_transient_for: * @window: a #GtkWindow * * Fetches the transient parent for this window. See * gtk_window_set_transient_for(). * * Returns: (nullable) (transfer none): the transient parent for this * window, or %NULL if no transient parent has been set. **/ GtkWindow * gtk_window_get_transient_for (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); return priv->transient_parent; } /** * gtk_window_set_attached_to: * @window: a #GtkWindow * @attach_widget: (allow-none): a #GtkWidget, or %NULL * * Marks @window as attached to @attach_widget. This creates a logical binding * between the window and the widget it belongs to, which is used by GTK+ to * propagate information such as styling or accessibility to @window as if it * was a children of @attach_widget. * * Examples of places where specifying this relation is useful are for instance * a #GtkMenu created by a #GtkComboBox, a completion popup window * created by #GtkEntry or a typeahead search entry created by #GtkTreeView. * * Note that this function should not be confused with * gtk_window_set_transient_for(), which specifies a window manager relation * between two toplevels instead. * * Passing %NULL for @attach_widget detaches the window. **/ void gtk_window_set_attached_to (GtkWindow *window, GtkWidget *attach_widget) { GtkStyleContext *context; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_WIDGET (window) != attach_widget); if (priv->attach_widget == attach_widget) return; remove_attach_widget (window); priv->attach_widget = attach_widget; if (priv->attach_widget) { _gtk_widget_add_attached_window (priv->attach_widget, window); } /* Update the style, as the widget path might change. */ context = gtk_widget_get_style_context (GTK_WIDGET (window)); if (priv->attach_widget) gtk_style_context_set_parent (context, gtk_widget_get_style_context (priv->attach_widget)); else gtk_style_context_set_parent (context, NULL); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_ATTACHED_TO]); } /** * gtk_window_get_attached_to: * @window: a #GtkWindow * * Fetches the attach widget for this window. See * gtk_window_set_attached_to(). * * Returns: (nullable) (transfer none): the widget where the window * is attached, or %NULL if the window is not attached to any widget. **/ GtkWidget * gtk_window_get_attached_to (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); return priv->attach_widget; } /** * gtk_window_get_application: * @window: a #GtkWindow * * Gets the #GtkApplication associated with the window (if any). * * Returns: (nullable) (transfer none): a #GtkApplication, or %NULL **/ GtkApplication * gtk_window_get_application (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); return priv->application; } static void gtk_window_release_application (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->application) { GtkApplication *application; /* steal reference into temp variable */ application = priv->application; priv->application = NULL; gtk_application_remove_window (application, window); g_object_unref (application); } } /** * gtk_window_set_application: * @window: a #GtkWindow * @application: (allow-none): a #GtkApplication, or %NULL to unset * * Sets or unsets the #GtkApplication associated with the window. * * The application will be kept alive for at least as long as it has any windows * associated with it (see g_application_hold() for a way to keep it alive * without windows). * * Normally, the connection between the application and the window will remain * until the window is destroyed, but you can explicitly remove it by setting * the @application to %NULL. * * This is equivalent to calling gtk_application_remove_window() and/or * gtk_application_add_window() on the old/new applications as relevant. **/ void gtk_window_set_application (GtkWindow *window, GtkApplication *application) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->application != application) { gtk_window_release_application (window); priv->application = application; if (priv->application != NULL) { g_object_ref (priv->application); gtk_application_add_window (priv->application, window); } _gtk_widget_update_parent_muxer (GTK_WIDGET (window)); _gtk_window_notify_keys_changed (window); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_APPLICATION]); } } /** * gtk_window_set_type_hint: * @window: a #GtkWindow * @hint: the window type * * By setting the type hint for the window, you allow the window * manager to decorate and handle the window in a way which is * suitable to the function of the window in your application. * * This function should be called before the window becomes visible. * * gtk_dialog_new_with_buttons() and other convenience functions in GTK+ * will sometimes call gtk_window_set_type_hint() on your behalf. **/ void gtk_window_set_type_hint (GtkWindow *window, GdkSurfaceTypeHint hint) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->type_hint == hint) return; priv->type_hint = hint; if (priv->surface) gdk_surface_set_type_hint (priv->surface, hint); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_TYPE_HINT]); update_window_buttons (window); } /** * gtk_window_get_type_hint: * @window: a #GtkWindow * * Gets the type hint for this window. See gtk_window_set_type_hint(). * * Returns: the type hint for @window. **/ GdkSurfaceTypeHint gtk_window_get_type_hint (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), GDK_SURFACE_TYPE_HINT_NORMAL); return priv->type_hint; } /** * gtk_window_set_accept_focus: * @window: a #GtkWindow * @setting: %TRUE to let this window receive input focus * * Windows may set a hint asking the desktop environment not to receive * the input focus. This function sets this hint. **/ void gtk_window_set_accept_focus (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (priv->accept_focus != setting) { priv->accept_focus = setting; if (_gtk_widget_get_realized (GTK_WIDGET (window))) gdk_surface_set_accept_focus (priv->surface, priv->accept_focus); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_ACCEPT_FOCUS]); } } /** * gtk_window_get_accept_focus: * @window: a #GtkWindow * * Gets the value set by gtk_window_set_accept_focus(). * * Returns: %TRUE if window should receive the input focus **/ gboolean gtk_window_get_accept_focus (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->accept_focus; } /** * gtk_window_set_focus_on_map: * @window: a #GtkWindow * @setting: %TRUE to let this window receive input focus on map * * Windows may set a hint asking the desktop environment not to receive * the input focus when the window is mapped. This function sets this * hint. **/ void gtk_window_set_focus_on_map (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (priv->focus_on_map != setting) { priv->focus_on_map = setting; if (_gtk_widget_get_realized (GTK_WIDGET (window))) gdk_surface_set_focus_on_map (priv->surface, priv->focus_on_map); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_FOCUS_ON_MAP]); } } /** * gtk_window_get_focus_on_map: * @window: a #GtkWindow * * Gets the value set by gtk_window_set_focus_on_map(). * * Returns: %TRUE if window should receive the input focus when * mapped. **/ gboolean gtk_window_get_focus_on_map (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->focus_on_map; } /** * gtk_window_set_destroy_with_parent: * @window: a #GtkWindow * @setting: whether to destroy @window with its transient parent * * If @setting is %TRUE, then destroying the transient parent of @window * will also destroy @window itself. This is useful for dialogs that * shouldn’t persist beyond the lifetime of the main window they're * associated with, for example. **/ void gtk_window_set_destroy_with_parent (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->destroy_with_parent == (setting != FALSE)) return; if (priv->destroy_with_parent) { disconnect_parent_destroyed (window); } else { connect_parent_destroyed (window); } priv->destroy_with_parent = setting; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DESTROY_WITH_PARENT]); } /** * gtk_window_get_destroy_with_parent: * @window: a #GtkWindow * * Returns whether the window will be destroyed with its transient parent. See * gtk_window_set_destroy_with_parent (). * * Returns: %TRUE if the window will be destroyed with its transient parent. **/ gboolean gtk_window_get_destroy_with_parent (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->destroy_with_parent; } /** * gtk_window_set_hide_on_close: * @window: a #GtkWindow * @setting: whether to hide the window when it is closed * * If @setting is %TRUE, then clicking the close button on the window * will not destroy it, but only hide it. */ void gtk_window_set_hide_on_close (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->hide_on_close == setting) return; priv->hide_on_close = setting; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_HIDE_ON_CLOSE]); } /** * gtk_window_get_hide_on_close: * @window: a #GtkWindow * * Returns whether the window will be hidden when the close button is clicked. * * Returns: %TRUE if the window will be hidden */ gboolean gtk_window_get_hide_on_close (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->hide_on_close; } static GtkWindowGeometryInfo* gtk_window_get_geometry_info (GtkWindow *window, gboolean create) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowGeometryInfo *info; info = priv->geometry_info; if (!info && create) { info = g_new0 (GtkWindowGeometryInfo, 1); info->default_width = -1; info->default_height = -1; info->resize_width = -1; info->resize_height = -1; info->last.configure_request.x = 0; info->last.configure_request.y = 0; info->last.configure_request.width = -1; info->last.configure_request.height = -1; priv->geometry_info = info; } return info; } static void unset_titlebar (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->title_box != NULL) { g_signal_handlers_disconnect_by_func (priv->title_box, on_titlebar_title_notify, window); gtk_widget_unparent (priv->title_box); priv->title_box = NULL; priv->titlebar = NULL; } } static gboolean gtk_window_supports_client_shadow (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GdkDisplay *display; display = priv->display; if (!gdk_display_is_rgba (display)) return FALSE; if (!gdk_display_is_composited (display)) return FALSE; #ifdef GDK_WINDOWING_X11 if (GDK_IS_X11_DISPLAY (display)) { if (!gdk_x11_screen_supports_net_wm_hint (gdk_x11_display_get_screen (display), g_intern_static_string ("_GTK_FRAME_EXTENTS"))) return FALSE; } #endif return TRUE; } static void gtk_window_enable_csd (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget = GTK_WIDGET (window); /* We need a visual with alpha for client shadows */ if (priv->use_client_shadow) { gtk_style_context_add_class (gtk_widget_get_style_context (widget), GTK_STYLE_CLASS_CSD); } else { gtk_style_context_add_class (gtk_widget_get_style_context (widget), "solid-csd"); } priv->client_decorated = TRUE; } static void on_titlebar_title_notify (GtkHeaderBar *titlebar, GParamSpec *pspec, GtkWindow *self) { const gchar *title; title = gtk_header_bar_get_title (titlebar); gtk_window_set_title_internal (self, title, FALSE); } /** * gtk_window_set_titlebar: * @window: a #GtkWindow * @titlebar: (allow-none): the widget to use as titlebar * * Sets a custom titlebar for @window. * * A typical widget used here is #GtkHeaderBar, as it provides various features * expected of a titlebar while allowing the addition of child widgets to it. * * If you set a custom titlebar, GTK+ will do its best to convince * the window manager not to put its own titlebar on the window. * Depending on the system, this function may not work for a window * that is already visible, so you set the titlebar before calling * gtk_widget_show(). */ void gtk_window_set_titlebar (GtkWindow *window, GtkWidget *titlebar) { GtkWidget *widget = GTK_WIDGET (window); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gboolean was_mapped; g_return_if_fail (GTK_IS_WINDOW (window)); if ((!priv->title_box && titlebar) || (priv->title_box && !titlebar)) { was_mapped = _gtk_widget_get_mapped (widget); if (_gtk_widget_get_realized (widget)) { g_warning ("gtk_window_set_titlebar() called on a realized window"); gtk_widget_unrealize (widget); } } else was_mapped = FALSE; unset_titlebar (window); if (titlebar == NULL) { priv->client_decorated = FALSE; gtk_style_context_remove_class (gtk_widget_get_style_context (widget), GTK_STYLE_CLASS_CSD); goto out; } priv->use_client_shadow = gtk_window_supports_client_shadow (window); gtk_window_enable_csd (window); priv->title_box = titlebar; /* Same reason as in gtk_window_add */ gtk_css_node_insert_before (gtk_widget_get_css_node (GTK_WIDGET (window)), gtk_widget_get_css_node (titlebar), NULL); gtk_widget_set_parent (priv->title_box, widget); if (GTK_IS_HEADER_BAR (titlebar)) { g_signal_connect (titlebar, "notify::title", G_CALLBACK (on_titlebar_title_notify), window); on_titlebar_title_notify (GTK_HEADER_BAR (titlebar), NULL, window); } gtk_style_context_add_class (gtk_widget_get_style_context (titlebar), GTK_STYLE_CLASS_TITLEBAR); out: if (was_mapped) gtk_widget_map (widget); } /** * gtk_window_get_titlebar: * @window: a #GtkWindow * * Returns the custom titlebar that has been set with * gtk_window_set_titlebar(). * * Returns: (nullable) (transfer none): the custom titlebar, or %NULL */ GtkWidget * gtk_window_get_titlebar (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); /* Don't return the internal titlebar */ if (priv->title_box == priv->titlebar) return NULL; return priv->title_box; } gboolean _gtk_window_titlebar_shows_app_menu (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (GTK_IS_HEADER_BAR (priv->title_box)) return _gtk_header_bar_shows_app_menu (GTK_HEADER_BAR (priv->title_box)); return FALSE; } /** * gtk_window_set_decorated: * @window: a #GtkWindow * @setting: %TRUE to decorate the window * * By default, windows are decorated with a title bar, resize * controls, etc. Some [window managers][gtk-X11-arch] * allow GTK+ to disable these decorations, creating a * borderless window. If you set the decorated property to %FALSE * using this function, GTK+ will do its best to convince the window * manager not to decorate the window. Depending on the system, this * function may not have any effect when called on a window that is * already visible, so you should call it before calling gtk_widget_show(). * * On Windows, this function always works, since there’s no window manager * policy involved. * **/ void gtk_window_set_decorated (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (setting == priv->decorated) return; priv->decorated = setting; if (priv->surface) { if (priv->decorated) { if (priv->client_decorated) gdk_surface_set_decorations (priv->surface, 0); else gdk_surface_set_decorations (priv->surface, GDK_DECOR_ALL); } else gdk_surface_set_decorations (priv->surface, 0); } update_window_buttons (window); gtk_widget_queue_resize (GTK_WIDGET (window)); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DECORATED]); } /** * gtk_window_get_decorated: * @window: a #GtkWindow * * Returns whether the window has been set to have decorations * such as a title bar via gtk_window_set_decorated(). * * Returns: %TRUE if the window has been set to have decorations **/ gboolean gtk_window_get_decorated (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), TRUE); return priv->decorated; } /** * gtk_window_set_deletable: * @window: a #GtkWindow * @setting: %TRUE to decorate the window as deletable * * By default, windows have a close button in the window frame. Some * [window managers][gtk-X11-arch] allow GTK+ to * disable this button. If you set the deletable property to %FALSE * using this function, GTK+ will do its best to convince the window * manager not to show a close button. Depending on the system, this * function may not have any effect when called on a window that is * already visible, so you should call it before calling gtk_widget_show(). * * On Windows, this function always works, since there’s no window manager * policy involved. */ void gtk_window_set_deletable (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (setting == priv->deletable) return; priv->deletable = setting; if (priv->surface) { if (priv->deletable) gdk_surface_set_functions (priv->surface, GDK_FUNC_ALL); else gdk_surface_set_functions (priv->surface, GDK_FUNC_ALL | GDK_FUNC_CLOSE); } update_window_buttons (window); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DELETABLE]); } /** * gtk_window_get_deletable: * @window: a #GtkWindow * * Returns whether the window has been set to have a close button * via gtk_window_set_deletable(). * * Returns: %TRUE if the window has been set to have a close button **/ gboolean gtk_window_get_deletable (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), TRUE); return priv->deletable; } static GtkWindowIconInfo* get_icon_info (GtkWindow *window) { return g_object_get_qdata (G_OBJECT (window), quark_gtk_window_icon_info); } static void free_icon_info (GtkWindowIconInfo *info) { g_free (info->icon_name); g_slice_free (GtkWindowIconInfo, info); } static GtkWindowIconInfo* ensure_icon_info (GtkWindow *window) { GtkWindowIconInfo *info; info = get_icon_info (window); if (info == NULL) { info = g_slice_new0 (GtkWindowIconInfo); g_object_set_qdata_full (G_OBJECT (window), quark_gtk_window_icon_info, info, (GDestroyNotify)free_icon_info); } return info; } static GList * icon_list_from_theme (GtkWindow *window, const gchar *name) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *list; GtkStyleContext *context; GtkCssValue *value; GtkIconTheme *icon_theme; GtkIconInfo *info; gint *sizes; gint i; context = gtk_widget_get_style_context (GTK_WIDGET (window)); value = _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_ICON_THEME); icon_theme = gtk_css_icon_theme_value_get_icon_theme (value); sizes = gtk_icon_theme_get_icon_sizes (icon_theme, name); list = NULL; for (i = 0; sizes[i]; i++) { /* FIXME * We need an EWMH extension to handle scalable icons * by passing their name to the WM. For now just use a * fixed size of 48. */ if (sizes[i] == -1) info = gtk_icon_theme_lookup_icon_for_scale (icon_theme, name, 48, priv->scale, 0); else info = gtk_icon_theme_lookup_icon_for_scale (icon_theme, name, sizes[i], priv->scale, 0); if (info) { list = g_list_append (list, gtk_icon_info_load_texture (info)); g_object_unref (info); } } g_free (sizes); return list; } static void gtk_window_realize_icon (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowIconInfo *info; GList *icon_list = NULL; g_return_if_fail (priv->surface != NULL); /* no point setting an icon on override-redirect */ if (priv->type == GTK_WINDOW_POPUP) return; info = ensure_icon_info (window); if (info->realized) return; info->using_default_icon = FALSE; info->using_themed_icon = FALSE; /* Look up themed icon */ if (icon_list == NULL && info->icon_name) { icon_list = icon_list_from_theme (window, info->icon_name); if (icon_list) info->using_themed_icon = TRUE; } /* Look up themed icon */ if (icon_list == NULL && default_icon_name) { icon_list = icon_list_from_theme (window, default_icon_name); info->using_default_icon = TRUE; info->using_themed_icon = TRUE; } info->realized = TRUE; gdk_surface_set_icon_list (priv->surface, icon_list); if (GTK_IS_HEADER_BAR (priv->title_box)) _gtk_header_bar_update_window_icon (GTK_HEADER_BAR (priv->title_box), window); if (info->using_themed_icon) g_list_free_full (icon_list, g_object_unref); } GdkTexture * gtk_window_get_icon_for_size (GtkWindow *window, int size) { const char *name; GtkIconInfo *info; GdkTexture *texture; name = gtk_window_get_icon_name (window); if (!name) name = default_icon_name; if (!name) return NULL; info = gtk_icon_theme_lookup_icon (gtk_icon_theme_get_default (), name, size, GTK_ICON_LOOKUP_FORCE_SIZE); if (info == NULL) return NULL; texture = gtk_icon_info_load_texture (info); g_object_unref (info); return texture; } static void gtk_window_unrealize_icon (GtkWindow *window) { GtkWindowIconInfo *info; info = get_icon_info (window); if (info == NULL) return; /* We don't clear the properties on the window, just figure the * window is going away. */ info->realized = FALSE; } static void update_themed_icon (GtkWindow *window) { g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_ICON_NAME]); gtk_window_unrealize_icon (window); if (_gtk_widget_get_realized (GTK_WIDGET (window))) gtk_window_realize_icon (window); } /** * gtk_window_set_icon_name: * @window: a #GtkWindow * @name: (allow-none): the name of the themed icon * * Sets the icon for the window from a named themed icon. * See the docs for #GtkIconTheme for more details. * On some platforms, the window icon is not used at all. * * Note that this has nothing to do with the WM_ICON_NAME * property which is mentioned in the ICCCM. */ void gtk_window_set_icon_name (GtkWindow *window, const gchar *name) { GtkWindowIconInfo *info; gchar *tmp; g_return_if_fail (GTK_IS_WINDOW (window)); info = ensure_icon_info (window); if (g_strcmp0 (info->icon_name, name) == 0) return; tmp = info->icon_name; info->icon_name = g_strdup (name); g_free (tmp); update_themed_icon (window); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_ICON_NAME]); } /** * gtk_window_get_icon_name: * @window: a #GtkWindow * * Returns the name of the themed icon for the window, * see gtk_window_set_icon_name(). * * Returns: (nullable): the icon name or %NULL if the window has * no themed icon */ const gchar * gtk_window_get_icon_name (GtkWindow *window) { GtkWindowIconInfo *info; g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); info = ensure_icon_info (window); return info->icon_name; } /** * gtk_window_set_default_icon_name: * @name: the name of the themed icon * * Sets an icon to be used as fallback for windows that haven't * had gtk_window_set_icon_list() called on them from a named * themed icon, see gtk_window_set_icon_name(). **/ void gtk_window_set_default_icon_name (const gchar *name) { GList *tmp_list; GList *toplevels; g_free (default_icon_name); default_icon_name = g_strdup (name); /* Update all toplevels */ toplevels = gtk_window_list_toplevels (); tmp_list = toplevels; while (tmp_list != NULL) { GtkWindowIconInfo *info; GtkWindow *w = tmp_list->data; info = get_icon_info (w); if (info && info->using_default_icon && info->using_themed_icon) { gtk_window_unrealize_icon (w); if (_gtk_widget_get_realized (GTK_WIDGET (w))) gtk_window_realize_icon (w); } tmp_list = tmp_list->next; } g_list_free (toplevels); } /** * gtk_window_get_default_icon_name: * * Returns the fallback icon name for windows that has been set * with gtk_window_set_default_icon_name(). The returned * string is owned by GTK+ and should not be modified. It * is only valid until the next call to * gtk_window_set_default_icon_name(). * * Returns: the fallback icon name for windows */ const gchar * gtk_window_get_default_icon_name (void) { return default_icon_name; } #define INCLUDE_CSD_SIZE 1 #define EXCLUDE_CSD_SIZE -1 static void gtk_window_update_csd_size (GtkWindow *window, gint *width, gint *height, gint apply) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkBorder window_border = { 0 }; gint w, h; if (priv->type != GTK_WINDOW_TOPLEVEL) return; if (!priv->decorated || priv->fullscreen) return; get_shadow_width (window, &window_border); w = *width + apply * (window_border.left + window_border.right); h = *height + apply * (window_border.top + window_border.bottom); if (priv->title_box != NULL && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box)) { gint minimum_height; gint natural_height; gtk_widget_measure (priv->title_box, GTK_ORIENTATION_VERTICAL, -1, &minimum_height, &natural_height, NULL, NULL); h += apply * natural_height; } /* Make sure the size remains acceptable */ if (w < 1) w = 1; if (h < 1) h = 1; /* Only update given size if not negative */ if (*width > -1) *width = w; if (*height > -1) *height = h; } static void gtk_window_set_default_size_internal (GtkWindow *window, gboolean change_width, gint width, gboolean change_height, gint height) { GtkWindowGeometryInfo *info; g_return_if_fail (change_width == FALSE || width >= -1); g_return_if_fail (change_height == FALSE || height >= -1); info = gtk_window_get_geometry_info (window, TRUE); g_object_freeze_notify (G_OBJECT (window)); if (change_width) { if (width == 0) width = 1; if (width < 0) width = -1; if (info->default_width != width) { info->default_width = width; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DEFAULT_WIDTH]); } } if (change_height) { if (height == 0) height = 1; if (height < 0) height = -1; if (info->default_height != height) { info->default_height = height; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DEFAULT_HEIGHT]); } } g_object_thaw_notify (G_OBJECT (window)); gtk_widget_queue_resize_no_redraw (GTK_WIDGET (window)); } /** * gtk_window_set_default_size: * @window: a #GtkWindow * @width: width in pixels, or -1 to unset the default width * @height: height in pixels, or -1 to unset the default height * * Sets the default size of a window. If the window’s “natural” size * (its size request) is larger than the default, the default will be * ignored. * * Unlike gtk_widget_set_size_request(), which sets a size request for * a widget and thus would keep users from shrinking the window, this * function only sets the initial size, just as if the user had * resized the window themselves. Users can still shrink the window * again as they normally would. Setting a default size of -1 means to * use the “natural” default size (the size request of the window). * * For some uses, gtk_window_resize() is a more appropriate function. * gtk_window_resize() changes the current size of the window, rather * than the size to be used on initial display. gtk_window_resize() always * affects the window itself, not the geometry widget. * * The default size of a window only affects the first time a window is * shown; if a window is hidden and re-shown, it will remember the size * it had prior to hiding, rather than using the default size. * * Windows can’t actually be 0x0 in size, they must be at least 1x1, but * passing 0 for @width and @height is OK, resulting in a 1x1 default size. * * If you use this function to reestablish a previously saved window size, * note that the appropriate size to save is the one returned by * gtk_window_get_size(). Using the window allocation directly will not * work in all circumstances and can lead to growing or shrinking windows. */ void gtk_window_set_default_size (GtkWindow *window, gint width, gint height) { g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (width >= -1); g_return_if_fail (height >= -1); gtk_window_set_default_size_internal (window, TRUE, width, TRUE, height); } /** * gtk_window_get_default_size: * @window: a #GtkWindow * @width: (out) (allow-none): location to store the default width, or %NULL * @height: (out) (allow-none): location to store the default height, or %NULL * * Gets the default size of the window. A value of -1 for the width or * height indicates that a default size has not been explicitly set * for that dimension, so the “natural” size of the window will be * used. * **/ void gtk_window_get_default_size (GtkWindow *window, gint *width, gint *height) { GtkWindowGeometryInfo *info; g_return_if_fail (GTK_IS_WINDOW (window)); info = gtk_window_get_geometry_info (window, FALSE); if (width) *width = info ? info->default_width : -1; if (height) *height = info ? info->default_height : -1; } /** * gtk_window_resize: * @window: a #GtkWindow * @width: width in pixels to resize the window to * @height: height in pixels to resize the window to * * Resizes the window as if the user had done so, obeying geometry * constraints. The default geometry constraint is that windows may * not be smaller than their size request; to override this * constraint, call gtk_widget_set_size_request() to set the window's * request to a smaller value. * * If gtk_window_resize() is called before showing a window for the * first time, it overrides any default size set with * gtk_window_set_default_size(). * * Windows may not be resized smaller than 1 by 1 pixels. * * When using client side decorations, GTK+ will do its best to adjust * the given size so that the resulting window size matches the * requested size without the title bar, borders and shadows added for * the client side decorations, but there is no guarantee that the * result will be totally accurate because these widgets added for * client side decorations depend on the theme and may not be realized * or visible at the time gtk_window_resize() is issued. * * If the GtkWindow has a titlebar widget (see gtk_window_set_titlebar()), then * typically, gtk_window_resize() will compensate for the height of the titlebar * widget only if the height is known when the resulting GtkWindow configuration * is issued. * For example, if new widgets are added after the GtkWindow configuration * and cause the titlebar widget to grow in height, this will result in a * window content smaller that specified by gtk_window_resize() and not * a larger window. * **/ void gtk_window_resize (GtkWindow *window, gint width, gint height) { GtkWindowGeometryInfo *info; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (width > 0); g_return_if_fail (height > 0); info = gtk_window_get_geometry_info (window, TRUE); info->resize_width = width; info->resize_height = height; gtk_widget_queue_resize_no_redraw (GTK_WIDGET (window)); } /** * gtk_window_get_size: * @window: a #GtkWindow * @width: (out) (optional): return location for width, or %NULL * @height: (out) (optional): return location for height, or %NULL * * Obtains the current size of @window. * * If @window is not visible on screen, this function return the size GTK+ * will suggest to the [window manager][gtk-X11-arch] for the initial window * size (but this is not reliably the same as the size the window manager * will actually select). See: gtk_window_set_default_size(). * * Depending on the windowing system and the window manager constraints, * the size returned by this function may not match the size set using * gtk_window_resize(); additionally, since gtk_window_resize() may be * implemented as an asynchronous operation, GTK+ cannot guarantee in any * way that this code: * * |[ * GtkWindow *window = GTK_WINDOW (gtk_window_new (GTK_WINDOW_TOPLEVEL)); * int width = 500; * int height = 300; * gtk_window_resize (window, width, height); * * int new_width, new_height; * gtk_window_get_size (window, &new_width, &new_height); * ]| * * will result in `new_width` and `new_height` matching `width` and * `height`, respectively. * * This function will return the logical size of the #GtkWindow, * excluding the widgets used in client side decorations; there is, * however, no guarantee that the result will be completely accurate * because client side decoration may include widgets that depend on * the user preferences and that may not be visibile at the time you * call this function. * * The dimensions returned by this function are suitable for being * stored across sessions; use gtk_window_set_default_size() to * restore them when before showing the window. * * To avoid potential race conditions, you should only call this * function in response to a size change notification, for instance * inside a handler for the #GtkWidget::size-allocate signal, or * inside a handler for the #GtkWidget::configure-event signal: * * |[ * static void * on_size_allocate (GtkWidget *widget, * const GtkAllocation *allocation, * int baseline) * { * int new_width, new_height; * * gtk_window_get_size (GTK_WINDOW (widget), &new_width, &new_height); * * // ... * } * ]| * * Note that, if you connect to the #GtkWidget::size-allocate signal, * you should not use the dimensions of the #GtkAllocation passed to * the signal handler, as the allocation may contain client side * decorations added by GTK+, depending on the windowing system in * use. * * If you are getting a window size in order to position the window * on the screen, you should, instead, simply set the window’s semantic * type with gtk_window_set_type_hint(), which allows the window manager * to e.g. center dialogs. Also, if you set the transient parent of * dialogs with gtk_window_set_transient_for() window managers will * often center the dialog over its parent window. It's much preferred * to let the window manager handle these cases rather than doing it * yourself, because all apps will behave consistently and according to * user or system preferences, if the window manager handles it. Also, * the window manager can take into account the size of the window * decorations and border that it may add, and of which GTK+ has no * knowledge. Additionally, positioning windows in global screen coordinates * may not be allowed by the windowing system. For more information, * see: gtk_window_set_position(). */ void gtk_window_get_size (GtkWindow *window, gint *width, gint *height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gint w, h; g_return_if_fail (GTK_IS_WINDOW (window)); if (width == NULL && height == NULL) return; if (_gtk_widget_get_mapped (GTK_WIDGET (window))) { w = gdk_surface_get_width (priv->surface); h = gdk_surface_get_height (priv->surface); } else { GdkRectangle configure_request; gtk_window_compute_configure_request (window, &configure_request, NULL, NULL); w = configure_request.width; h = configure_request.height; } gtk_window_update_csd_size (window, &w, &h, EXCLUDE_CSD_SIZE); if (width) *width = w; if (height) *height = h; } static void gtk_window_destroy (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); guint i; gtk_window_release_application (window); for (i = 0; i < g_list_model_get_n_items (G_LIST_MODEL (toplevel_list)); i++) { gpointer item = g_list_model_get_item (G_LIST_MODEL (toplevel_list), i); if (item == window) { g_list_store_remove (toplevel_list, i); break; } else g_object_unref (item); } gtk_window_update_debugging (); if (priv->transient_parent) gtk_window_set_transient_for (window, NULL); remove_attach_widget (window); if (priv->has_user_ref_count) { priv->has_user_ref_count = FALSE; g_object_unref (window); } if (priv->group) gtk_window_group_remove_window (priv->group, window); gtk_window_free_key_hash (window); GTK_WIDGET_CLASS (gtk_window_parent_class)->destroy (widget); } static gboolean gtk_window_close_request (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->hide_on_close) { gtk_widget_hide (GTK_WIDGET (window)); return TRUE; } return FALSE; } gboolean gtk_window_emit_close_request (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gboolean handled; /* Avoid re-entrancy issues when calling gtk_window_close from a * close-request handler */ if (priv->in_emit_close_request) return TRUE; priv->in_emit_close_request = TRUE; g_signal_emit (window, window_signals[CLOSE_REQUEST], 0, &handled); priv->in_emit_close_request = FALSE; return handled; } static void gtk_window_finalize (GObject *object) { GtkWindow *window = GTK_WINDOW (object); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkMnemonicHash *mnemonic_hash; g_free (priv->title); gtk_window_release_application (window); mnemonic_hash = gtk_window_get_mnemonic_hash (window, FALSE); if (mnemonic_hash) _gtk_mnemonic_hash_free (mnemonic_hash); if (priv->geometry_info) { g_free (priv->geometry_info); } if (priv->keys_changed_handler) { g_source_remove (priv->keys_changed_handler); priv->keys_changed_handler = 0; } g_signal_handlers_disconnect_by_func (gdk_display_get_default_seat (priv->display), device_removed_cb, window); #ifdef GDK_WINDOWING_X11 g_signal_handlers_disconnect_by_func (gtk_settings_get_for_display (priv->display), gtk_window_on_theme_variant_changed, window); #endif g_free (priv->startup_id); if (priv->mnemonics_display_timeout_id) { g_source_remove (priv->mnemonics_display_timeout_id); priv->mnemonics_display_timeout_id = 0; } g_clear_object (&priv->constraint_solver); g_clear_object (&priv->renderer); G_OBJECT_CLASS (gtk_window_parent_class)->finalize (object); } /* copied from gdksurface-x11.c */ static const gchar * get_default_title (void) { const gchar *title; title = g_get_application_name (); if (!title) title = g_get_prgname (); if (!title) title = ""; return title; } static gboolean update_csd_visibility (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gboolean visible; if (priv->title_box == NULL) return FALSE; visible = !priv->fullscreen && priv->decorated; gtk_widget_set_child_visible (priv->title_box, visible); return visible; } static void update_window_buttons (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (!update_csd_visibility (window)) return; if (GTK_IS_HEADER_BAR (priv->title_box)) _gtk_header_bar_update_window_buttons (GTK_HEADER_BAR (priv->title_box)); } static GtkWidget * create_titlebar (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *titlebar; GtkStyleContext *context; titlebar = gtk_header_bar_new (); g_object_set (titlebar, "title", priv->title ? priv->title : get_default_title (), "has-subtitle", FALSE, "show-title-buttons", TRUE, NULL); context = gtk_widget_get_style_context (titlebar); gtk_style_context_add_class (context, GTK_STYLE_CLASS_TITLEBAR); gtk_style_context_add_class (context, "default-decoration"); return titlebar; } void _gtk_window_request_csd (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->csd_requested = TRUE; } static gboolean gtk_window_should_use_csd (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); const gchar *csd_env; if (priv->csd_requested) return TRUE; if (!priv->decorated) return FALSE; if (priv->type == GTK_WINDOW_POPUP) return FALSE; csd_env = g_getenv ("GTK_CSD"); #ifdef GDK_WINDOWING_BROADWAY if (GDK_IS_BROADWAY_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) return TRUE; #endif #ifdef GDK_WINDOWING_WAYLAND if (GDK_IS_WAYLAND_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) { GdkDisplay *gdk_display = gtk_widget_get_display (GTK_WIDGET (window)); return !gdk_wayland_display_prefers_ssd (gdk_display); } #endif #ifdef GDK_WINDOWING_MIR if (GDK_IS_MIR_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) return TRUE; #endif #ifdef GDK_WINDOWING_WIN32 if (g_strcmp0 (csd_env, "0") != 0 && GDK_IS_WIN32_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) return TRUE; #endif return (g_strcmp0 (csd_env, "1") == 0); } static void create_decoration (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->use_client_shadow = gtk_window_supports_client_shadow (window); if (!priv->use_client_shadow) return; gtk_window_enable_csd (window); if (priv->type == GTK_WINDOW_POPUP) return; if (priv->title_box == NULL) { priv->titlebar = create_titlebar (window); gtk_widget_set_parent (priv->titlebar, widget); priv->title_box = priv->titlebar; } update_window_buttons (window); } static void gtk_window_show (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); _gtk_widget_set_visible_flag (widget, TRUE); gtk_css_node_validate (gtk_widget_get_css_node (widget)); gtk_widget_realize (widget); gtk_window_check_resize (window); gtk_widget_map (widget); if (!priv->focus_widget) { if (priv->initial_focus) gtk_window_set_focus (window, priv->initial_focus); else gtk_window_move_focus (widget, GTK_DIR_TAB_FORWARD); } if (priv->modal) gtk_grab_add (widget); } static void gtk_window_hide (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); _gtk_widget_set_visible_flag (widget, FALSE); gtk_widget_unmap (widget); if (priv->modal) gtk_grab_remove (widget); } static void gtk_window_map (GtkWidget *widget) { GtkWidget *child; GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GdkSurface *surface; GTK_WIDGET_CLASS (gtk_window_parent_class)->map (widget); child = gtk_bin_get_child (GTK_BIN (window)); if (child != NULL && gtk_widget_get_visible (child)) gtk_widget_map (child); if (priv->title_box != NULL && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box)) gtk_widget_map (priv->title_box); surface = priv->surface; if (priv->maximize_initially) gdk_surface_maximize (surface); else gdk_surface_unmaximize (surface); if (priv->stick_initially) gdk_surface_stick (surface); else gdk_surface_unstick (surface); if (priv->iconify_initially) gdk_surface_iconify (surface); else gdk_surface_deiconify (surface); if (priv->fullscreen_initially) { if (priv->initial_fullscreen_monitor) gdk_surface_fullscreen_on_monitor (surface, priv->initial_fullscreen_monitor); else gdk_surface_fullscreen (surface); } else gdk_surface_unfullscreen (surface); gdk_surface_set_keep_above (surface, priv->above_initially); gdk_surface_set_keep_below (surface, priv->below_initially); if (priv->type == GTK_WINDOW_TOPLEVEL) gtk_window_set_theme_variant (window); /* No longer use the default settings */ priv->need_default_size = FALSE; gdk_surface_show (surface); if (!disable_startup_notification && priv->type != GTK_WINDOW_POPUP) { /* Do we have a custom startup-notification id? */ if (priv->startup_id != NULL) { /* Make sure we have a "real" id */ if (!startup_id_is_fake (priv->startup_id)) gdk_display_notify_startup_complete (gtk_widget_get_display (widget), priv->startup_id); g_free (priv->startup_id); priv->startup_id = NULL; } else gdk_display_notify_startup_complete (gtk_widget_get_display (widget), NULL); } /* inherit from transient parent, so that a dialog that is * opened via keynav shows focus initially */ if (priv->transient_parent) gtk_window_set_focus_visible (window, gtk_window_get_focus_visible (priv->transient_parent)); else gtk_window_set_focus_visible (window, FALSE); if (priv->application) gtk_application_handle_window_map (priv->application, window); } static void gtk_window_unmap (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *child; GdkSurfaceState state; GTK_WIDGET_CLASS (gtk_window_parent_class)->unmap (widget); gdk_surface_hide (priv->surface); while (priv->configure_request_count > 0) { priv->configure_request_count--; gdk_surface_thaw_toplevel_updates (priv->surface); } priv->configure_notify_received = FALSE; state = gdk_surface_get_state (priv->surface); priv->iconify_initially = (state & GDK_SURFACE_STATE_ICONIFIED) != 0; priv->maximize_initially = (state & GDK_SURFACE_STATE_MAXIMIZED) != 0; priv->stick_initially = (state & GDK_SURFACE_STATE_STICKY) != 0; priv->above_initially = (state & GDK_SURFACE_STATE_ABOVE) != 0; priv->below_initially = (state & GDK_SURFACE_STATE_BELOW) != 0; if (priv->title_box != NULL) gtk_widget_unmap (priv->title_box); child = gtk_bin_get_child (GTK_BIN (window)); if (child != NULL) gtk_widget_unmap (child); } /* (Note: Replace "size" with "width" or "height". Also, the request * mode is honoured.) * For selecting the default window size, the following conditions * should hold (in order of importance): * - the size is not below the minimum size * Windows cannot be resized below their minimum size, so we must * ensure we don’t do that either. * - the size is not above the natural size * It seems weird to allocate more than this in an initial guess. * - the size does not exceed that of a maximized window * We want to see the whole window after all. * (Note that this may not be possible to achieve due to imperfect * information from the windowing system.) */ static void gtk_window_guess_default_size (GtkWindow *window, gint *width, gint *height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; GdkSurface *surface; GdkDisplay *display; GdkMonitor *monitor; GdkRectangle workarea; int minimum, natural; widget = GTK_WIDGET (window); display = gtk_widget_get_display (widget); surface = priv->surface; if (surface) monitor = gdk_display_get_monitor_at_surface (display, surface); else monitor = gdk_display_get_monitor (display, 0); gdk_monitor_get_workarea (monitor, &workarea); *width = workarea.width; *height = workarea.height; if (gtk_widget_get_request_mode (widget) == GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT) { gtk_widget_measure (widget, GTK_ORIENTATION_VERTICAL, -1, &minimum, &natural, NULL, NULL); *height = MAX (minimum, MIN (*height, natural)); gtk_widget_measure (widget, GTK_ORIENTATION_HORIZONTAL, *height, &minimum, &natural, NULL, NULL); *width = MAX (minimum, MIN (*width, natural)); } else /* GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or CONSTANT_SIZE */ { gtk_widget_measure (widget, GTK_ORIENTATION_HORIZONTAL, -1, &minimum, &natural, NULL, NULL); *width = MAX (minimum, MIN (*width, natural)); gtk_widget_measure (widget, GTK_ORIENTATION_VERTICAL, *width, &minimum, &natural, NULL, NULL); *height = MAX (minimum, MIN (*height, natural)); } } static void gtk_window_get_remembered_size (GtkWindow *window, int *width, int *height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowGeometryInfo *info; *width = 0; *height = 0; if (priv->surface) { *width = gdk_surface_get_width (priv->surface); *height = gdk_surface_get_height (priv->surface); return; } info = gtk_window_get_geometry_info (window, FALSE); if (info) { /* MAX() works even if the last request is unset with -1 */ *width = MAX (*width, info->last.configure_request.width); *height = MAX (*height, info->last.configure_request.height); } } static void popover_get_rect (GtkWindowPopover *popover, GtkWindow *window, cairo_rectangle_int_t *rect) { GtkAllocation win_alloc; GtkRequisition req; GtkBorder win_border; gdouble min, max; gtk_widget_get_preferred_size (popover->widget, NULL, &req); gtk_widget_get_allocation (GTK_WIDGET (window), &win_alloc); get_shadow_width (window, &win_border); win_alloc.x += win_border.left; win_alloc.y += win_border.top; win_alloc.width -= win_border.left + win_border.right; win_alloc.height -= win_border.top + win_border.bottom; rect->width = req.width; rect->height = req.height; if (popover->pos == GTK_POS_LEFT || popover->pos == GTK_POS_RIGHT) { if (req.height < win_alloc.height && gtk_widget_get_vexpand (popover->widget)) { rect->y = win_alloc.y; rect->height = win_alloc.height; } else { min = 0; max = win_alloc.y + win_alloc.height + win_border.bottom - req.height; if (popover->clamp_allocation) { min += win_border.top; max -= win_border.bottom; } rect->y = CLAMP (popover->rect.y + (popover->rect.height / 2) - (req.height / 2), min, max); } if ((popover->pos == GTK_POS_LEFT) == (gtk_widget_get_direction (popover->widget) == GTK_TEXT_DIR_LTR)) { rect->x = popover->rect.x - req.width; if (rect->x > win_alloc.x && gtk_widget_get_hexpand (popover->widget)) { rect->x = win_alloc.x; rect->width = popover->rect.x; } } else { rect->x = popover->rect.x + popover->rect.width; if (rect->x + rect->width < win_alloc.x + win_alloc.width && gtk_widget_get_hexpand (popover->widget)) rect->width = win_alloc.x + win_alloc.width - rect->x; } } else if (popover->pos == GTK_POS_TOP || popover->pos == GTK_POS_BOTTOM) { if (req.width < win_alloc.width && gtk_widget_get_hexpand (popover->widget)) { rect->x = win_alloc.x; rect->width = win_alloc.width; } else { min = 0; max = win_alloc.x + win_alloc.width + win_border.right - req.width; if (popover->clamp_allocation) { min += win_border.left; max -= win_border.right; } rect->x = CLAMP (popover->rect.x + (popover->rect.width / 2) - (req.width / 2), min, max); } if (popover->pos == GTK_POS_TOP) { rect->y = popover->rect.y - req.height; if (rect->y > win_alloc.y && gtk_widget_get_vexpand (popover->widget)) { rect->y = win_alloc.y; rect->height = popover->rect.y; } } else { rect->y = popover->rect.y + popover->rect.height; if (rect->y + rect->height < win_alloc.y + win_alloc.height && gtk_widget_get_vexpand (popover->widget)) rect->height = win_alloc.y + win_alloc.height - rect->y; } } } static void check_scale_changed (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget = GTK_WIDGET (window); int old_scale; old_scale = priv->scale; priv->scale = gtk_widget_get_scale_factor (widget); if (old_scale != priv->scale) _gtk_widget_scale_changed (widget); } static void sum_borders (GtkBorder *one, GtkBorder *two) { one->top += two->top; one->right += two->right; one->bottom += two->bottom; one->left += two->left; } static void max_borders (GtkBorder *one, GtkBorder *two) { one->top = MAX (one->top, two->top); one->right = MAX (one->right, two->right); one->bottom = MAX (one->bottom, two->bottom); one->left = MAX (one->left, two->left); } static void subtract_borders (GtkBorder *one, GtkBorder *two) { one->top -= two->top; one->right -= two->right; one->bottom -= two->bottom; one->left -= two->left; } static void get_shadow_width (GtkWindow *window, GtkBorder *shadow_width) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkBorder border = { 0 }; GtkBorder d = { 0 }; GtkBorder margin; GtkStyleContext *context; GtkCssValue *shadows; *shadow_width = border; if (!priv->decorated) return; if (!priv->client_decorated && !(gtk_window_should_use_csd (window) && gtk_window_supports_client_shadow (window))) return; if (priv->maximized || priv->fullscreen) return; context = _gtk_widget_get_style_context (GTK_WIDGET (window)); gtk_style_context_save_to_node (context, priv->decoration_node); /* Always sum border + padding */ gtk_style_context_get_border (context, &border); gtk_style_context_get_padding (context, &d); sum_borders (&d, &border); /* Calculate the size of the drop shadows ... */ shadows = _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BOX_SHADOW); _gtk_css_shadows_value_get_extents (shadows, &border); if (priv->type != GTK_WINDOW_POPUP) { /* ... and compare it to the margin size, which we use for resize grips */ gtk_style_context_get_margin (context, &margin); max_borders (&border, &margin); } sum_borders (&d, &border); *shadow_width = d; gtk_style_context_restore (context); } static void update_csd_shape (GtkWindow *window) { GtkWidget *widget = (GtkWidget *)window; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); cairo_region_t *region; cairo_rectangle_int_t rect; GtkBorder border, tmp; GtkBorder window_border; GtkStyleContext *context; if (!priv->client_decorated) return; context = _gtk_widget_get_style_context (widget); gtk_style_context_save_to_node (context, priv->decoration_node); gtk_style_context_get_margin (context, &border); gtk_style_context_get_border (context, &tmp); sum_borders (&border, &tmp); gtk_style_context_get_padding (context, &tmp); sum_borders (&border, &tmp); gtk_style_context_restore (context); get_shadow_width (window, &window_border); /* update the input shape, which makes it so that clicks * outside the border windows go through. */ if (priv->type != GTK_WINDOW_POPUP) subtract_borders (&window_border, &border); rect.x = window_border.left; rect.y = window_border.top; rect.width = gtk_widget_get_allocated_width (widget) - window_border.left - window_border.right; rect.height = gtk_widget_get_allocated_height (widget) - window_border.top - window_border.bottom; region = cairo_region_create_rectangle (&rect); gtk_widget_set_csd_input_shape (widget, region); cairo_region_destroy (region); } static void update_shadow_width (GtkWindow *window, GtkBorder *border) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->surface) gdk_surface_set_shadow_width (priv->surface, border->left, border->right, border->top, border->bottom); } static void corner_rect (cairo_rectangle_int_t *rect, const GtkCssValue *value) { rect->width = _gtk_css_corner_value_get_x (value, 100); rect->height = _gtk_css_corner_value_get_y (value, 100); } static void subtract_corners_from_region (cairo_region_t *region, cairo_rectangle_int_t *extents, GtkStyleContext *context, GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); cairo_rectangle_int_t rect; gtk_style_context_save_to_node (context, priv->decoration_node); corner_rect (&rect, _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BORDER_TOP_LEFT_RADIUS)); rect.x = extents->x; rect.y = extents->y; cairo_region_subtract_rectangle (region, &rect); corner_rect (&rect, _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BORDER_TOP_RIGHT_RADIUS)); rect.x = extents->x + extents->width - rect.width; rect.y = extents->y; cairo_region_subtract_rectangle (region, &rect); corner_rect (&rect, _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BORDER_BOTTOM_LEFT_RADIUS)); rect.x = extents->x; rect.y = extents->y + extents->height - rect.height; cairo_region_subtract_rectangle (region, &rect); corner_rect (&rect, _gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BORDER_BOTTOM_RIGHT_RADIUS)); rect.x = extents->x + extents->width - rect.width; rect.y = extents->y + extents->height - rect.height; cairo_region_subtract_rectangle (region, &rect); gtk_style_context_restore (context); } static void update_opaque_region (GtkWindow *window, const GtkBorder *border, const GtkAllocation *allocation) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget = GTK_WIDGET (window); cairo_region_t *opaque_region; GtkStyleContext *context; gboolean is_opaque = FALSE; if (!_gtk_widget_get_realized (widget)) return; context = gtk_widget_get_style_context (widget); is_opaque = gdk_rgba_is_opaque (_gtk_css_rgba_value_get_rgba (_gtk_style_context_peek_property (context, GTK_CSS_PROPERTY_BACKGROUND_COLOR))); if (gtk_widget_get_opacity (widget) < 1.0) is_opaque = FALSE; if (is_opaque) { cairo_rectangle_int_t rect; rect.x = border->left; rect.y = border->top; rect.width = allocation->width - border->left - border->right; rect.height = allocation->height - border->top - border->bottom; opaque_region = cairo_region_create_rectangle (&rect); subtract_corners_from_region (opaque_region, &rect, context, window); } else { opaque_region = NULL; } gdk_surface_set_opaque_region (priv->surface, opaque_region); cairo_region_destroy (opaque_region); } static void update_realized_window_properties (GtkWindow *window, GtkAllocation *child_allocation, GtkBorder *window_border) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->client_decorated && priv->use_client_shadow) update_shadow_width (window, window_border); update_opaque_region (window, window_border, child_allocation); update_csd_shape (window); } static void gtk_window_realize (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkAllocation allocation; GtkAllocation child_allocation; GdkSurface *surface; GtkBorder window_border; if (!priv->client_decorated && gtk_window_should_use_csd (window)) create_decoration (widget); /* ensure widget tree is properly size allocated */ if (_gtk_widget_get_alloc_needed (widget)) { GdkRectangle request; gtk_window_compute_configure_request (window, &request, NULL, NULL); allocation.x = 0; allocation.y = 0; allocation.width = request.width; allocation.height = request.height; gtk_widget_size_allocate (widget, &allocation, -1); gtk_widget_queue_resize (widget); g_return_if_fail (!_gtk_widget_get_realized (widget)); } gtk_widget_get_allocation (widget, &allocation); if (priv->hardcoded_surface) { surface = priv->hardcoded_surface; gdk_surface_resize (surface, allocation.width, allocation.height); } else { switch (priv->type) { case GTK_WINDOW_TOPLEVEL: surface = gdk_surface_new_toplevel (gtk_widget_get_display (widget), allocation.width, allocation.height); break; case GTK_WINDOW_POPUP: surface = gdk_surface_new_temp (gtk_widget_get_display (widget), &allocation); break; default: g_error (G_STRLOC": Unknown window type %d!", priv->type); break; } } priv->surface = surface; gdk_surface_set_widget (surface, widget); g_signal_connect_swapped (surface, "notify::state", G_CALLBACK (surface_state_changed), widget); g_signal_connect_swapped (surface, "size-changed", G_CALLBACK (surface_size_changed), widget); g_signal_connect (surface, "render", G_CALLBACK (surface_render), widget); g_signal_connect (surface, "event", G_CALLBACK (surface_event), widget); GTK_WIDGET_CLASS (gtk_window_parent_class)->realize (widget); if (priv->renderer == NULL) priv->renderer = gsk_renderer_new_for_surface (surface); if (priv->transient_parent && _gtk_widget_get_realized (GTK_WIDGET (priv->transient_parent))) { GtkWindowPrivate *parent_priv = gtk_window_get_instance_private (priv->transient_parent); gdk_surface_set_transient_for (surface, parent_priv->surface); } gdk_surface_set_type_hint (surface, priv->type_hint); if (priv->title) gdk_surface_set_title (surface, priv->title); if (!priv->decorated || priv->client_decorated) gdk_surface_set_decorations (surface, 0); #ifdef GDK_WINDOWING_WAYLAND if (priv->client_decorated && GDK_IS_WAYLAND_SURFACE (surface)) gdk_wayland_surface_announce_csd (surface); #endif if (!priv->deletable) gdk_surface_set_functions (surface, GDK_FUNC_ALL | GDK_FUNC_CLOSE); if (gtk_window_get_accept_focus (window)) gdk_surface_set_accept_focus (surface, TRUE); else gdk_surface_set_accept_focus (surface, FALSE); if (gtk_window_get_focus_on_map (window)) gdk_surface_set_focus_on_map (surface, TRUE); else gdk_surface_set_focus_on_map (surface, FALSE); if (priv->modal) gdk_surface_set_modal_hint (surface, TRUE); else gdk_surface_set_modal_hint (surface, FALSE); if (priv->startup_id) { #ifdef GDK_WINDOWING_X11 if (GDK_IS_X11_SURFACE (surface)) { guint32 timestamp = extract_time_from_startup_id (priv->startup_id); if (timestamp != GDK_CURRENT_TIME) gdk_x11_surface_set_user_time (surface, timestamp); } #endif if (!startup_id_is_fake (priv->startup_id)) gdk_surface_set_startup_id (surface, priv->startup_id); } #ifdef GDK_WINDOWING_X11 if (priv->initial_timestamp != GDK_CURRENT_TIME) { if (GDK_IS_X11_SURFACE (surface)) gdk_x11_surface_set_user_time (surface, priv->initial_timestamp); } #endif child_allocation.x = 0; child_allocation.y = 0; child_allocation.width = allocation.width; child_allocation.height = allocation.height; get_shadow_width (window, &window_border); update_realized_window_properties (window, &child_allocation, &window_border); if (priv->application) gtk_application_handle_window_realize (priv->application, window); /* Icons */ gtk_window_realize_icon (window); check_scale_changed (window); } static void gtk_window_unrealize (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowGeometryInfo *info; GdkSurface *surface; /* On unrealize, we reset the size of the window such * that we will re-apply the default sizing stuff * next time we show the window. * * Default positioning is reset on unmap, instead of unrealize. */ priv->need_default_size = TRUE; info = gtk_window_get_geometry_info (window, FALSE); if (info) { info->resize_width = -1; info->resize_height = -1; info->last.configure_request.x = 0; info->last.configure_request.y = 0; info->last.configure_request.width = -1; info->last.configure_request.height = -1; /* be sure we reset geom hints on re-realize */ info->last.flags = 0; } if (priv->popup_menu) { gtk_widget_destroy (priv->popup_menu); priv->popup_menu = NULL; } /* Icons */ gtk_window_unrealize_icon (window); gtk_container_forall (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_unrealize, NULL); gsk_renderer_unrealize (priv->renderer); g_clear_object (&priv->renderer); surface = priv->surface; g_signal_handlers_disconnect_by_func (surface, surface_state_changed, widget); g_signal_handlers_disconnect_by_func (surface, surface_size_changed, widget); g_signal_handlers_disconnect_by_func (surface, surface_render, widget); g_signal_handlers_disconnect_by_func (surface, surface_event, widget); GTK_WIDGET_CLASS (gtk_window_parent_class)->unrealize (widget); gdk_surface_set_widget (surface, NULL); gdk_surface_destroy (surface); g_clear_object (&priv->surface); priv->hardcoded_surface = NULL; } static void update_window_style_classes (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkStyleContext *context; guint edge_constraints; context = gtk_widget_get_style_context (GTK_WIDGET (window)); edge_constraints = priv->edge_constraints; if (!priv->edge_constraints) { if (priv->tiled) gtk_style_context_add_class (context, "tiled"); else gtk_style_context_remove_class (context, "tiled"); } else { if (edge_constraints & GDK_SURFACE_STATE_TOP_TILED) gtk_style_context_add_class (context, "tiled-top"); else gtk_style_context_remove_class (context, "tiled-top"); if (edge_constraints & GDK_SURFACE_STATE_RIGHT_TILED) gtk_style_context_add_class (context, "tiled-right"); else gtk_style_context_remove_class (context, "tiled-right"); if (edge_constraints & GDK_SURFACE_STATE_BOTTOM_TILED) gtk_style_context_add_class (context, "tiled-bottom"); else gtk_style_context_remove_class (context, "tiled-bottom"); if (edge_constraints & GDK_SURFACE_STATE_LEFT_TILED) gtk_style_context_add_class (context, "tiled-left"); else gtk_style_context_remove_class (context, "tiled-left"); } if (priv->maximized) gtk_style_context_add_class (context, "maximized"); else gtk_style_context_remove_class (context, "maximized"); if (priv->maximized) gtk_style_context_add_class (context, "maximized"); else gtk_style_context_remove_class (context, "maximized"); if (priv->fullscreen) gtk_style_context_add_class (context, "fullscreen"); else gtk_style_context_remove_class (context, "fullscreen"); } static void popover_size_allocate (GtkWindowPopover *popover, GtkWindow *window) { cairo_rectangle_int_t rect; if (!gtk_widget_get_mapped (popover->widget)) return; #if 0 if (GTK_IS_POPOVER (popover->widget)) gtk_popover_update_position (GTK_POPOVER (popover->widget)); #endif popover_get_rect (popover, window, &rect); gtk_widget_size_allocate (popover->widget, &rect, -1); } /* _gtk_window_set_allocation: * @window: a #GtkWindow * @allocation: the original allocation for the window * @allocation_out: @allocation taking decorations into * consideration * * This function is like gtk_widget_set_allocation() * but does the necessary extra work to update * the resize grip positioning, etc. * * Call this instead of gtk_widget_set_allocation() * when overriding ::size_allocate in a GtkWindow * subclass without chaining up. * * The @allocation parameter will be adjusted to * reflect any internal decorations that the window * may have. That revised allocation will then be * returned in the @allocation_out parameter. */ void _gtk_window_set_allocation (GtkWindow *window, int width, int height, GtkAllocation *allocation_out) { GtkWidget *widget = (GtkWidget *)window; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkAllocation child_allocation; GtkBorder window_border = { 0 }; GList *link; g_assert (allocation_out != NULL); child_allocation.x = 0; child_allocation.y = 0; child_allocation.width = width; child_allocation.height = height; get_shadow_width (window, &window_border); if (_gtk_widget_get_realized (widget)) update_realized_window_properties (window, &child_allocation, &window_border); priv->title_height = 0; if (priv->title_box != NULL && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box) && priv->decorated && !priv->fullscreen) { GtkAllocation title_allocation; title_allocation.x = window_border.left; title_allocation.y = window_border.top; title_allocation.width = MAX (1, width - window_border.left - window_border.right); gtk_widget_measure (priv->title_box, GTK_ORIENTATION_VERTICAL, title_allocation.width, NULL, &priv->title_height, NULL, NULL); title_allocation.height = priv->title_height; gtk_widget_size_allocate (priv->title_box, &title_allocation, -1); } if (priv->decorated && !priv->fullscreen) { child_allocation.x += window_border.left; child_allocation.y += window_border.top + priv->title_height; child_allocation.width -= window_border.left + window_border.right; child_allocation.height -= window_border.top + window_border.bottom + priv->title_height; } *allocation_out = child_allocation; for (link = priv->popovers.head; link; link = link->next) { GtkWindowPopover *popover = link->data; popover_size_allocate (popover, window); } } static void gtk_window_size_allocate (GtkWidget *widget, int width, int height, int baseline) { GtkWindow *window = GTK_WINDOW (widget); GtkWidget *child; GtkAllocation child_allocation; _gtk_window_set_allocation (window, width, height, &child_allocation); child = gtk_bin_get_child (GTK_BIN (window)); if (child && gtk_widget_get_visible (child)) gtk_widget_size_allocate (child, &child_allocation, -1); } gboolean gtk_window_configure (GtkWindow *window, guint width, guint height) { GtkAllocation allocation; GtkWidget *widget = GTK_WIDGET (window); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); check_scale_changed (window); /* If this is a gratuitous ConfigureNotify that's already * the same as our allocation, then we can fizzle it out. * This is the case for dragging windows around. * * We can't do this for a ConfigureRequest, since it might * have been a queued resize from child widgets, and so we * need to reallocate our children in case *they* changed. */ gtk_widget_get_allocation (widget, &allocation); if (priv->configure_request_count == 0 && (allocation.width == width && allocation.height == height)) { return TRUE; } /* priv->configure_request_count incremented for each * configure request, and decremented to a min of 0 for * each configure notify. * * All it means is that we know we will get at least * priv->configure_request_count more configure notifies. * We could get more configure notifies than that; some * of the configure notifies we get may be unrelated to * the configure requests. But we will get at least * priv->configure_request_count notifies. */ if (priv->configure_request_count > 0) { priv->configure_request_count -= 1; gdk_surface_thaw_toplevel_updates (priv->surface); } /* * If we do need to resize, we do that by: * - setting configure_notify_received to TRUE * for use in gtk_window_move_resize() * - queueing a resize, leading to invocation of * gtk_window_move_resize() in an idle handler * */ priv->configure_notify_received = TRUE; gtk_widget_queue_allocate (widget); return TRUE; } static void update_edge_constraints (GtkWindow *window, GdkSurfaceState state) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->edge_constraints = (state & GDK_SURFACE_STATE_TOP_TILED) | (state & GDK_SURFACE_STATE_TOP_RESIZABLE) | (state & GDK_SURFACE_STATE_RIGHT_TILED) | (state & GDK_SURFACE_STATE_RIGHT_RESIZABLE) | (state & GDK_SURFACE_STATE_BOTTOM_TILED) | (state & GDK_SURFACE_STATE_BOTTOM_RESIZABLE) | (state & GDK_SURFACE_STATE_LEFT_TILED) | (state & GDK_SURFACE_STATE_LEFT_RESIZABLE); priv->tiled = (state & GDK_SURFACE_STATE_TILED) ? 1 : 0; } static void surface_state_changed (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GdkSurfaceState new_surface_state; GdkSurfaceState changed_mask; new_surface_state = gdk_surface_get_state (priv->surface); changed_mask = new_surface_state ^ priv->state; priv->state = new_surface_state; if (changed_mask & GDK_SURFACE_STATE_FOCUSED) ensure_state_flag_backdrop (widget); if (changed_mask & GDK_SURFACE_STATE_FULLSCREEN) { priv->fullscreen = (new_surface_state & GDK_SURFACE_STATE_FULLSCREEN) ? 1 : 0; } if (changed_mask & GDK_SURFACE_STATE_MAXIMIZED) { priv->maximized = (new_surface_state & GDK_SURFACE_STATE_MAXIMIZED) ? 1 : 0; g_object_notify_by_pspec (G_OBJECT (widget), window_props[PROP_IS_MAXIMIZED]); } update_edge_constraints (window, new_surface_state); if (changed_mask & (GDK_SURFACE_STATE_FULLSCREEN | GDK_SURFACE_STATE_MAXIMIZED | GDK_SURFACE_STATE_TILED | GDK_SURFACE_STATE_TOP_TILED | GDK_SURFACE_STATE_RIGHT_TILED | GDK_SURFACE_STATE_BOTTOM_TILED | GDK_SURFACE_STATE_LEFT_TILED)) { update_window_style_classes (window); update_window_buttons (window); gtk_widget_queue_resize (widget); } } static void surface_size_changed (GtkWidget *widget, int width, int height) { gtk_window_configure (GTK_WINDOW (widget), width, height); } static gboolean surface_render (GdkSurface *surface, cairo_region_t *region, GtkWidget *widget) { gtk_widget_render (widget, surface, region); return TRUE; } static gboolean surface_event (GdkSurface *surface, GdkEvent *event, GtkWidget *widget) { gtk_main_do_event (event); return TRUE; } /* the accel_key and accel_mods fields of the key have to be setup * upon calling this function. it’ll then return whether that key * is at all used as accelerator, and if so will OR in the * accel_flags member of the key. */ gboolean _gtk_window_query_nonaccels (GtkWindow *window, guint accel_key, GdkModifierType accel_mods) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); /* movement keys are considered locked accels */ if (!accel_mods) { static const guint bindings[] = { GDK_KEY_space, GDK_KEY_KP_Space, GDK_KEY_Return, GDK_KEY_ISO_Enter, GDK_KEY_KP_Enter, GDK_KEY_Up, GDK_KEY_KP_Up, GDK_KEY_Down, GDK_KEY_KP_Down, GDK_KEY_Left, GDK_KEY_KP_Left, GDK_KEY_Right, GDK_KEY_KP_Right, GDK_KEY_Tab, GDK_KEY_KP_Tab, GDK_KEY_ISO_Left_Tab, }; guint i; for (i = 0; i < G_N_ELEMENTS (bindings); i++) if (bindings[i] == accel_key) return TRUE; } /* mnemonics are considered locked accels */ if (accel_mods == priv->mnemonic_modifier) { GtkMnemonicHash *mnemonic_hash = gtk_window_get_mnemonic_hash (window, FALSE); if (mnemonic_hash && _gtk_mnemonic_hash_lookup (mnemonic_hash, accel_key)) return TRUE; } return FALSE; } /** * gtk_window_propagate_key_event: * @window: a #GtkWindow * @event: a #GdkEventKey * * Propagate a key press or release event to the focus widget and * up the focus container chain until a widget handles @event. * This is normally called by the default ::key_press_event and * ::key_release_event handlers for toplevel windows, * however in some cases it may be useful to call this directly when * overriding the standard key handling for a toplevel window. * * Returns: %TRUE if a widget in the focus chain handled the event. */ gboolean gtk_window_propagate_key_event (GtkWindow *window, GdkEventKey *event) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gboolean handled = FALSE; GtkWidget *widget, *focus; g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); widget = GTK_WIDGET (window); focus = priv->focus_widget; if (focus) g_object_ref (focus); while (!handled && focus && focus != widget && gtk_widget_get_root (focus) == GTK_ROOT (widget)) { GtkWidget *parent; if (gtk_widget_is_sensitive (focus)) { handled = gtk_widget_event (focus, (GdkEvent*) event); if (handled) break; } parent = _gtk_widget_get_parent (focus); if (parent) g_object_ref (parent); g_object_unref (focus); focus = parent; } if (focus) g_object_unref (focus); return handled; } static GtkWindowRegion get_active_region_type (GtkWindow *window, gint x, gint y) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkAllocation allocation; gint i; if (priv->client_decorated) { for (i = 0; i < 8; i++) { if (edge_under_coordinates (window, x, y, i)) return i; } } if (priv->title_box != NULL && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box)) { gtk_widget_get_allocation (priv->title_box, &allocation); if (allocation.x <= x && allocation.x + allocation.width > x && allocation.y <= y && allocation.y + allocation.height > y) return GTK_WINDOW_REGION_TITLE; } return GTK_WINDOW_REGION_CONTENT; } static void gtk_window_real_activate_focus (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->focus_widget && gtk_widget_is_sensitive (priv->focus_widget)) gtk_widget_activate (priv->focus_widget); } static gboolean gtk_window_has_mnemonic_modifier_pressed (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *seats, *s; gboolean retval = FALSE; if (!priv->mnemonic_modifier) return FALSE; seats = gdk_display_list_seats (gtk_widget_get_display (GTK_WIDGET (window))); for (s = seats; s; s = s->next) { GdkDevice *dev = gdk_seat_get_pointer (s->data); GdkModifierType mask; gdk_device_get_state (dev, priv->surface, NULL, &mask); if (priv->mnemonic_modifier == (mask & gtk_accelerator_get_default_mod_mask ())) { retval = TRUE; break; } } g_list_free (seats); return retval; } static void gtk_window_focus_in (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); /* It appears spurious focus in events can occur when * the window is hidden. So we'll just check to see if * the window is visible before actually handling the * event */ if (gtk_widget_get_visible (widget)) { _gtk_window_set_is_active (window, TRUE); if (gtk_window_has_mnemonic_modifier_pressed (window)) _gtk_window_schedule_mnemonics_visible (window); } } static void gtk_window_focus_out (GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (widget); _gtk_window_set_is_active (window, FALSE); /* set the mnemonic-visible property to false */ gtk_window_set_mnemonics_visible (window, FALSE); } static void update_mnemonics_visible (GtkWindow *window, guint keyval, GdkModifierType state, gboolean visible) { if ((keyval == GDK_KEY_Alt_L || keyval == GDK_KEY_Alt_R) && ((state & (gtk_accelerator_get_default_mod_mask ()) & ~(GDK_MOD1_MASK)) == 0)) { if (visible) _gtk_window_schedule_mnemonics_visible (window); else gtk_window_set_mnemonics_visible (window, FALSE); } } static gboolean gtk_window_key_pressed (GtkWidget *widget, guint keyval, guint keycode, GdkModifierType state, gpointer data) { GtkWindow *window = GTK_WINDOW (widget); gtk_window_set_focus_visible (window, TRUE); update_mnemonics_visible (window, keyval, state, TRUE); return FALSE; } static gboolean gtk_window_key_released (GtkWidget *widget, guint keyval, guint keycode, GdkModifierType state, gpointer data) { GtkWindow *window = GTK_WINDOW (widget); update_mnemonics_visible (window, keyval, state, FALSE); return FALSE; } static GtkWindowPopover * _gtk_window_has_popover (GtkWindow *window, GtkWidget *widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *link; for (link = priv->popovers.head; link; link = link->next) { GtkWindowPopover *popover = link->data; if (popover->widget == widget) return popover; } return NULL; } static void gtk_window_remove (GtkContainer *container, GtkWidget *widget) { GtkWindow *window = GTK_WINDOW (container); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (widget == priv->title_box) unset_titlebar (window); else if (_gtk_window_has_popover (window, widget)) _gtk_window_remove_popover (window, widget); else GTK_CONTAINER_CLASS (gtk_window_parent_class)->remove (container, widget); } void gtk_window_check_resize (GtkWindow *self) { GtkWidget *widget = GTK_WIDGET (self); if (!_gtk_widget_get_alloc_needed (widget)) gtk_widget_ensure_allocate (widget); else if (gtk_widget_get_visible (widget)) gtk_window_move_resize (self); } static void gtk_window_forall (GtkContainer *container, GtkCallback callback, gpointer callback_data) { GtkWindow *window = GTK_WINDOW (container); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *child; child = gtk_bin_get_child (GTK_BIN (container)); if (child != NULL) (* callback) (child, callback_data); if (priv->title_box != NULL && priv->titlebar == NULL) (* callback) (priv->title_box, callback_data); } static gboolean gtk_window_focus (GtkWidget *widget, GtkDirectionType direction) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkBin *bin; GtkContainer *container; GtkWidget *child; GtkWidget *old_focus_child; GtkWidget *parent; container = GTK_CONTAINER (widget); bin = GTK_BIN (widget); old_focus_child = gtk_widget_get_focus_child (widget); /* We need a special implementation here to deal properly with wrapping * around in the tab chain without the danger of going into an * infinite loop. */ if (old_focus_child) { if (gtk_widget_child_focus (old_focus_child, direction)) return TRUE; } if (priv->focus_widget) { if (direction == GTK_DIR_LEFT || direction == GTK_DIR_RIGHT || direction == GTK_DIR_UP || direction == GTK_DIR_DOWN) { return FALSE; } /* Wrapped off the end, clear the focus setting for the toplpevel */ parent = _gtk_widget_get_parent (priv->focus_widget); while (parent) { gtk_widget_set_focus_child (parent, NULL); parent = _gtk_widget_get_parent (parent); } gtk_window_set_focus (GTK_WINDOW (container), NULL); } /* Now try to focus the first widget in the window, * taking care to hook titlebar widgets into the * focus chain. */ if (priv->title_box != NULL && old_focus_child != NULL && priv->title_box != old_focus_child) child = priv->title_box; else child = gtk_bin_get_child (bin); if (child) { if (gtk_widget_child_focus (child, direction)) return TRUE; else if (priv->title_box != NULL && priv->title_box != child && gtk_widget_child_focus (priv->title_box, direction)) return TRUE; else if (priv->title_box == child && gtk_widget_child_focus (gtk_bin_get_child (bin), direction)) return TRUE; } return FALSE; } static void gtk_window_move_focus (GtkWidget *widget, GtkDirectionType dir) { gtk_widget_child_focus (widget, dir); if (!gtk_widget_get_focus_child (widget)) gtk_window_set_focus (GTK_WINDOW (widget), NULL); } /** * gtk_window_set_focus: * @window: a #GtkWindow * @focus: (allow-none): widget to be the new focus widget, or %NULL to unset * any focus widget for the toplevel window. * * If @focus is not the current focus widget, and is focusable, sets * it as the focus widget for the window. If @focus is %NULL, unsets * the focus widget for this window. To set the focus to a particular * widget in the toplevel, it is usually more convenient to use * gtk_widget_grab_focus() instead of this function. **/ void gtk_window_set_focus (GtkWindow *window, GtkWidget *focus) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *old_focus = NULL; GdkSeat *seat; GdkDevice *device; GdkEvent *event; g_return_if_fail (GTK_IS_WINDOW (window)); if (focus && !gtk_widget_is_sensitive (focus)) return; if (focus == priv->focus_widget) return; if (priv->focus_widget) old_focus = g_object_ref (priv->focus_widget); g_set_object (&priv->focus_widget, NULL); seat = gdk_display_get_default_seat (gtk_widget_get_display (GTK_WIDGET (window))); device = gdk_seat_get_keyboard (seat); event = gdk_event_new (GDK_FOCUS_CHANGE); gdk_event_set_display (event, gtk_widget_get_display (GTK_WIDGET (window))); gdk_event_set_device (event, device); event->any.surface = priv->surface; if (event->any.surface) g_object_ref (event->any.surface); gtk_synthesize_crossing_events (GTK_ROOT (window), old_focus, focus, event, GDK_CROSSING_NORMAL); g_object_unref (event); g_set_object (&priv->focus_widget, focus); g_clear_object (&old_focus); g_object_notify (G_OBJECT (window), "focus-widget"); } static void gtk_window_state_flags_changed (GtkWidget *widget, GtkStateFlags previous_state) { GtkWindow *window = GTK_WINDOW (widget); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkStateFlags state; state = gtk_widget_get_state_flags (widget); gtk_css_node_set_state (priv->decoration_node, state); GTK_WIDGET_CLASS (gtk_window_parent_class)->state_flags_changed (widget, previous_state); } static void gtk_window_style_updated (GtkWidget *widget) { GtkCssStyleChange *change = gtk_style_context_get_change (gtk_widget_get_style_context (widget)); GtkWindow *window = GTK_WINDOW (widget); GTK_WIDGET_CLASS (gtk_window_parent_class)->style_updated (widget); if (!_gtk_widget_get_alloc_needed (widget) && (change == NULL || gtk_css_style_change_changes_property (change, GTK_CSS_PROPERTY_BACKGROUND_COLOR))) { GtkAllocation allocation; GtkBorder window_border; gtk_widget_get_allocation (widget, &allocation); get_shadow_width (window, &window_border); update_opaque_region (window, &window_border, &allocation); } if (change == NULL || gtk_css_style_change_changes_property (change, GTK_CSS_PROPERTY_ICON_THEME)) update_themed_icon (window); } /** * _gtk_window_unset_focus_and_default: * @window: a #GtkWindow * @widget: a widget inside of @window * * Checks whether the focus and default widgets of @window are * @widget or a descendent of @widget, and if so, unset them. **/ void _gtk_window_unset_focus_and_default (GtkWindow *window, GtkWidget *widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *child; GtkWidget *parent; g_object_ref (window); g_object_ref (widget); parent = _gtk_widget_get_parent (widget); if (gtk_widget_get_focus_child (parent) == widget) { child = priv->focus_widget; while (child && child != widget) child = _gtk_widget_get_parent (child); if (child == widget) gtk_window_set_focus (GTK_WINDOW (window), NULL); } child = priv->default_widget; while (child && child != widget) child = _gtk_widget_get_parent (child); if (child == widget) gtk_window_set_default_widget (window, NULL); g_object_unref (widget); g_object_unref (window); } static void popup_menu_detach (GtkWidget *widget, GtkMenu *menu) { GtkWindowPrivate *priv = gtk_window_get_instance_private (GTK_WINDOW (widget)); priv->popup_menu = NULL; } static GdkSurfaceState gtk_window_get_state (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->surface) return gdk_surface_get_state (priv->surface); return 0; } static void restore_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = GTK_WINDOW (user_data); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GdkSurfaceState state; if (priv->maximized) { gtk_window_unmaximize (window); return; } state = gtk_window_get_state (window); if (state & GDK_SURFACE_STATE_ICONIFIED) gtk_window_deiconify (window); } static void move_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = GTK_WINDOW (user_data); gtk_window_begin_move_drag (window, 0, /* 0 means "use keyboard" */ 0, 0, GDK_CURRENT_TIME); } static void resize_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = GTK_WINDOW (user_data); gtk_window_begin_resize_drag (window, 0, 0, /* 0 means "use keyboard" */ 0, 0, GDK_CURRENT_TIME); } static void minimize_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = GTK_WINDOW (user_data); GtkWindowPrivate *priv = gtk_window_get_instance_private (window); /* Turns out, we can't iconify a maximized window */ if (priv->maximized) gtk_window_unmaximize (window); gtk_window_iconify (window); } static void maximize_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = GTK_WINDOW (user_data); GdkSurfaceState state; state = gtk_window_get_state (window); if (state & GDK_SURFACE_STATE_ICONIFIED) gtk_window_deiconify (window); gtk_window_maximize (window); } static void ontop_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = (GtkWindow *)user_data; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gtk_window_set_keep_above (window, !priv->above_initially); } static void close_window_clicked (GtkMenuItem *menuitem, gpointer user_data) { GtkWindow *window = (GtkWindow *)user_data; gtk_window_close (window); } static void gtk_window_do_popup_fallback (GtkWindow *window, GdkEventButton *event) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *menuitem; GdkSurfaceState state; gboolean maximized, iconified; if (priv->popup_menu) gtk_widget_destroy (priv->popup_menu); state = gtk_window_get_state (window); iconified = (state & GDK_SURFACE_STATE_ICONIFIED) == GDK_SURFACE_STATE_ICONIFIED; maximized = priv->maximized && !iconified; priv->popup_menu = gtk_menu_new (); gtk_style_context_add_class (gtk_widget_get_style_context (priv->popup_menu), GTK_STYLE_CLASS_CONTEXT_MENU); gtk_menu_attach_to_widget (GTK_MENU (priv->popup_menu), GTK_WIDGET (window), popup_menu_detach); menuitem = gtk_menu_item_new_with_label (_("Restore")); gtk_widget_show (menuitem); /* "Restore" means "Unmaximize" or "Unminimize" * (yes, some WMs allow window menu to be shown for minimized windows). * Not restorable: * - visible windows that are not maximized or minimized * - non-resizable windows that are not minimized * - non-normal windows */ if ((gtk_widget_is_visible (GTK_WIDGET (window)) && !(maximized || iconified)) || (!iconified && !priv->resizable) || priv->type_hint != GDK_SURFACE_TYPE_HINT_NORMAL) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (restore_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_menu_item_new_with_label (_("Move")); gtk_widget_show (menuitem); if (maximized || iconified) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (move_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_menu_item_new_with_label (_("Resize")); gtk_widget_show (menuitem); if (!priv->resizable || maximized || iconified) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (resize_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_menu_item_new_with_label (_("Minimize")); gtk_widget_show (menuitem); if (iconified || priv->type_hint != GDK_SURFACE_TYPE_HINT_NORMAL) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (minimize_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_menu_item_new_with_label (_("Maximize")); gtk_widget_show (menuitem); if (maximized || !priv->resizable || priv->type_hint != GDK_SURFACE_TYPE_HINT_NORMAL) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (maximize_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_check_menu_item_new_with_label (_("Always on Top")); gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (menuitem), priv->above_initially); if (maximized) gtk_widget_set_sensitive (menuitem, FALSE); gtk_widget_show (menuitem); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (ontop_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_separator_menu_item_new (); gtk_widget_show (menuitem); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); menuitem = gtk_menu_item_new_with_label (_("Close")); gtk_widget_show (menuitem); if (!priv->deletable) gtk_widget_set_sensitive (menuitem, FALSE); g_signal_connect (G_OBJECT (menuitem), "activate", G_CALLBACK (close_window_clicked), window); gtk_menu_shell_append (GTK_MENU_SHELL (priv->popup_menu), menuitem); gtk_menu_popup_at_pointer (GTK_MENU (priv->popup_menu), (GdkEvent *) event); } static void gtk_window_do_popup (GtkWindow *window, GdkEventButton *event) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (!gdk_surface_show_window_menu (priv->surface, (GdkEvent *) event)) gtk_window_do_popup_fallback (window, event); } /********************************* * Functions related to resizing * *********************************/ /* This function doesn't constrain to geometry hints */ static void gtk_window_compute_configure_request_size (GtkWindow *window, GdkGeometry *geometry, guint flags, gint *width, gint *height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowGeometryInfo *info; int w, h; /* Preconditions: * - we've done a size request */ info = gtk_window_get_geometry_info (window, FALSE); if (priv->need_default_size) { gtk_window_guess_default_size (window, width, height); gtk_window_get_remembered_size (window, &w, &h); *width = MAX (*width, w); *height = MAX (*height, h); /* Override with default size */ if (info) { /* Take width of shadows/headerbar into account. We want to set the * default size of the content area and not the window area. */ gint default_width_csd = info->default_width; gint default_height_csd = info->default_height; gtk_window_update_csd_size (window, &default_width_csd, &default_height_csd, INCLUDE_CSD_SIZE); if (info->default_width > 0) *width = default_width_csd; if (info->default_height > 0) *height = default_height_csd; } } else { /* Default to keeping current size */ gtk_window_get_remembered_size (window, width, height); } /* Override any size with gtk_window_resize() values */ if (priv->maximized || priv->fullscreen) { /* Unless we are maximized or fullscreen */ gtk_window_get_remembered_size (window, width, height); } else if (info) { gint resize_width_csd = info->resize_width; gint resize_height_csd = info->resize_height; gtk_window_update_csd_size (window, &resize_width_csd, &resize_height_csd, INCLUDE_CSD_SIZE); if (info->resize_width > 0) *width = resize_width_csd; if (info->resize_height > 0) *height = resize_height_csd; } /* Don't ever request zero width or height, it's not supported by gdk. The size allocation code will round it to 1 anyway but if we do it then the value returned from this function will is not comparable to the size allocation read from the GtkWindow. */ *width = MAX (*width, 1); *height = MAX (*height, 1); } static void gtk_window_compute_configure_request (GtkWindow *window, GdkRectangle *request, GdkGeometry *geometry, guint *flags) { GdkGeometry new_geometry; guint new_flags; int w, h; GtkWindowGeometryInfo *info; int x, y; gtk_window_compute_hints (window, &new_geometry, &new_flags); gtk_window_compute_configure_request_size (window, &new_geometry, new_flags, &w, &h); gtk_window_update_fixed_size (window, &new_geometry, w, h); gtk_window_constrain_size (window, &new_geometry, new_flags, w, h, &w, &h); info = gtk_window_get_geometry_info (window, FALSE); /* by default, don't change position requested */ if (info) { x = info->last.configure_request.x; y = info->last.configure_request.y; } else { x = 0; y = 0; } request->x = x; request->y = y; request->width = w; request->height = h; if (geometry) *geometry = new_geometry; if (flags) *flags = new_flags; } static void gtk_window_move_resize (GtkWindow *window) { /* Overview: * * First we determine whether any information has changed that would * cause us to revise our last configure request. If we would send * a different configure request from last time, then * configure_request_size_changed = TRUE or * configure_request_pos_changed = TRUE. configure_request_size_changed * may be true due to new hints, a gtk_window_resize(), or whatever. * configure_request_pos_changed may be true due to gtk_window_set_position() * or gtk_window_move(). * * If the configure request has changed, we send off a new one. To * ensure GTK+ invariants are maintained (resize queue does what it * should), we go ahead and size_allocate the requested size in this * function. * * If the configure request has not changed, we don't ever resend * it, because it could mean fighting the user or window manager. * * To prepare the configure request, we come up with a base size/pos: * - the one from gtk_window_move()/gtk_window_resize() * - else default_width, default_height if we haven't ever * been mapped * - else the size request if we haven't ever been mapped, * as a substitute default size * - else the current size of the window, as received from * configure notifies (i.e. the current allocation) */ GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; GtkWindowGeometryInfo *info; GdkGeometry new_geometry; guint new_flags; GdkRectangle new_request; gboolean configure_request_size_changed; gboolean configure_request_pos_changed; gboolean hints_changed; /* do we need to send these again */ GtkWindowLastGeometryInfo saved_last_info; int current_width, current_height; widget = GTK_WIDGET (window); info = gtk_window_get_geometry_info (window, TRUE); configure_request_size_changed = FALSE; configure_request_pos_changed = FALSE; hints_changed = FALSE; gtk_window_compute_configure_request (window, &new_request, &new_geometry, &new_flags); /* This check implies the invariant that we never set info->last * without setting the hints and sending off a configure request. * * If we change info->last without sending the request, we may * miss a request. */ if (info->last.configure_request.x != new_request.x || info->last.configure_request.y != new_request.y) configure_request_pos_changed = TRUE; if ((info->last.configure_request.width != new_request.width || info->last.configure_request.height != new_request.height)) configure_request_size_changed = TRUE; if (!gtk_window_compare_hints (&info->last.geometry, info->last.flags, &new_geometry, new_flags)) hints_changed = TRUE; #if 0 if (priv->type == GTK_WINDOW_TOPLEVEL) { GtkAllocation alloc; gtk_widget_get_allocation (widget, &alloc); g_message ("--- %s ---\n" "last : %d,%d\t%d x %d\n" "this : %d,%d\t%d x %d\n" "alloc : %d,%d\t%d x %d\n" "resize: \t%d x %d\n" "size_changed: %d pos_changed: %d hints_changed: %d\n" "configure_notify_received: %d\n" "configure_request_count: %d\n" "position_constraints_changed: %d", priv->title ? priv->title : "(no title)", info->last.configure_request.x, info->last.configure_request.y, info->last.configure_request.width, info->last.configure_request.height, new_request.x, new_request.y, new_request.width, new_request.height, alloc.x, alloc.y, alloc.width, alloc.height, info->resize_width, info->resize_height, configure_request_size_changed, configure_request_pos_changed, hints_changed, priv->configure_notify_received, priv->configure_request_count, info->position_constraints_changed); } #endif saved_last_info = info->last; info->last.geometry = new_geometry; info->last.flags = new_flags; info->last.configure_request = new_request; /* need to set PPosition so the WM will look at our position, * but we don't want to count PPosition coming and going as a hints * change for future iterations. So we saved info->last prior to * this. */ /* Also, if the initial position was explicitly set, then we always * toggle on PPosition. This makes gtk_window_move(window, 0, 0) * work. */ if (configure_request_pos_changed) { new_flags |= GDK_HINT_POS; hints_changed = TRUE; } /* Set hints if necessary */ if (hints_changed) gdk_surface_set_geometry_hints (priv->surface, &new_geometry, new_flags); current_width = gdk_surface_get_width (priv->surface); current_height = gdk_surface_get_height (priv->surface); /* handle resizing/moving and widget tree allocation */ if (priv->configure_notify_received) { GtkAllocation allocation; int min; /* If we have received a configure event since * the last time in this function, we need to * accept our new size and size_allocate child widgets. * (see gtk_window_configure_event() for more details). * * 1 or more configure notifies may have been received. * Also, configure_notify_received will only be TRUE * if all expected configure notifies have been received * (one per configure request), as an optimization. * */ priv->configure_notify_received = FALSE; allocation.x = 0; allocation.y = 0; gtk_widget_measure (widget, GTK_ORIENTATION_HORIZONTAL, -1, &min, NULL, NULL, NULL); allocation.width = MAX (min, current_width); gtk_widget_measure (widget, GTK_ORIENTATION_VERTICAL, allocation.width, &min, NULL, NULL, NULL); allocation.height = MAX (min, current_height); gtk_widget_size_allocate (widget, &allocation, -1); /* If the configure request changed, it means that * we either: * 1) coincidentally changed hints or widget properties * impacting the configure request before getting * a configure notify, or * 2) some broken widget is changing its size request * during size allocation, resulting in * a false appearance of changed configure request. * * For 1), we could just go ahead and ask for the * new size right now, but doing that for 2) * might well be fighting the user (and can even * trigger a loop). Since we really don't want to * do that, we requeue a resize in hopes that * by the time it gets handled, the child has seen * the light and is willing to go along with the * new size. (this happens for the zvt widget, since * the size_allocate() above will have stored the * requisition corresponding to the new size in the * zvt widget) * * This doesn't buy us anything for 1), but it shouldn't * hurt us too badly, since it is what would have * happened if we had gotten the configure event before * the new size had been set. */ if (configure_request_size_changed || configure_request_pos_changed) { /* Don't change the recorded last info after all, because we * haven't actually updated to the new info yet - we decided * to postpone our configure request until later. */ info->last = saved_last_info; gtk_widget_queue_resize_no_redraw (widget); /* might recurse for GTK_RESIZE_IMMEDIATE */ } return; /* Bail out, we didn't really process the move/resize */ } else if ((configure_request_size_changed || hints_changed) && (current_width != new_request.width || current_height != new_request.height)) { /* We are in one of the following situations: * A. configure_request_size_changed * our requisition has changed and we need a different window size, * so we request it from the window manager. * B. !configure_request_size_changed && hints_changed * the window manager rejects our size, but we have just changed the * window manager hints, so there's a chance our request will * be honoured this time, so we try again. * * However, if the new requisition is the same as the current allocation, * we don't request it again, since we won't get a ConfigureNotify back from * the window manager unless it decides to change our requisition. If * we don't get the ConfigureNotify back, the resize queue will never be run. */ if (priv->type != GTK_WINDOW_POPUP) { /* Increment the number of have-not-yet-received-notify requests. * This is done before gdk_surface[_move]_resize(), because * that call might be synchronous (depending on which GDK backend * is being used), so any preparations for its effects must * be done beforehand. */ priv->configure_request_count += 1; gdk_surface_freeze_toplevel_updates (priv->surface); /* for GTK_RESIZE_QUEUE toplevels, we are now awaiting a new * configure event in response to our resizing request. * the configure event will cause a new resize with * ->configure_notify_received=TRUE. * until then, we want to * - discard expose events * - coalesce resizes for our children * - defer any window resizes until the configure event arrived * to achieve this, we queue a resize for the window, but remove its * resizing handler, so resizing will not be handled from the next * idle handler but when the configure event arrives. * * FIXME: we should also dequeue the pending redraws here, since * we handle those ourselves upon ->configure_notify_received==TRUE. */ } /* Now send the configure request */ if (configure_request_pos_changed) g_warning ("configure request position changed. This should not happen. Ignoring the position"); gdk_surface_resize (priv->surface, new_request.width, new_request.height); if (priv->type == GTK_WINDOW_POPUP) { GtkAllocation allocation; /* Directly size allocate for override redirect (popup) windows. */ allocation.x = 0; allocation.y = 0; allocation.width = new_request.width; allocation.height = new_request.height; gtk_widget_size_allocate (widget, &allocation, -1); } } else { GtkAllocation allocation; int min_width, min_height; /* Handle any position changes. */ if (configure_request_pos_changed) g_warning ("configure request position changed. This should not happen. Ignoring the position"); gtk_widget_measure (widget, GTK_ORIENTATION_HORIZONTAL, current_height, &min_width, NULL, NULL, NULL); gtk_widget_measure (widget, GTK_ORIENTATION_VERTICAL, current_width, &min_height, NULL, NULL, NULL); /* Our configure request didn't change size, but maybe some of * our child widgets have. Run a size allocate with our current * size to make sure that we re-layout our child widgets. */ allocation.x = 0; allocation.y = 0; allocation.width = MAX (current_width, min_width); allocation.height = MAX (current_height, min_height); gtk_widget_size_allocate (widget, &allocation, -1); } info->resize_width = -1; info->resize_height = -1; } /* Compare two sets of Geometry hints for equality. */ static gboolean gtk_window_compare_hints (GdkGeometry *geometry_a, guint flags_a, GdkGeometry *geometry_b, guint flags_b) { if (flags_a != flags_b) return FALSE; if ((flags_a & GDK_HINT_MIN_SIZE) && (geometry_a->min_width != geometry_b->min_width || geometry_a->min_height != geometry_b->min_height)) return FALSE; if ((flags_a & GDK_HINT_MAX_SIZE) && (geometry_a->max_width != geometry_b->max_width || geometry_a->max_height != geometry_b->max_height)) return FALSE; if ((flags_a & GDK_HINT_BASE_SIZE) && (geometry_a->base_width != geometry_b->base_width || geometry_a->base_height != geometry_b->base_height)) return FALSE; if ((flags_a & GDK_HINT_ASPECT) && (geometry_a->min_aspect != geometry_b->min_aspect || geometry_a->max_aspect != geometry_b->max_aspect)) return FALSE; if ((flags_a & GDK_HINT_RESIZE_INC) && (geometry_a->width_inc != geometry_b->width_inc || geometry_a->height_inc != geometry_b->height_inc)) return FALSE; if ((flags_a & GDK_HINT_WIN_GRAVITY) && geometry_a->win_gravity != geometry_b->win_gravity) return FALSE; return TRUE; } static void gtk_window_constrain_size (GtkWindow *window, GdkGeometry *geometry, guint flags, gint width, gint height, gint *new_width, gint *new_height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); guint geometry_flags; /* ignore size increments for windows that fit in a fixed space */ if (priv->maximized || priv->fullscreen || priv->tiled) geometry_flags = flags & ~GDK_HINT_RESIZE_INC; else geometry_flags = flags; gdk_surface_constrain_size (geometry, geometry_flags, width, height, new_width, new_height); } /* For non-resizable windows, make sure the given width/height fits * in the geometry contrains and update the geometry hints to match * the given width/height if not. * This is to make sure that non-resizable windows get the default * width/height if set, but can still grow if their content requires. * * Note: Fixed size windows with a default size set will not shrink * smaller than the default size when their content requires less size. */ static void gtk_window_update_fixed_size (GtkWindow *window, GdkGeometry *new_geometry, gint new_width, gint new_height) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowGeometryInfo *info; gboolean has_size_request; /* Adjust the geometry hints for non-resizable windows only */ has_size_request = gtk_widget_has_size_request (GTK_WIDGET (window)); if (priv->resizable || has_size_request) return; info = gtk_window_get_geometry_info (window, FALSE); if (info) { gint default_width_csd = info->default_width; gint default_height_csd = info->default_height; gtk_window_update_csd_size (window, &default_width_csd, &default_height_csd, INCLUDE_CSD_SIZE); if (info->default_width > -1) { gint w = MAX (MAX (default_width_csd, new_width), new_geometry->min_width); new_geometry->min_width = w; new_geometry->max_width = w; } if (info->default_height > -1) { gint h = MAX (MAX (default_height_csd, new_height), new_geometry->min_height); new_geometry->min_height = h; new_geometry->max_height = h; } } } /* Compute the set of geometry hints and flags for a window * based on the application set geometry, and requisition * of the window. gtk_widget_get_preferred_size() must have been * called first. */ static void gtk_window_compute_hints (GtkWindow *window, GdkGeometry *new_geometry, guint *new_flags) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; GtkRequisition requisition; widget = GTK_WIDGET (window); /* Use a good size for unresizable widgets, otherwise the minimum one. */ if (priv->resizable) gtk_widget_get_preferred_size (widget, &requisition, NULL); else gtk_window_guess_default_size (window, &requisition.width, &requisition.height); /* We don't want to set GDK_HINT_POS in here, we just set it * in gtk_window_move_resize() when we want the position * honored. */ *new_flags = 0; /* For simplicity, we always set the base hint, even when we * don't expect it to have any visible effect. * (Note: geometry_size_to_pixels() depends on this.) */ *new_flags |= GDK_HINT_BASE_SIZE; new_geometry->base_width = 0; new_geometry->base_height = 0; *new_flags |= GDK_HINT_MIN_SIZE; new_geometry->min_width = requisition.width; new_geometry->min_height = requisition.height; if (!priv->resizable) { *new_flags |= GDK_HINT_MAX_SIZE; new_geometry->max_width = new_geometry->min_width; new_geometry->max_height = new_geometry->min_height; } *new_flags |= GDK_HINT_WIN_GRAVITY; new_geometry->win_gravity = priv->gravity; } #undef INCLUDE_CSD_SIZE #undef EXCLUDE_CSD_SIZE /*********************** * Redrawing functions * ***********************/ static void gtk_window_snapshot (GtkWidget *widget, GtkSnapshot *snapshot) { GtkWindowPrivate *priv = gtk_window_get_instance_private (GTK_WINDOW (widget)); GtkStyleContext *context; GtkBorder window_border; gint title_height; GList *l; int width, height; GtkWidget *child; context = gtk_widget_get_style_context (widget); get_shadow_width (GTK_WINDOW (widget), &window_border); width = gtk_widget_get_width (widget); height = gtk_widget_get_height (widget); if (priv->client_decorated && priv->decorated && !priv->fullscreen && !priv->maximized) { gtk_style_context_save_to_node (context, priv->decoration_node); if (priv->use_client_shadow) { GtkBorder padding, border; gtk_style_context_get_padding (context, &padding); gtk_style_context_get_border (context, &border); sum_borders (&border, &padding); gtk_snapshot_render_background (snapshot, context, window_border.left - border.left, window_border.top - border.top, width - (window_border.left + window_border.right - border.left - border.right), height - (window_border.top + window_border.bottom - border.top - border.bottom)); gtk_snapshot_render_frame (snapshot, context, window_border.left - border.left, window_border.top - border.top, width - (window_border.left + window_border.right - border.left - border.right), height - (window_border.top + window_border.bottom - border.top - border.bottom)); } else { gtk_snapshot_render_background (snapshot, context, 0, 0, width, height); gtk_snapshot_render_frame (snapshot, context, 0, 0, width, height); } gtk_style_context_restore (context); } if (priv->title_box && gtk_widget_get_visible (priv->title_box) && gtk_widget_get_child_visible (priv->title_box)) title_height = priv->title_height; else title_height = 0; gtk_snapshot_render_background (snapshot, context, window_border.left, window_border.top + title_height, width - (window_border.left + window_border.right), height - (window_border.top + window_border.bottom + title_height)); gtk_snapshot_render_frame (snapshot, context, window_border.left, window_border.top + title_height, width - (window_border.left + window_border.right), height - (window_border.top + window_border.bottom + title_height)); for (child = _gtk_widget_get_first_child (widget); child != NULL; child = _gtk_widget_get_next_sibling (child)) { /* Handle popovers separately until their stacking order is fixed */ if (!GTK_IS_POPOVER (child)) gtk_widget_snapshot_child (widget, child, snapshot); } for (l = priv->popovers.head; l; l = l->next) { GtkWindowPopover *data = l->data; gtk_widget_snapshot_child (widget, data->widget, snapshot); } } /** * gtk_window_present: * @window: a #GtkWindow * * Presents a window to the user. This function should not be used * as when it is called, it is too late to gather a valid timestamp * to allow focus stealing prevention to work correctly. **/ void gtk_window_present (GtkWindow *window) { gtk_window_present_with_time (window, GDK_CURRENT_TIME); } /** * gtk_window_present_with_time: * @window: a #GtkWindow * @timestamp: the timestamp of the user interaction (typically a * button or key press event) which triggered this call * * Presents a window to the user. This may mean raising the window * in the stacking order, deiconifying it, moving it to the current * desktop, and/or giving it the keyboard focus, possibly dependent * on the user’s platform, window manager, and preferences. * * If @window is hidden, this function calls gtk_widget_show() * as well. * * This function should be used when the user tries to open a window * that’s already open. Say for example the preferences dialog is * currently open, and the user chooses Preferences from the menu * a second time; use gtk_window_present() to move the already-open dialog * where the user can see it. * * Presents a window to the user in response to a user interaction. The * timestamp should be gathered when the window was requested to be shown * (when clicking a link for example), rather than once the window is * ready to be shown. **/ void gtk_window_present_with_time (GtkWindow *window, guint32 timestamp) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; GdkSurface *surface; g_return_if_fail (GTK_IS_WINDOW (window)); widget = GTK_WIDGET (window); if (gtk_widget_get_visible (widget)) { surface = priv->surface; g_assert (surface != NULL); gdk_surface_show (surface); /* Translate a timestamp of GDK_CURRENT_TIME appropriately */ if (timestamp == GDK_CURRENT_TIME) { #ifdef GDK_WINDOWING_X11 if (GDK_IS_X11_SURFACE (surface)) { GdkDisplay *display; display = gtk_widget_get_display (widget); timestamp = gdk_x11_display_get_user_time (display); } else #endif timestamp = gtk_get_current_event_time (); } gdk_surface_focus (surface, timestamp); } else { priv->initial_timestamp = timestamp; gtk_widget_show (widget); } } /** * gtk_window_iconify: * @window: a #GtkWindow * * Asks to iconify (i.e. minimize) the specified @window. Note that * you shouldn’t assume the window is definitely iconified afterward, * because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could deiconify it * again, or there may not be a window manager in which case * iconification isn’t possible, etc. But normally the window will end * up iconified. Just don’t write code that crashes if not. * * It’s permitted to call this function before showing a window, * in which case the window will be iconified before it ever appears * onscreen. * * You can track iconification via the #GdkSurface::state property. */ void gtk_window_iconify (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->iconify_initially = TRUE; if (priv->surface) gdk_surface_iconify (priv->surface); } /** * gtk_window_deiconify: * @window: a #GtkWindow * * Asks to deiconify (i.e. unminimize) the specified @window. Note * that you shouldn’t assume the window is definitely deiconified * afterward, because other entities (e.g. the user or * [window manager][gtk-X11-arch])) could iconify it * again before your code which assumes deiconification gets to run. * * You can track iconification via the #GdkSurface::state property. **/ void gtk_window_deiconify (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->iconify_initially = FALSE; if (priv->surface) gdk_surface_deiconify (priv->surface); } /** * gtk_window_stick: * @window: a #GtkWindow * * Asks to stick @window, which means that it will appear on all user * desktops. Note that you shouldn’t assume the window is definitely * stuck afterward, because other entities (e.g. the user or * [window manager][gtk-X11-arch] could unstick it * again, and some window managers do not support sticking * windows. But normally the window will end up stuck. Just don't * write code that crashes if not. * * It’s permitted to call this function before showing a window. * * You can track iconification via the #GdkSurface::state property. **/ void gtk_window_stick (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->stick_initially = TRUE; if (priv->surface) gdk_surface_stick (priv->surface); } /** * gtk_window_unstick: * @window: a #GtkWindow * * Asks to unstick @window, which means that it will appear on only * one of the user’s desktops. Note that you shouldn’t assume the * window is definitely unstuck afterward, because other entities * (e.g. the user or [window manager][gtk-X11-arch]) could * stick it again. But normally the window will * end up stuck. Just don’t write code that crashes if not. * * You can track iconification via the #GdkSurface::state property. **/ void gtk_window_unstick (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->stick_initially = FALSE; if (priv->surface) gdk_surface_unstick (priv->surface); } /** * gtk_window_maximize: * @window: a #GtkWindow * * Asks to maximize @window, so that it becomes full-screen. Note that * you shouldn’t assume the window is definitely maximized afterward, * because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could unmaximize it * again, and not all window managers support maximization. But * normally the window will end up maximized. Just don’t write code * that crashes if not. * * It’s permitted to call this function before showing a window, * in which case the window will be maximized when it appears onscreen * initially. * * You can track iconification via the #GdkSurface::state property * or by listening to notifications on the #GtkWindow:is-maximized property. **/ void gtk_window_maximize (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->maximize_initially = TRUE; if (priv->surface) gdk_surface_maximize (priv->surface); } /** * gtk_window_unmaximize: * @window: a #GtkWindow * * Asks to unmaximize @window. Note that you shouldn’t assume the * window is definitely unmaximized afterward, because other entities * (e.g. the user or [window manager][gtk-X11-arch]) * could maximize it again, and not all window * managers honor requests to unmaximize. But normally the window will * end up unmaximized. Just don’t write code that crashes if not. * * You can track iconification via the #GdkSurface::state property **/ void gtk_window_unmaximize (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->maximize_initially = FALSE; if (priv->surface) gdk_surface_unmaximize (priv->surface); } /** * gtk_window_fullscreen: * @window: a #GtkWindow * * Asks to place @window in the fullscreen state. Note that you * shouldn’t assume the window is definitely full screen afterward, * because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could unfullscreen it * again, and not all window managers honor requests to fullscreen * windows. But normally the window will end up fullscreen. Just * don’t write code that crashes if not. * * You can track iconification via the #GdkSurface::state property **/ void gtk_window_fullscreen (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->fullscreen_initially = TRUE; if (priv->surface) gdk_surface_fullscreen (priv->surface); } static void unset_fullscreen_monitor (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->initial_fullscreen_monitor) { g_signal_handlers_disconnect_by_func (priv->initial_fullscreen_monitor, unset_fullscreen_monitor, window); g_object_unref (priv->initial_fullscreen_monitor); priv->initial_fullscreen_monitor = NULL; } } /** * gtk_window_fullscreen_on_monitor: * @window: a #GtkWindow * @monitor: which monitor to go fullscreen on * * Asks to place @window in the fullscreen state. Note that you shouldn't assume * the window is definitely full screen afterward. * * You can track iconification via the #GdkSurface::state property */ void gtk_window_fullscreen_on_monitor (GtkWindow *window, GdkMonitor *monitor) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GDK_IS_MONITOR (monitor)); g_return_if_fail (gdk_monitor_is_valid (monitor)); gtk_window_set_display (window, gdk_monitor_get_display (monitor)); unset_fullscreen_monitor (window); priv->initial_fullscreen_monitor = monitor; g_signal_connect_swapped (priv->initial_fullscreen_monitor, "invalidate", G_CALLBACK (unset_fullscreen_monitor), window); g_object_ref (priv->initial_fullscreen_monitor); priv->fullscreen_initially = TRUE; if (priv->surface) gdk_surface_fullscreen_on_monitor (priv->surface, monitor); } /** * gtk_window_unfullscreen: * @window: a #GtkWindow * * Asks to toggle off the fullscreen state for @window. Note that you * shouldn’t assume the window is definitely not full screen * afterward, because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could fullscreen it * again, and not all window managers honor requests to unfullscreen * windows. But normally the window will end up restored to its normal * state. Just don’t write code that crashes if not. * * You can track iconification via the #GdkSurface::state property **/ void gtk_window_unfullscreen (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); unset_fullscreen_monitor (window); priv->fullscreen_initially = FALSE; if (priv->surface) gdk_surface_unfullscreen (priv->surface); } /** * gtk_window_set_keep_above: * @window: a #GtkWindow * @setting: whether to keep @window above other windows * * Asks to keep @window above, so that it stays on top. Note that * you shouldn’t assume the window is definitely above afterward, * because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could not keep it above, * and not all window managers support keeping windows above. But * normally the window will end kept above. Just don’t write code * that crashes if not. * * It’s permitted to call this function before showing a window, * in which case the window will be kept above when it appears onscreen * initially. * * You can track iconification via the #GdkSurface::state property * * Note that, according to the * [Extended Window Manager Hints Specification](http://www.freedesktop.org/Standards/wm-spec), * the above state is mainly meant for user preferences and should not * be used by applications e.g. for drawing attention to their * dialogs. **/ void gtk_window_set_keep_above (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; priv->above_initially = setting; priv->below_initially &= !setting; if (priv->surface) gdk_surface_set_keep_above (priv->surface, setting); } /** * gtk_window_set_keep_below: * @window: a #GtkWindow * @setting: whether to keep @window below other windows * * Asks to keep @window below, so that it stays in bottom. Note that * you shouldn’t assume the window is definitely below afterward, * because other entities (e.g. the user or * [window manager][gtk-X11-arch]) could not keep it below, * and not all window managers support putting windows below. But * normally the window will be kept below. Just don’t write code * that crashes if not. * * It’s permitted to call this function before showing a window, * in which case the window will be kept below when it appears onscreen * initially. * * You can track iconification via the #GdkSurface::state property * * Note that, according to the * [Extended Window Manager Hints Specification](http://www.freedesktop.org/Standards/wm-spec), * the above state is mainly meant for user preferences and should not * be used by applications e.g. for drawing attention to their * dialogs. **/ void gtk_window_set_keep_below (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; priv->below_initially = setting; priv->above_initially &= !setting; if (priv->surface) gdk_surface_set_keep_below (priv->surface, setting); } /** * gtk_window_set_resizable: * @window: a #GtkWindow * @resizable: %TRUE if the user can resize this window * * Sets whether the user can resize a window. Windows are user resizable * by default. **/ void gtk_window_set_resizable (GtkWindow *window, gboolean resizable) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); resizable = (resizable != FALSE); if (priv->resizable != resizable) { priv->resizable = resizable; update_window_buttons (window); gtk_widget_queue_resize_no_redraw (GTK_WIDGET (window)); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_RESIZABLE]); } } /** * gtk_window_get_resizable: * @window: a #GtkWindow * * Gets the value set by gtk_window_set_resizable(). * * Returns: %TRUE if the user can resize the window **/ gboolean gtk_window_get_resizable (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->resizable; } /** * gtk_window_begin_resize_drag: * @window: a #GtkWindow * @button: mouse button that initiated the drag * @edge: position of the resize control * @x: X position where the user clicked to initiate the drag, in window coordinates * @y: Y position where the user clicked to initiate the drag * @timestamp: timestamp from the click event that initiated the drag * * Starts resizing a window. This function is used if an application * has window resizing controls. */ void gtk_window_begin_resize_drag (GtkWindow *window, GdkSurfaceEdge edge, gint button, gint x, gint y, guint32 timestamp) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (gtk_widget_get_visible (GTK_WIDGET (window))); gdk_surface_begin_resize_drag (priv->surface, edge, button, x, y, timestamp); } /** * gtk_window_begin_move_drag: * @window: a #GtkWindow * @button: mouse button that initiated the drag * @x: X position where the user clicked to initiate the drag, in window coordinates * @y: Y position where the user clicked to initiate the drag * @timestamp: timestamp from the click event that initiated the drag * * Starts moving a window. This function is used if an application has * window movement grips. */ void gtk_window_begin_move_drag (GtkWindow *window, gint button, gint x, gint y, guint32 timestamp) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (gtk_widget_get_visible (GTK_WIDGET (window))); gdk_surface_begin_move_drag (priv->surface, button, x, y, timestamp); } /** * gtk_window_set_display: * @window: a #GtkWindow. * @display: a #GdkDisplay. * * Sets the #GdkDisplay where the @window is displayed; if * the window is already mapped, it will be unmapped, and * then remapped on the new display. */ void gtk_window_set_display (GtkWindow *window, GdkDisplay *display) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWidget *widget; gboolean was_mapped; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GDK_IS_DISPLAY (display)); if (display == priv->display) return; /* reset initial_fullscreen_monitor since they are relative to the screen */ unset_fullscreen_monitor (window); widget = GTK_WIDGET (window); was_mapped = _gtk_widget_get_mapped (widget); if (was_mapped) gtk_widget_unmap (widget); if (_gtk_widget_get_realized (widget)) gtk_widget_unrealize (widget); if (priv->transient_parent && gtk_widget_get_display (GTK_WIDGET (priv->transient_parent)) != display) gtk_window_set_transient_for (window, NULL); gtk_window_free_key_hash (window); #ifdef GDK_WINDOWING_X11 g_signal_handlers_disconnect_by_func (gtk_settings_get_for_display (priv->display), gtk_window_on_theme_variant_changed, window); g_signal_connect (gtk_settings_get_for_display (display), "notify::gtk-application-prefer-dark-theme", G_CALLBACK (gtk_window_on_theme_variant_changed), window); #endif priv->display = display; gtk_widget_unroot (widget); gtk_widget_root (widget); g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_DISPLAY]); if (was_mapped) gtk_widget_map (widget); check_scale_changed (window); } static void gtk_window_set_theme_variant (GtkWindow *window) { #ifdef GDK_WINDOWING_X11 GtkWindowPrivate *priv = gtk_window_get_instance_private (window); gboolean dark_theme_requested; g_object_get (gtk_settings_get_for_display (priv->display), "gtk-application-prefer-dark-theme", &dark_theme_requested, NULL); if (GDK_IS_X11_SURFACE (priv->surface)) gdk_x11_surface_set_theme_variant (priv->surface, dark_theme_requested ? "dark" : NULL); #endif } #ifdef GDK_WINDOWING_X11 static void gtk_window_on_theme_variant_changed (GtkSettings *settings, GParamSpec *pspec, GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->type == GTK_WINDOW_TOPLEVEL) gtk_window_set_theme_variant (window); } #endif /** * gtk_window_is_active: * @window: a #GtkWindow * * Returns whether the window is part of the current active toplevel. * (That is, the toplevel window receiving keystrokes.) * The return value is %TRUE if the window is active toplevel itself. * You might use this function if you wanted to draw a widget * differently in an active window from a widget in an inactive window. * * Returns: %TRUE if the window part of the current active window. **/ gboolean gtk_window_is_active (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->is_active; } /** * gtk_window_get_group: * @window: (allow-none): a #GtkWindow, or %NULL * * Returns the group for @window or the default group, if * @window is %NULL or if @window does not have an explicit * window group. * * Returns: (transfer none): the #GtkWindowGroup for a window or the default group */ GtkWindowGroup * gtk_window_get_group (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (window && priv->group) return priv->group; else { static GtkWindowGroup *default_group = NULL; if (!default_group) default_group = gtk_window_group_new (); return default_group; } } /** * gtk_window_has_group: * @window: a #GtkWindow * * Returns whether @window has an explicit window group. * * Returns: %TRUE if @window has an explicit window group. **/ gboolean gtk_window_has_group (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->group != NULL; } GtkWindowGroup * _gtk_window_get_window_group (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); return priv->group; } void _gtk_window_set_window_group (GtkWindow *window, GtkWindowGroup *group) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->group = group; } static gboolean gtk_window_activate_menubar (GtkWindow *window, GdkEventKey *event) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); guint keyval = 0; GdkModifierType mods = 0; gtk_accelerator_parse (MENU_BAR_ACCEL, &keyval, &mods); if (keyval == 0) { g_warning ("Failed to parse menu bar accelerator '%s'", MENU_BAR_ACCEL); return FALSE; } /* FIXME this is wrong, needs to be in the global accel resolution * thing, to properly consider i18n etc., but that probably requires * AccelGroup changes etc. */ if (event->keyval == keyval && ((event->state & gtk_accelerator_get_default_mod_mask ()) == (mods & gtk_accelerator_get_default_mod_mask ()))) { GList *tmp_menubars, *l; GPtrArray *menubars; GtkMenuShell *menu_shell; GtkWidget *focus; GtkWidget *first; focus = gtk_window_get_focus (window); if (priv->title_box != NULL && (focus == NULL || !gtk_widget_is_ancestor (focus, priv->title_box)) && gtk_widget_child_focus (priv->title_box, GTK_DIR_TAB_FORWARD)) return TRUE; tmp_menubars = _gtk_menu_bar_get_viewable_menu_bars (window); if (tmp_menubars == NULL) return FALSE; menubars = g_ptr_array_sized_new (g_list_length (tmp_menubars));; for (l = tmp_menubars; l; l = l->next) g_ptr_array_add (menubars, l->data); g_list_free (tmp_menubars); gtk_widget_focus_sort (GTK_WIDGET (window), GTK_DIR_TAB_FORWARD, menubars); first = g_ptr_array_index (menubars, 0); menu_shell = GTK_MENU_SHELL (first); _gtk_menu_shell_set_keyboard_mode (menu_shell, TRUE); gtk_menu_shell_select_first (menu_shell, FALSE); g_ptr_array_free (menubars, TRUE); return TRUE; } return FALSE; } static void gtk_window_mnemonic_hash_foreach (guint keyval, GSList *targets, gpointer data) { struct { GtkWindow *window; GtkWindowKeysForeachFunc func; gpointer func_data; } *info = data; GtkWindowPrivate *priv = gtk_window_get_instance_private (info->window); (*info->func) (info->window, keyval, priv->mnemonic_modifier, TRUE, info->func_data); } static void _gtk_window_keys_foreach (GtkWindow *window, GtkWindowKeysForeachFunc func, gpointer func_data) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GSList *groups; GtkMnemonicHash *mnemonic_hash; struct { GtkWindow *window; GtkWindowKeysForeachFunc func; gpointer func_data; } info; info.window = window; info.func = func; info.func_data = func_data; mnemonic_hash = gtk_window_get_mnemonic_hash (window, FALSE); if (mnemonic_hash) _gtk_mnemonic_hash_foreach (mnemonic_hash, gtk_window_mnemonic_hash_foreach, &info); groups = gtk_accel_groups_from_object (G_OBJECT (window)); while (groups) { GtkAccelGroup *group = groups->data; gint i; for (i = 0; i < group->priv->n_accels; i++) { GtkAccelKey *key = &group->priv->priv_accels[i].key; if (key->accel_key) (*func) (window, key->accel_key, key->accel_mods, FALSE, func_data); } groups = groups->next; } if (priv->application) { GtkApplicationAccels *app_accels; app_accels = gtk_application_get_application_accels (priv->application); gtk_application_accels_foreach_key (app_accels, window, func, func_data); } } static void gtk_window_keys_changed (GtkWindow *window) { gtk_window_free_key_hash (window); gtk_window_get_key_hash (window); } typedef struct _GtkWindowKeyEntry GtkWindowKeyEntry; struct _GtkWindowKeyEntry { guint keyval; guint modifiers; guint is_mnemonic : 1; }; static void window_key_entry_destroy (gpointer data) { g_slice_free (GtkWindowKeyEntry, data); } static void add_to_key_hash (GtkWindow *window, guint keyval, GdkModifierType modifiers, gboolean is_mnemonic, gpointer data) { GtkKeyHash *key_hash = data; GtkWindowKeyEntry *entry = g_slice_new (GtkWindowKeyEntry); entry->keyval = keyval; entry->modifiers = modifiers; entry->is_mnemonic = is_mnemonic; /* GtkAccelGroup stores lowercased accelerators. To deal * with this, if was specified, uppercase. */ if (modifiers & GDK_SHIFT_MASK) { if (keyval == GDK_KEY_Tab) keyval = GDK_KEY_ISO_Left_Tab; else keyval = gdk_keyval_to_upper (keyval); } _gtk_key_hash_add_entry (key_hash, keyval, entry->modifiers, entry); } static GtkKeyHash * gtk_window_get_key_hash (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkKeyHash *key_hash = g_object_get_qdata (G_OBJECT (window), quark_gtk_window_key_hash); if (key_hash) return key_hash; key_hash = _gtk_key_hash_new (gdk_display_get_keymap (priv->display), (GDestroyNotify)window_key_entry_destroy); _gtk_window_keys_foreach (window, add_to_key_hash, key_hash); g_object_set_qdata (G_OBJECT (window), quark_gtk_window_key_hash, key_hash); return key_hash; } static void gtk_window_free_key_hash (GtkWindow *window) { GtkKeyHash *key_hash = g_object_get_qdata (G_OBJECT (window), quark_gtk_window_key_hash); if (key_hash) { _gtk_key_hash_free (key_hash); g_object_set_qdata (G_OBJECT (window), quark_gtk_window_key_hash, NULL); } } /** * gtk_window_activate_key: * @window: a #GtkWindow * @event: a #GdkEventKey * * Activates mnemonics and accelerators for this #GtkWindow. This is normally * called by the default ::key_press_event handler for toplevel windows, * however in some cases it may be useful to call this directly when * overriding the standard key handling for a toplevel window. * * Returns: %TRUE if a mnemonic or accelerator was found and activated. */ gboolean gtk_window_activate_key (GtkWindow *window, GdkEventKey *event) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkKeyHash *key_hash; GtkWindowKeyEntry *found_entry = NULL; gboolean enable_accels; g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); g_return_val_if_fail (event != NULL, FALSE); key_hash = gtk_window_get_key_hash (window); if (key_hash) { GSList *tmp_list; GSList *entries = _gtk_key_hash_lookup (key_hash, event->hardware_keycode, event->state, gtk_accelerator_get_default_mod_mask (), event->group); g_object_get (gtk_widget_get_settings (GTK_WIDGET (window)), "gtk-enable-accels", &enable_accels, NULL); for (tmp_list = entries; tmp_list; tmp_list = tmp_list->next) { GtkWindowKeyEntry *entry = tmp_list->data; if (entry->is_mnemonic) { found_entry = entry; break; } else { if (enable_accels && !found_entry) { found_entry = entry; } } } g_slist_free (entries); } if (found_entry) { if (found_entry->is_mnemonic) { return gtk_window_mnemonic_activate (window, found_entry->keyval, found_entry->modifiers); } else { if (enable_accels) { if (gtk_accel_groups_activate (G_OBJECT (window), found_entry->keyval, found_entry->modifiers)) return TRUE; if (priv->application) { GtkWidget *focused_widget; GtkActionMuxer *muxer; GtkApplicationAccels *app_accels; focused_widget = gtk_window_get_focus (window); if (focused_widget) muxer = _gtk_widget_get_action_muxer (focused_widget, FALSE); else muxer = _gtk_widget_get_action_muxer (GTK_WIDGET (window), FALSE); if (muxer == NULL) return FALSE; app_accels = gtk_application_get_application_accels (priv->application); return gtk_application_accels_activate (app_accels, G_ACTION_GROUP (muxer), found_entry->keyval, found_entry->modifiers); } } } } return gtk_window_activate_menubar (window, event); } /* * _gtk_window_set_is_active: * @window: a #GtkWindow * @is_active: %TRUE if the window is in the currently active toplevel * * Internal function that sets whether the #GtkWindow is part * of the currently active toplevel window (taking into account inter-process * embedding.) **/ static void _gtk_window_set_is_active (GtkWindow *window, gboolean is_active) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); if (priv->is_active == is_active) return; priv->is_active = is_active; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_IS_ACTIVE]); _gtk_window_accessible_set_is_active (window, is_active); } /** * gtk_window_set_auto_startup_notification: * @setting: %TRUE to automatically do startup notification * * By default, after showing the first #GtkWindow, GTK+ calls * gdk_notify_startup_complete(). Call this function to disable * the automatic startup notification. You might do this if your * first window is a splash screen, and you want to delay notification * until after your real main window has been shown, for example. * * In that example, you would disable startup notification * temporarily, show your splash screen, then re-enable it so that * showing the main window would automatically result in notification. **/ void gtk_window_set_auto_startup_notification (gboolean setting) { disable_startup_notification = !setting; } /** * gtk_window_get_window_type: * @window: a #GtkWindow * * Gets the type of the window. See #GtkWindowType. * * Returns: the type of the window **/ GtkWindowType gtk_window_get_window_type (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), GTK_WINDOW_TOPLEVEL); return priv->type; } /** * gtk_window_get_mnemonics_visible: * @window: a #GtkWindow * * Gets the value of the #GtkWindow:mnemonics-visible property. * * Returns: %TRUE if mnemonics are supposed to be visible * in this window. */ gboolean gtk_window_get_mnemonics_visible (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->mnemonics_visible; } /** * gtk_window_set_mnemonics_visible: * @window: a #GtkWindow * @setting: the new value * * Sets the #GtkWindow:mnemonics-visible property. */ void gtk_window_set_mnemonics_visible (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (priv->mnemonics_visible != setting) { priv->mnemonics_visible = setting; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_MNEMONICS_VISIBLE]); } if (priv->mnemonics_display_timeout_id) { g_source_remove (priv->mnemonics_display_timeout_id); priv->mnemonics_display_timeout_id = 0; } } static gboolean schedule_mnemonics_visible_cb (gpointer data) { GtkWindow *window = data; GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->mnemonics_display_timeout_id = 0; gtk_window_set_mnemonics_visible (window, TRUE); return FALSE; } void _gtk_window_schedule_mnemonics_visible (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); if (priv->mnemonics_display_timeout_id) return; priv->mnemonics_display_timeout_id = g_timeout_add (MNEMONICS_DELAY, schedule_mnemonics_visible_cb, window); g_source_set_name_by_id (priv->mnemonics_display_timeout_id, "[gtk] schedule_mnemonics_visible_cb"); } /** * gtk_window_get_focus_visible: * @window: a #GtkWindow * * Gets the value of the #GtkWindow:focus-visible property. * * Returns: %TRUE if “focus rectangles” are supposed to be visible * in this window. */ gboolean gtk_window_get_focus_visible (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); return priv->focus_visible; } /** * gtk_window_set_focus_visible: * @window: a #GtkWindow * @setting: the new value * * Sets the #GtkWindow:focus-visible property. */ void gtk_window_set_focus_visible (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); setting = setting != FALSE; if (priv->focus_visible != setting) { priv->focus_visible = setting; g_object_notify_by_pspec (G_OBJECT (window), window_props[PROP_FOCUS_VISIBLE]); } } /** * gtk_window_set_has_user_ref_count: * @window: a #GtkWindow * @setting: the new value * * Tells GTK+ whether to drop its extra reference to the window * when gtk_widget_destroy() is called. * * This function is only exported for the benefit of language * bindings which may need to keep the window alive until their * wrapper object is garbage collected. There is no justification * for ever calling this function in an application. */ void gtk_window_set_has_user_ref_count (GtkWindow *window, gboolean setting) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); priv->has_user_ref_count = setting; } static void ensure_state_flag_backdrop (GtkWidget *widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (GTK_WINDOW (widget)); gboolean surface_focused = TRUE; surface_focused = gdk_surface_get_state (priv->surface) & GDK_SURFACE_STATE_FOCUSED; if (!surface_focused) gtk_widget_set_state_flags (widget, GTK_STATE_FLAG_BACKDROP, FALSE); else gtk_widget_unset_state_flags (widget, GTK_STATE_FLAG_BACKDROP); } void _gtk_window_get_shadow_width (GtkWindow *window, GtkBorder *border) { get_shadow_width (window, border); } void _gtk_window_add_popover (GtkWindow *window, GtkWidget *popover, GtkWidget *parent, gboolean clamp_allocation) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowPopover *data; AtkObject *accessible; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (popover)); g_return_if_fail (GTK_IS_WIDGET (parent)); g_return_if_fail (_gtk_widget_get_parent (popover) == NULL); g_return_if_fail (gtk_widget_is_ancestor (parent, GTK_WIDGET (window))); if (_gtk_window_has_popover (window, popover)) return; data = g_new0 (GtkWindowPopover, 1); data->widget = popover; data->parent = parent; data->clamp_allocation = !!clamp_allocation; g_queue_push_head (&priv->popovers, data); gtk_widget_set_parent (popover, GTK_WIDGET (window)); accessible = gtk_widget_get_accessible (GTK_WIDGET (window)); _gtk_container_accessible_add_child (GTK_CONTAINER_ACCESSIBLE (accessible), gtk_widget_get_accessible (popover), -1); } void _gtk_window_remove_popover (GtkWindow *window, GtkWidget *popover) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GtkWindowPopover *data; AtkObject *accessible; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (popover)); data = _gtk_window_has_popover (window, popover); if (!data) return; g_object_ref (popover); gtk_widget_unparent (popover); g_queue_remove (&priv->popovers, data); accessible = gtk_widget_get_accessible (GTK_WIDGET (window)); _gtk_container_accessible_remove_child (GTK_CONTAINER_ACCESSIBLE (accessible), gtk_widget_get_accessible (popover), -1); popover_destroy (data); g_object_unref (popover); } void _gtk_window_set_popover_position (GtkWindow *window, GtkWidget *popover, GtkPositionType pos, const cairo_rectangle_int_t *rect) { GtkWindowPopover *data; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (popover)); data = _gtk_window_has_popover (window, popover); if (!data) { g_warning ("Widget %s(%p) is not a popover of window %s(%p)", gtk_widget_get_name (popover), popover, gtk_widget_get_name (GTK_WIDGET (window)), window); return; } data->rect = *rect; data->pos = pos; gtk_widget_queue_resize (popover); } void _gtk_window_get_popover_position (GtkWindow *window, GtkWidget *popover, GtkPositionType *pos, cairo_rectangle_int_t *rect) { GtkWindowPopover *data; g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (GTK_IS_WIDGET (popover)); data = _gtk_window_has_popover (window, popover); if (!data) { g_warning ("Widget %s(%p) is not a popover of window %s(%p)", gtk_widget_get_name (popover), popover, gtk_widget_get_name (GTK_WIDGET (window)), window); return; } if (pos) *pos = data->pos; if (rect) *rect = data->rect; } /* * _gtk_window_get_popover_parent: * @window: A #GtkWindow * @popover: A popover #GtkWidget * * Returns the conceptual parent of this popover, the real * parent will always be @window. * * Returns: (nullable): The conceptual parent widget, or %NULL. **/ GtkWidget * _gtk_window_get_popover_parent (GtkWindow *window, GtkWidget *popover) { GtkWindowPopover *data; g_return_val_if_fail (GTK_IS_WINDOW (window), NULL); g_return_val_if_fail (GTK_IS_WIDGET (popover), NULL); data = _gtk_window_has_popover (window, popover); if (data && data->parent) return data->parent; return NULL; } /* * _gtk_window_is_popover_widget: * @window: A #GtkWindow * @possible_popover: A possible popover of @window * * Returns #TRUE if @possible_popover is a popover of @window. * * Returns: Whether the widget is a popover of @window **/ gboolean _gtk_window_is_popover_widget (GtkWindow *window, GtkWidget *possible_popover) { g_return_val_if_fail (GTK_IS_WINDOW (window), FALSE); g_return_val_if_fail (GTK_IS_WIDGET (possible_popover), FALSE); return _gtk_window_has_popover (window, possible_popover) != NULL; } void _gtk_window_raise_popover (GtkWindow *window, GtkWidget *widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *link; for (link = priv->popovers.head; link; link = link->next) { GtkWindowPopover *popover = link->data; if (popover->widget != widget) continue; g_queue_unlink (&priv->popovers, link); g_queue_push_tail (&priv->popovers, link->data); g_list_free (link); break; } } static GtkWidget *inspector_window = NULL; static guint gtk_window_update_debugging_id; static void set_warn_again (gboolean warn); static void warn_response (GtkDialog *dialog, gint response) { GtkWidget *check; gboolean remember; check = g_object_get_data (G_OBJECT (dialog), "check"); remember = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (check)); gtk_widget_destroy (GTK_WIDGET (dialog)); g_object_set_data (G_OBJECT (inspector_window), "warning_dialog", NULL); if (response == GTK_RESPONSE_NO) { GtkWidget *window; if (gtk_window_update_debugging_id) { g_source_remove (gtk_window_update_debugging_id); gtk_window_update_debugging_id = 0; } /* Steal reference into temp variable, so not to mess up with * inspector_window during gtk_widget_destroy(). */ window = inspector_window; inspector_window = NULL; gtk_widget_destroy (window); } else { set_warn_again (!remember); } } static gboolean update_debugging (gpointer data) { gtk_window_update_debugging_id = 0; return G_SOURCE_REMOVE; } static void gtk_window_update_debugging (void) { if (inspector_window && gtk_window_update_debugging_id == 0) { gtk_window_update_debugging_id = g_idle_add (update_debugging, NULL); g_source_set_name_by_id (gtk_window_update_debugging_id, "[gtk] gtk_window_update_debugging"); } } static void gtk_window_set_debugging (gboolean enable, gboolean select, gboolean warn) { GtkWidget *dialog = NULL; GtkWidget *area; GtkWidget *check; if (inspector_window == NULL) { gtk_inspector_init (); inspector_window = gtk_inspector_window_new (); gtk_window_set_hide_on_close (GTK_WINDOW (inspector_window), TRUE); if (warn) { dialog = gtk_message_dialog_new (GTK_WINDOW (inspector_window), GTK_DIALOG_MODAL|GTK_DIALOG_DESTROY_WITH_PARENT, GTK_MESSAGE_QUESTION, GTK_BUTTONS_NONE, _("Do you want to use GTK Inspector?")); gtk_message_dialog_format_secondary_text (GTK_MESSAGE_DIALOG (dialog), _("GTK Inspector is an interactive debugger that lets you explore and " "modify the internals of any GTK application. Using it may cause the " "application to break or crash.")); area = gtk_message_dialog_get_message_area (GTK_MESSAGE_DIALOG (dialog)); check = gtk_check_button_new_with_label (_("Don’t show this message again")); gtk_widget_set_margin_start (check, 10); gtk_widget_show (check); gtk_container_add (GTK_CONTAINER (area), check); g_object_set_data (G_OBJECT (dialog), "check", check); gtk_dialog_add_button (GTK_DIALOG (dialog), _("_Cancel"), GTK_RESPONSE_NO); gtk_dialog_add_button (GTK_DIALOG (dialog), _("_OK"), GTK_RESPONSE_YES); g_signal_connect (dialog, "response", G_CALLBACK (warn_response), NULL); g_object_set_data (G_OBJECT (inspector_window), "warning_dialog", dialog); } } dialog = g_object_get_data (G_OBJECT (inspector_window), "warning_dialog"); if (enable) { G_GNUC_BEGIN_IGNORE_DEPRECATIONS gtk_window_present (GTK_WINDOW (inspector_window)); G_GNUC_END_IGNORE_DEPRECATIONS if (dialog) gtk_widget_show (dialog); if (select) gtk_inspector_window_select_widget_under_pointer (GTK_INSPECTOR_WINDOW (inspector_window)); } else { if (dialog) gtk_widget_hide (dialog); gtk_widget_hide (inspector_window); } } /** * gtk_window_set_interactive_debugging: * @enable: %TRUE to enable interactive debugging * * Opens or closes the [interactive debugger][interactive-debugging], * which offers access to the widget hierarchy of the application * and to useful debugging tools. */ void gtk_window_set_interactive_debugging (gboolean enable) { gtk_window_set_debugging (enable, FALSE, FALSE); } static gboolean inspector_keybinding_enabled (gboolean *warn) { GSettingsSchema *schema; GSettings *settings; gboolean enabled; enabled = FALSE; *warn = FALSE; schema = g_settings_schema_source_lookup (g_settings_schema_source_get_default (), "org.gtk.gtk4.Settings.Debug", TRUE); if (schema) { settings = g_settings_new_full (schema, NULL, NULL); enabled = g_settings_get_boolean (settings, "enable-inspector-keybinding"); *warn = g_settings_get_boolean (settings, "inspector-warning"); g_object_unref (settings); g_settings_schema_unref (schema); } return enabled; } static void set_warn_again (gboolean warn) { GSettingsSchema *schema; GSettings *settings; schema = g_settings_schema_source_lookup (g_settings_schema_source_get_default (), "org.gtk.gtk4.Settings.Debug", TRUE); if (schema) { settings = g_settings_new_full (schema, NULL, NULL); g_settings_set_boolean (settings, "inspector-warning", warn); g_object_unref (settings); g_settings_schema_unref (schema); } } static gboolean gtk_window_enable_debugging (GtkWindow *window, gboolean toggle) { gboolean warn; if (!inspector_keybinding_enabled (&warn)) return FALSE; if (toggle) { if (GTK_IS_WIDGET (inspector_window) && gtk_widget_is_visible (inspector_window)) gtk_window_set_debugging (FALSE, FALSE, FALSE); else gtk_window_set_debugging (TRUE, FALSE, warn); } else gtk_window_set_debugging (TRUE, TRUE, warn); return TRUE; } void gtk_window_set_hardcoded_surface (GtkWindow *window, GdkSurface *surface) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); g_return_if_fail (GTK_IS_WINDOW (window)); g_return_if_fail (!_gtk_widget_get_realized (GTK_WIDGET (window))); g_set_object (&priv->hardcoded_surface, surface); } #ifdef GDK_WINDOWING_WAYLAND typedef struct { GtkWindow *window; GtkWindowHandleExported callback; gpointer user_data; } WaylandSurfaceHandleExportedData; static void wayland_surface_handle_exported (GdkSurface *window, const char *wayland_handle_str, gpointer user_data) { WaylandSurfaceHandleExportedData *data = user_data; char *handle_str; handle_str = g_strdup_printf ("wayland:%s", wayland_handle_str); data->callback (data->window, handle_str, data->user_data); g_free (handle_str); } #endif gboolean gtk_window_export_handle (GtkWindow *window, GtkWindowHandleExported callback, gpointer user_data) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); #ifdef GDK_WINDOWING_X11 if (GDK_IS_X11_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) { char *handle_str; guint32 xid = (guint32) gdk_x11_surface_get_xid (priv->surface); handle_str = g_strdup_printf ("x11:%x", xid); callback (window, handle_str, user_data); g_free (handle_str); return TRUE; } #endif #ifdef GDK_WINDOWING_WAYLAND if (GDK_IS_WAYLAND_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) { WaylandSurfaceHandleExportedData *data; data = g_new0 (WaylandSurfaceHandleExportedData, 1); data->window = window; data->callback = callback; data->user_data = user_data; if (!gdk_wayland_surface_export_handle (priv->surface, wayland_surface_handle_exported, data, g_free)) { g_free (data); return FALSE; } else { return TRUE; } } #endif g_warning ("Couldn't export handle for %s surface, unsupported windowing system", G_OBJECT_TYPE_NAME (priv->surface)); return FALSE; } void gtk_window_unexport_handle (GtkWindow *window) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); #ifdef GDK_WINDOWING_WAYLAND if (GDK_IS_WAYLAND_DISPLAY (gtk_widget_get_display (GTK_WIDGET (window)))) { gdk_wayland_surface_unexport_handle (priv->surface); return; } #endif g_warning ("Couldn't unexport handle for %s surface, unsupported windowing system", G_OBJECT_TYPE_NAME (priv->surface)); } static void gtk_window_add_pointer_focus (GtkWindow *window, GtkPointerFocus *focus) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); priv->foci = g_list_prepend (priv->foci, gtk_pointer_focus_ref (focus)); } static void gtk_window_remove_pointer_focus (GtkWindow *window, GtkPointerFocus *focus) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *pos; pos = g_list_find (priv->foci, focus); if (!pos) return; priv->foci = g_list_remove (priv->foci, focus); gtk_pointer_focus_unref (focus); } static GtkPointerFocus * gtk_window_lookup_pointer_focus (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *l; for (l = priv->foci; l; l = l->next) { GtkPointerFocus *focus = l->data; if (focus->device == device && focus->sequence == sequence) return focus; } return NULL; } GtkWidget * gtk_window_lookup_pointer_focus_widget (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence) { GtkPointerFocus *focus; focus = gtk_window_lookup_pointer_focus (window, device, sequence); return focus ? gtk_pointer_focus_get_target (focus) : NULL; } GtkWidget * gtk_window_lookup_effective_pointer_focus_widget (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence) { GtkPointerFocus *focus; focus = gtk_window_lookup_pointer_focus (window, device, sequence); return focus ? gtk_pointer_focus_get_effective_target (focus) : NULL; } GtkWidget * gtk_window_lookup_pointer_focus_implicit_grab (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence) { GtkPointerFocus *focus; focus = gtk_window_lookup_pointer_focus (window, device, sequence); return focus ? gtk_pointer_focus_get_implicit_grab (focus) : NULL; } void gtk_window_update_pointer_focus (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence, GtkWidget *target, gdouble x, gdouble y) { GtkPointerFocus *focus; focus = gtk_window_lookup_pointer_focus (window, device, sequence); if (focus) { gtk_pointer_focus_ref (focus); if (target) { gtk_pointer_focus_set_target (focus, target); gtk_pointer_focus_set_coordinates (focus, x, y); } else { gtk_window_remove_pointer_focus (window, focus); } gtk_pointer_focus_unref (focus); } else if (target) { focus = gtk_pointer_focus_new (window, target, device, sequence, x, y); gtk_window_add_pointer_focus (window, focus); gtk_pointer_focus_unref (focus); } } void gtk_window_update_pointer_focus_on_state_change (GtkWindow *window, GtkWidget *widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *l = priv->foci, *cur; while (l) { GtkPointerFocus *focus = l->data; cur = l; focus = cur->data; l = cur->next; gtk_pointer_focus_ref (focus); if (focus->grab_widget && (focus->grab_widget == widget || gtk_widget_is_ancestor (focus->grab_widget, widget))) gtk_pointer_focus_set_implicit_grab (focus, NULL); if (GTK_WIDGET (focus->toplevel) == widget) { /* Unmapping the toplevel, remove pointer focus */ priv->foci = g_list_remove_link (priv->foci, cur); gtk_pointer_focus_unref (focus); } else if (focus->target == widget || gtk_widget_is_ancestor (focus->target, widget)) { gtk_pointer_focus_repick_target (focus); } gtk_pointer_focus_unref (focus); } } void gtk_window_maybe_revoke_implicit_grab (GtkWindow *window, GdkDevice *device, GtkWidget *grab_widget) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *l = priv->foci, *cur; while (l) { GtkPointerFocus *focus = l->data; cur = l; focus = cur->data; l = cur->next; if (focus->toplevel != window) continue; if (device && focus->device == device && focus->target != grab_widget && !gtk_widget_is_ancestor (focus->target, grab_widget)) gtk_window_set_pointer_focus_grab (window, focus->device, focus->sequence, NULL); } } void gtk_window_set_pointer_focus_grab (GtkWindow *window, GdkDevice *device, GdkEventSequence *sequence, GtkWidget *grab_widget) { GtkPointerFocus *focus; focus = gtk_window_lookup_pointer_focus (window, device, sequence); if (!focus && !grab_widget) return; g_assert (focus != NULL); gtk_pointer_focus_set_implicit_grab (focus, grab_widget); } static void update_cursor (GtkWindow *toplevel, GdkDevice *device, GtkWidget *grab_widget, GtkWidget *target) { GdkCursor *cursor = NULL; GdkSurface *surface; surface = gtk_native_get_surface (gtk_widget_get_native (target)); if (grab_widget && !gtk_widget_is_ancestor (target, grab_widget)) { /* Outside the grab widget, cursor stays to whatever the grab * widget says. */ if (gtk_native_get_surface (gtk_widget_get_native (grab_widget)) == surface) cursor = gtk_widget_get_cursor (grab_widget); else cursor = NULL; } else { /* Inside the grab widget or in absence of grabs, allow walking * up the hierarchy to find out the cursor. */ while (target) { if (grab_widget && target == grab_widget) break; /* Don't inherit cursors across surfaces */ if (surface != gtk_native_get_surface (gtk_widget_get_native (target))) break; cursor = gtk_widget_get_cursor (target); if (cursor) break; target = _gtk_widget_get_parent (target); } } gdk_surface_set_device_cursor (surface, device, cursor); } void gtk_window_maybe_update_cursor (GtkWindow *window, GtkWidget *widget, GdkDevice *device) { GtkWindowPrivate *priv = gtk_window_get_instance_private (window); GList *l; for (l = priv->foci; l; l = l->next) { GtkPointerFocus *focus = l->data; GtkWidget *grab_widget, *target; GtkWindowGroup *group; if (focus->sequence) continue; if (device && device != focus->device) continue; group = gtk_window_get_group (window); grab_widget = gtk_window_group_get_current_device_grab (group, focus->device); if (!grab_widget) grab_widget = gtk_window_group_get_current_grab (group); if (!grab_widget) grab_widget = gtk_pointer_focus_get_implicit_grab (focus); target = gtk_pointer_focus_get_target (focus); if (widget) { /* Check whether the changed widget affects the current cursor * lookups. */ if (grab_widget && grab_widget != widget && !gtk_widget_is_ancestor (widget, grab_widget)) continue; if (target != widget && !gtk_widget_is_ancestor (target, widget)) continue; } update_cursor (focus->toplevel, focus->device, grab_widget, target); if (device) break; } }