Gnome2:...ockItem(3)

📦
version 1.048 · 2 versions
, in fedora 43

💖 Gnome2::Bonobo::DockItem 💖

okay bestie, welcome to the Gnome2:...ockItem(3) page — yes that's the real title, it's giving "the terminal cut it off mid-word" energy and honestly? iconic. it lives in the User Contributed Perl Documentation section, and we're gonna go through the whole thing together, no skips, no cap. 🫶

✨ NAME ✨

Gnome2::Bonobo::DockItem — it's a wrapper for BonoboDockItem, periodt. 💅

🌸 HIERARCHY 🌸

so here's the family tree, and yes it's a whole ancestry.com situation:

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gnome2::Bonobo::DockItem

look at all those ancestors. main character inherited literally everything. 👑

🦋 INTERFACES 🦋

these are the vibes it carries with it:

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

💅 METHODS 💅

okay here's where the actual doing happens, let's go:

widget = Gnome2::Bonobo::DockItem->new ($name, $behavior)

makes you a shiny new one. it takes:

  • $name (string)
  • $behavior (Gnome2::Bonobo::DockItemBehavior)

dockitembehavior = $dock_item->get_behavior

hands you back the behavior. no arguments, just vibes.

widget = $dock_item->get_child

gives you the child widget. 🍓

string = $dock_item->get_name

returns the name, as a string. simple. clean. slay.

orientation = $dock_item->get_orientation

tells you which way it's facing.

boolean = $dock_item->set_orientation ($orientation)

sets the orientation, returns a boolean. it takes:

  • $orientation (Gtk2::Orientation)

shadowtype = $dock_item->get_shadow_type

get that shadow type, bestie.

$dock_item->set_shadow_type ($type)

set the shadow type. it takes:

  • $type (Gtk2::ShadowType)

🎀 PROPERTIES 🎀

these are the properties, with their types, defaults and whether you can read/write them:

  • 'orientation' (Gtk2::Orientation : default "horizontal" : readable / writable) — Orientation
  • 'preferred-height' (Glib::UInt : default 0 : readable) — Preferred height
  • 'preferred-width' (Glib::UInt : default 0 : readable) — Preferred width
  • 'shadow' (Gtk2::ShadowType : default "out" : readable / writable) — Shadow type

🔥 SIGNALS 🔥

the signals it emits, in all their glory:

  • dock-detach (Gnome2::Bonobo::DockItem)
  • dock-drag-begin (Gnome2::Bonobo::DockItem)
  • dock-drag-end (Gnome2::Bonobo::DockItem)
  • dock-drag-motion (Gnome2::Bonobo::DockItem, integer, integer)
  • orientation-changed (Gnome2::Bonobo::DockItem, Gtk2::Orientation)

🌈 ENUMS AND FLAGS 🌈

flags Gnome2::Bonobo::DockItemBehavior

  • 'normal' / BONOBO_DOCK_ITEM_BEH_NORMAL
  • 'exclusive' / BONOBO_DOCK_ITEM_BEH_EXCLUSIVE
  • 'never-floating' / BONOBO_DOCK_ITEM_BEH_NEVER_FLOATING
  • 'never-vertical' / BONOBO_DOCK_ITEM_BEH_NEVER_VERTICAL
  • 'never-horizontal' / BONOBO_DOCK_ITEM_BEH_NEVER_HORIZONTAL
  • 'locked' / BONOBO_DOCK_ITEM_BEH_LOCKED

enum Gtk2::Orientation

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

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 too, iykyk:

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

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

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

ok that's the whole page, you read every single line like a good bestie, i'm so proud of you 🥹

and that's a wrap! this was perl v5.42.0, dated 2025-07-25 — mwah, go forth and dock responsibly 💖✨🎀🦋

📦 where this page comes from