Gtk2::HandleBox(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::HandleBox — the manual, but make it cute 💖

okay bestie, so this is Gtk2::HandleBox, straight out of the User Contributed Perl Documentation collection (yes, that's the manual name, it's giving ✨community-maintained✨ and we love that for us). It's the Perl wrapper for GtkHandleBox. Think of it as the widget that can ✂️ detach itself from its parent window and float around like it owns the place. main character energy fr fr.

✨ NAME ✨

Gtk2::HandleBox — a wrapper for GtkHandleBox 🫶

🌸 HIERARCHY 🌸

the family tree, no cap:

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gtk2::HandleBox

🦋 INTERFACES 🦋

the vibes it implements:

  • Glib::Object::_Unregistered::AtkImplementorIface
  • Gtk2::Buildable

💅 METHODS 💅

widget = Gtk2::HandleBox->new

make a whole new handle box. iconic. ✨

boolean = $handle_box->get_child_detached

tells you whether the child is currently detached (aka out here living its own life) or still attached. 🔥

positiontype = $handle_box->get_handle_position

$handle_box->set_handle_position ($position)

  • $position (Gtk2::PositionType) — where the handle sits

shadowtype = $handle_box->get_shadow_type

$handle_box->set_shadow_type ($type)

  • $type (Gtk2::ShadowType) — what kind of shadow it's serving

positiontype = $handle_box->get_snap_edge

$handle_box->set_snap_edge ($edge)

  • $edge (Gtk2::PositionType) — which edge snaps to the docking point

🎀 PROPERTIES 🎀

  • 'child-detached' (boolean : default false : readable / private / static-nick / static-blurb) — a boolean value indicating whether the handlebox's child is attached or detached. 💀 the plot twist detector.
  • 'handle-position' (Gtk2::PositionType : default "left" : readable / writable / private / static-nick / static-blurb) — position of the handle relative to the child widget.
  • 'shadow' (Gtk2::ShadowType : default "out" : readable / writable / private / static-nick / static-blurb / deprecated) — deprecated property, use shadow_type instead. yeah it's old, we don't talk about it. 🙈
  • 'shadow-type' (Gtk2::ShadowType : default "out" : readable / writable / private / static-nick / static-blurb) — appearance of the shadow that surrounds the container.
  • 'snap-edge' (Gtk2::PositionType : default "top" : readable / writable / private / static-nick / static-blurb) — side of the handlebox that's lined up with the docking point to dock the handlebox.
  • 'snap-edge-set' (boolean : default false : readable / writable / private / static-nick / static-blurb) — whether to use the value from the snap_edge property or a value derived from handle_position.

⭐ SIGNALS ⭐

  • child-attached (Gtk2::HandleBox, Gtk2::Widget)
  • child-detached (Gtk2::HandleBox, Gtk2::Widget)

🌈 ENUMS AND FLAGS 🌈

enum Gtk2::PositionType

  • 'left' / GTK_POS_LEFT
  • 'right' / GTK_POS_RIGHT
  • 'top' / GTK_POS_TOP
  • 'bottom' / GTK_POS_BOTTOM

enum Gtk2::ShadowType

  • 'none' / GTK_SHADOW_NONE
  • 'in' / GTK_SHADOW_IN
  • 'out' / GTK_SHADOW_OUT
  • 'etched-in' / GTK_SHADOW_ETCHED_IN
  • 'etched-out' / GTK_SHADOW_ETCHED_OUT

👑 SEE ALSO 👑

go read these next, iykyk:

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.

and that's the whole page, bestie 🫶 this one's from perl v5.42.0, dated 2025-07-25, filed under User Contributed Perl Documentation — periodt. go forth and detach those handle boxes responsibly 💅✨

📦 where this page comes from