Gnome2:...o::Dock(3)

📦
version 1.048 · 2 versions
, in fedora 43

💖 Gnome2::Bonobo::Dock — the vibe ✨

okay so bestie, welcome to the Gnome2::Bonobo::Dock page, straight out of the User Contributed Perl Documentation collection 🫶 this is the Perl wrapper for BonoboDock, and yes it's exactly as iconic as it sounds 💅

🌸 HIERARCHY 🌸

so the family tree goes like this, and you're gonna wanna screenshot it:

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gnome2::Bonobo::Dock

it's giving deep inheritance, fr fr 👑

🦋 INTERFACES 🦋

the extra lil interfaces it's serving:

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

✨ METHODS ✨

🎀 widget = Gnome2::Bonobo::Dock->new

the constructor, the origin story, the main character moment 🌟 you call it and you get yourself a shiny new dock widget.

🎀 $dock->add_floating_item ($widget, $x, $y, $orientation)

drop a floating item into the dock. the deets:

  • $widget (Gnome2::Bonobo::DockItem)
  • $x (integer)
  • $y (integer)
  • $orientation (Gtk2::Orientation)

🎀 boolean = $dock->add_from_layout ($layout)

feed it a layout and it'll build the dock from it. returns a boolean, so like… did it work or not, bestie 😭

  • $layout (Gnome2::Bonobo::DockLayout)

🎀 $dock->add_item ($item, $placement, $band_num, $position, $offset, $in_new_band)

the full-control version of adding an item. so many knobs, so little time 🙈

  • $item (Gnome2::Bonobo::DockItem)
  • $placement (Gnome2::Bonobo::DockPlacement)
  • $band_num (integer)
  • $position (integer)
  • $offset (integer)
  • $in_new_band (boolean)

🎀 $dock->allow_floating_items ($enable)

turn floating items on or off. it's a vibe switch, lowkey 🦋

  • $enable (boolean)

🎀 widget = $dock->get_client_area

grabs the client area widget. that's it, that's the tweet 💖

🎀 $dock->set_client_area ($widget)

sets the client area. partner method to the one above, they're a matched set 👑

  • $widget (Gtk2::Widget)

🎀 list = $dock->get_item_by_name ($name)

look up an item by name, bestie 🔍

  • $name (string)
Returns a BonoboDockItem, a BonoboDockPlacement and three unsigned integers corresponding to num_band, band_position and offset.

so yeah, you get a whole list back, not just one thing. five whole returns. iconic behaviour honestly.

🎀 docklayout = $dock->get_layout

hands you back the dock layout. cute, simple, we love her 🌸

🔥 SIGNALS 🔥

  • layout-changed (Gnome2::Bonobo::Dock)

one signal, but she's important. when the layout changes, you'll know 👀

🌈 ENUMS AND FLAGS 🌈

💜 enum Gnome2::Bonobo::DockPlacement

where things can go, bestie:

  • 'top' / BONOBO_DOCK_TOP
  • 'right' / BONOBO_DOCK_RIGHT
  • 'bottom' / BONOBO_DOCK_BOTTOM
  • 'left' / BONOBO_DOCK_LEFT
  • 'floating' / BONOBO_DOCK_FLOATING

all four sides plus the chaotic floating option. we respect it 💅

💜 enum Gtk2::Orientation

the classic two:

  • 'horizontal' / GTK_ORIENTATION_HORIZONTAL
  • 'vertical' / GTK_ORIENTATION_VERTICAL

left to right or up and down, pick your fighter ⭐

👑 SEE ALSO 👑

go read these next, they're all connected fr fr:

  • Gnome2
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object
  • Gtk2::Widget
  • Gtk2::Container

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

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

okay that's the whole page bestie, you ate that 🫶 this was perl v5.42.0, dated 2025-07-25, and it's the Gnome2:...o::Dock(3) page from the User Contributed Perl Documentation set. periodt 💅✨

📦 where this page comes from