Delete Event and Destroy

    $toplevel->signal_connect (destroy => sub { Gtk2->main_quit });

If you install a handler for "delete-event" and return true, meaning "don't propagate", you can do something other than destroy the window. For example

    $toplevel->signal_connect (delete_event => sub {
       if (any_unsaved_documents()) {
         popup_ask_save_before_exit_dialog();
         return Gtk2::EVENT_STOP;  # don't go to default destroy
       } else {
         return Gtk2::EVENT_PROPAGATE;
       }
    });

In a dialog or secondary app window you might not want to destroy but instead just hide ready for later re-use.

    $dialog->signal_connect
      (delete_event => \&Gtk2::Widget::hide_on_delete);

The choice between destroying or hiding is normally just a matter of memory saved against the time to re-create, and how likely the dialog might be needed again. (However if you build windows with Glade it's not particularly easy to re-create them there, so you'll mostly want to just hide in that case.)

A hidden toplevel window is still in "Gtk2::Window->list_toplevels" and that's a good place to search for an existing window of a desired type to "$window->present" again.

widget = Gtk2::Window->new ($type=GTK_WINDOW_TOPLEVEL)

•

$type (Gtk2::WindowType)

boolean = $window->get_accept_focus

$window->set_accept_focus ($setting)

•

$setting (boolean)

Since: gtk+ 2.4

boolean = $window->activate_default

boolean = $window->activate_focus

boolean = $window->activate_key ($event)

•

$event (Gtk2::Gdk::Event::Key)

Since: gtk+ 2.4

$window->add_accel_group ($accel_group)

•

$accel_group (Gtk2::AccelGroup)

$window->add_embedded_xid ($xid)

•

$xid (integer)

$window->add_mnemonic ($keyval, $target)

• $keyval (integer)
• $target (Gtk2::Widget)

Gtk2::Window->set_auto_startup_notification ($setting)

•

$setting (boolean)

Since: gtk+ 2.2

$window->begin_move_drag ($button, $root_x, $root_y, $timestamp)

• $button (integer)
• $root_x (integer)
• $root_y (integer)
• $timestamp (unsigned)

$window->begin_resize_drag ($edge, $button, $root_x, $root_y, $timestamp)

• $edge (Gtk2::Gdk::WindowEdge)
• $button (integer)
• $root_x (integer)
• $root_y (integer)
• $timestamp (unsigned)

boolean = $window->get_decorated

$window->set_decorated ($setting)

•

$setting (boolean)

Gtk2::Window->set_default_icon_from_file ($filename)

$window->set_default_icon_from_file ($filename)

•

$filename (localized file name)

May croak with a Glib::Error in $@ on failure.

Since: gtk+ 2.2

list = Gtk2::Window->get_default_icon_list

$window->set_default_icon_list ($pixbuf1, ...)

• ... (list)
• $pixbuf1 (Gtk2::Gdk::Pixbuf)

string or undef = Gtk2::Window->get_default_icon_name

Since: gtk+ 2.16

Gtk2::Window->set_default_icon_name ($name)

•

$name (string or undef)

Since: gtk+ 2.6

Gtk2::Window->set_default_icon ($icon)

•

$icon (Gtk2::Gdk::Pixbuf)

Since: gtk+ 2.4

$window->set_default ($default_widget)

•

$default_widget (Gtk2::Widget or undef)

(width, height) = $window->get_default_size

$window->set_default_size ($width, $height)

• $width (integer)
• $height (integer)

widget or undef = $window->get_default_widget

$window->deiconify

boolean = $window->get_deletable

$window->set_deletable ($setting)

•

$setting (boolean)

Since: gtk+ 2.10

boolean = $window->get_destroy_with_parent

$window->set_destroy_with_parent ($setting)

•

$setting (boolean)

widget or undef = $window->get_focus

boolean = $window->get_focus_on_map

$window->set_focus_on_map ($setting)

•

$setting (boolean)

Since: gtk+ 2.6

$window->set_focus ($focus=undef)

•

$focus (Gtk2::Widget or undef)

(left, top, right, bottom) = $window->get_frame_dimensions

$window->set_frame_dimensions ($left, $top, $right, $bottom)

• $left (integer)
• $top (integer)
• $right (integer)
• $bottom (integer)

$window->fullscreen

$window->set_geometry_hints ($geometry_widget, $geometry)

$window->set_geometry_hints ($geometry_widget, $geometry, $geom_mask)

• $geometry_widget (Gtk2::Widget)
• $geom_mask (Gtk2::Gdk::WindowHints) optional, usually inferred from $geometry
• $geometry (scalar) Gtk2::Gdk::Geometry or hashref

See "Gtk2::Gdk::Window::set_geometry_hints" on the $geometry and $geom_mask arguments.

gravity = $window->get_gravity

$window->set_gravity ($gravity)

•

$gravity (Gtk2::Gdk::Gravity)

windowgroup or undef = $window->get_group

boolean = $window->get_has_frame

$window->set_has_frame ($setting)

•

$setting (boolean)

boolean = $window->has_group

boolean = $window->has_toplevel_focus

$window->set_icon_from_file ($filename)

•

$filename (localized file name)

May croak with a Glib::Error in $@ on failure.

Since: gtk+ 2.2

pixbuf or undef = $window->get_icon

list = $window->get_icon_list

$window->set_icon_list (...)

•

... (list) of Gtk2::Gdk::Pixbuf's

Sets up the icon representing a Gtk2::Window. The icon is used when the window is minimized (also known as iconified). Some window managers or desktop environments may also place it in the window frame, or display it in other contexts.

set_icon_list () allows you to pass in the same icon in several hand-drawn sizes. The list should contain the natural sizes your icon is available in; that is, don't scale the image before passing it to GTK+. Scaling is postponed until the last minute, when the desired final size is known, to allow best quality.

By passing several sizes, you may improve the final image quality of the icon, by reducing or eliminating automatic image scaling.

Recommended sizes to provide: 16x16, 32x32, 48x48 at minimum, and larger images (64x64, 128x128) if you have them.

string or undef = $window->get_icon_name

$window->set_icon_name ($name)

•

$name (string)

Since: gtk+ 2.6

$window->set_icon ($icon)

•

$icon (Gtk2::Gdk::Pixbuf or undef)

$window->iconify

boolean = $window->is_active

$window->set_keep_above ($setting)

•

$setting (boolean)

Since: gtk+ 2.4

$window->set_keep_below ($setting)

•

$setting (boolean)

Since: gtk+ 2.4

list = Gtk2::Window->list_toplevels

$window->maximize

boolean = $window->mnemonic_activate ($keyval, $modifier)

• $keyval (integer)
• $modifier (Gtk2::Gdk::ModifierType)

modifiertype = $window->get_mnemonic_modifier

$window->set_mnemonic_modifier ($modifier)

•

$modifier (Gtk2::Gdk::ModifierType)

boolean = $window->get_mnemonics_visible

$window->set_mnemonics_visible ($setting)

•

$setting (boolean)

Since: gtk+ 2.20

boolean = $window->get_modal

$window->set_modal ($modal)

•

$modal (boolean)

$window->move ($x, $y)

• $x (integer)
• $y (integer)

double = $window->get_opacity

$window->set_opacity ($opacity)

•

$opacity (double)

Since: gtk+ 2.12

boolean = $window->parse_geometry ($geometry)

•

$geometry (string)

(root_x, root_y) = $window->get_position

$window->set_position ($position)

•

$position (Gtk2::WindowPosition)

$window->present

$window->present_with_time ($timestamp)

•

$timestamp (unsigned)

Since: gtk+ 2.8

boolean = $window->propagate_key_event ($event)

•

$event (Gtk2::Gdk::Event::Key)

Since: gtk+ 2.4

$window->remove_accel_group ($accel_group)

•

$accel_group (Gtk2::AccelGroup)

$window->remove_embedded_xid ($xid)

•

$xid (integer)

$window->remove_mnemonic ($keyval, $target)

• $keyval (integer)
• $target (Gtk2::Widget)

$window->reshow_with_initial_size

boolean = $window->get_resizable

$window->set_resizable ($resizable)

•

$resizable (boolean)

$window->resize ($width, $height)

• $width (integer)
• $height (integer)

string = $window->get_role

$window->set_role ($role)

•

$role (string)

screen = $window->get_screen

$window->set_screen ($screen)

•

$screen (Gtk2::Gdk::Screen)

Since: gtk+ 2.2

(width, height) = $window->get_size

boolean = $window->get_skip_pager_hint

$window->set_skip_pager_hint ($setting)

•

$setting (boolean)

Since: gtk+ 2.2

boolean = $window->get_skip_taskbar_hint

$window->set_skip_taskbar_hint ($setting)

•

$setting (boolean)

Since: gtk+ 2.2

$window->set_startup_id ($startup_id)

•

$startup_id (string)

Since: gtk+ 2.12

$window->stick

string = $window->get_title

$window->set_title ($title=undef)

•

$title (string or undef)

window or undef = $window->get_transient_for

$window->set_transient_for ($parent)

•

$parent (Gtk2::Window or undef)

windowtypehint = $window->get_type_hint

$window->set_type_hint ($hint)

•

$hint (Gtk2::Gdk::WindowTypeHint)

$window->unfullscreen

$window->unmaximize

$window->unstick

boolean = $window->get_urgency_hint

$window->set_urgency_hint ($setting)

•

$setting (boolean)

Since: gtk+ 2.8

windowtype = $window->get_window_type

$window->set_wmclass ($wmclass_name, $wmclass_class)

• $wmclass_name (string)
• $wmclass_class (string)

enum Gtk2::Gdk::Gravity

• 'north-west' / 'GDK_GRAVITY_NORTH_WEST'
• 'north' / 'GDK_GRAVITY_NORTH'
• 'north-east' / 'GDK_GRAVITY_NORTH_EAST'
• 'west' / 'GDK_GRAVITY_WEST'
• 'center' / 'GDK_GRAVITY_CENTER'
• 'east' / 'GDK_GRAVITY_EAST'
• 'south-west' / 'GDK_GRAVITY_SOUTH_WEST'
• 'south' / 'GDK_GRAVITY_SOUTH'
• 'south-east' / 'GDK_GRAVITY_SOUTH_EAST'
• 'static' / 'GDK_GRAVITY_STATIC'

flags Gtk2::Gdk::ModifierType

• 'shift-mask' / 'GDK_SHIFT_MASK'
• 'lock-mask' / 'GDK_LOCK_MASK'
• 'control-mask' / 'GDK_CONTROL_MASK'
• 'mod1-mask' / 'GDK_MOD1_MASK'
• 'mod2-mask' / 'GDK_MOD2_MASK'
• 'mod3-mask' / 'GDK_MOD3_MASK'
• 'mod4-mask' / 'GDK_MOD4_MASK'
• 'mod5-mask' / 'GDK_MOD5_MASK'
• 'button1-mask' / 'GDK_BUTTON1_MASK'
• 'button2-mask' / 'GDK_BUTTON2_MASK'
• 'button3-mask' / 'GDK_BUTTON3_MASK'
• 'button4-mask' / 'GDK_BUTTON4_MASK'
• 'button5-mask' / 'GDK_BUTTON5_MASK'
• 'super-mask' / 'GDK_SUPER_MASK'
• 'hyper-mask' / 'GDK_HYPER_MASK'
• 'meta-mask' / 'GDK_META_MASK'
• 'release-mask' / 'GDK_RELEASE_MASK'
• 'modifier-mask' / 'GDK_MODIFIER_MASK'

enum Gtk2::Gdk::WindowEdge

• 'north-west' / 'GDK_WINDOW_EDGE_NORTH_WEST'
• 'north' / 'GDK_WINDOW_EDGE_NORTH'
• 'north-east' / 'GDK_WINDOW_EDGE_NORTH_EAST'
• 'west' / 'GDK_WINDOW_EDGE_WEST'
• 'east' / 'GDK_WINDOW_EDGE_EAST'
• 'south-west' / 'GDK_WINDOW_EDGE_SOUTH_WEST'
• 'south' / 'GDK_WINDOW_EDGE_SOUTH'
• 'south-east' / 'GDK_WINDOW_EDGE_SOUTH_EAST'

flags Gtk2::Gdk::WindowHints

• 'pos' / 'GDK_HINT_POS'
• 'min-size' / 'GDK_HINT_MIN_SIZE'
• 'max-size' / 'GDK_HINT_MAX_SIZE'
• 'base-size' / 'GDK_HINT_BASE_SIZE'
• 'aspect' / 'GDK_HINT_ASPECT'
• 'resize-inc' / 'GDK_HINT_RESIZE_INC'
• 'win-gravity' / 'GDK_HINT_WIN_GRAVITY'
• 'user-pos' / 'GDK_HINT_USER_POS'
• 'user-size' / 'GDK_HINT_USER_SIZE'

enum Gtk2::Gdk::WindowTypeHint

• 'normal' / 'GDK_WINDOW_TYPE_HINT_NORMAL'
• 'dialog' / 'GDK_WINDOW_TYPE_HINT_DIALOG'
• 'menu' / 'GDK_WINDOW_TYPE_HINT_MENU'
• 'toolbar' / 'GDK_WINDOW_TYPE_HINT_TOOLBAR'
• 'splashscreen' / 'GDK_WINDOW_TYPE_HINT_SPLASHSCREEN'
• 'utility' / 'GDK_WINDOW_TYPE_HINT_UTILITY'
• 'dock' / 'GDK_WINDOW_TYPE_HINT_DOCK'
• 'desktop' / 'GDK_WINDOW_TYPE_HINT_DESKTOP'
• 'dropdown-menu' / 'GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU'
• 'popup-menu' / 'GDK_WINDOW_TYPE_HINT_POPUP_MENU'
• 'tooltip' / 'GDK_WINDOW_TYPE_HINT_TOOLTIP'
• 'notification' / 'GDK_WINDOW_TYPE_HINT_NOTIFICATION'
• 'combo' / 'GDK_WINDOW_TYPE_HINT_COMBO'
• 'dnd' / 'GDK_WINDOW_TYPE_HINT_DND'

enum Gtk2::WindowPosition

• 'none' / 'GTK_WIN_POS_NONE'
• 'center' / 'GTK_WIN_POS_CENTER'
• 'mouse' / 'GTK_WIN_POS_MOUSE'
• 'center-always' / 'GTK_WIN_POS_CENTER_ALWAYS'
• 'center-on-parent' / 'GTK_WIN_POS_CENTER_ON_PARENT'

enum Gtk2::WindowType

• 'toplevel' / 'GTK_WINDOW_TOPLEVEL'
• 'popup' / 'GTK_WINDOW_POPUP'