Gnome2::App(3)

📦

version 1.048 · 2 versions

1.048 · fedora 43 (latest)
1.048 · fedora 44

💖 Gnome2::App 💖

okay bestie, so this whole page is the manual for Gnome2::App(3) — it lives under the User Contributed Perl Documentation umbrella and it's literally the Perl wrapper for GnomeApp. Like, the C thing? Wrapped. For you. In Perl. We're so back. ✨

🌸 NAME 🌸

Gnome2::App — wrapper for GnomeApp. that's it, that's the whole vibe. she wraps. she serves. 💅

🦋 HIERARCHY 🦋

here's the family tree, and yes she has main character energy all the way down:

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gtk2::Window
                                +----Gnome2::App

she's a Window that's been to college. ✨

🎀 INTERFACES 🎀

these are the interfaces she implements, no cap:

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

👑 METHODS 👑

okay this is the big one, grab a snack 🍓

✨ `widget = Gnome2::App->new ($appname, $title=undef)`

constructor queen. makes you a shiny new app.

$appname (string) — the app's name, string, you got this
$title (string) — the title, also a string, and it defaults to undef if you don't pass one

✨ `scalar = $app->accel_group`

hands you back the accel group as a scalar. keyboard shortcuts live here, iykyk. ⌨️

✨ `$app->add_dock_item ($item, $placement, $band_num, $band_position, $offset)`

plops a dock item into place. five whole arguments, she's thorough:

$item (Gnome2::Bonobo::DockItem) — the item itself
$placement (Gnome2::Bonobo::DockPlacement) — where it goes
$band_num (integer) — which band
$band_position (integer) — position within the band
$offset (integer) — the offset, yes it's an integer

✨ `widget = $app->add_docked ($widget, $name, $behavior, $placement, $band_num, $band_position, $offset)`

same energy, but you hand her a widget and she docks it for you. returns the widget. 🫶

$widget (Gtk2::Widget) — the widget going in
$name (string) — name it
$behavior (Gnome2::Bonobo::DockItemBehavior) — how it should behave
$placement (Gnome2::Bonobo::DockPlacement) — where it lands
$band_num (integer) — band number
$band_position (integer) — band position
$offset (integer) — offset

✨ `$app->add_toolbar ($toolbar, $name, $behavior, $placement, $band_num, $band_position, $offset)`

toolbar time!! same seven-arg situation, but for a toolbar instead of a widget.

$toolbar (Gtk2::Toolbar) — the toolbar
$name (string) — name
$behavior (Gnome2::Bonobo::DockItemBehavior) — behavior
$placement (Gnome2::Bonobo::DockPlacement) — placement
$band_num (integer) — band number
$band_position (integer) — band position
$offset (integer) — offset

✨ `scalar = $app->contents`

gets the contents, returns a scalar. simple. iconic.

✨ `$app->set_contents ($contents)`

sets the contents.

$contents (Gtk2::Widget) — the widget that becomes the contents

✨ `$app->create_menus ($uiinfo)`

builds the menus for you from UI info.

$uiinfo (Gnome2::UIInfo) — the UIInfo driving it

✨ `$app->create_toolbar ($uiinfo)`

same but a toolbar. she's versatile like that.

$uiinfo (Gnome2::UIInfo) — the UIInfo driving it

✨ `scalar = $app->dock`

gives you the dock as a scalar.

✨ `dock = $app->get_dock`

gives you the dock, but as a dock. yeah. two ways to get the same girl. 💀

✨ `dockitem = $app->get_dock_item_by_name ($name)`

find a dock item by name, returns a dockitem.

$name (string) — the name you're searching for

✨ `$app->enable_layout_config ($enable)`

flips layout config on or off.

$enable (boolean) — true/false, turn it on or don't

✨ `scalar = $app->get_enable_layout_config`

asks her whether layout config is enabled. returns a scalar.

✨ `$app->insert_menus ($path, $menuinfo)`

inserts menus at a path.

$path (string) — the path
$menuinfo (Gnome2::UIInfo) — the UIInfo

✨ `$app->install_menu_hints ($uiinfo)`

installs the menu hints.

$uiinfo (Gnome2::UIInfo) — the UIInfo with the hints

✨ `scalar = $app->layout`

the layout, as a scalar.

✨ `scalar = $app->menubar`

the menubar, as a scalar.

✨ `$app->set_menus ($menubar)`

sets the menubar.

$menubar (Gtk2::MenuBar) — the MenuBar you want

✨ `scalar = $app->prefix`

the prefix, as a scalar. ✨

✨ `$app->remove_menu_range ($path, $start, $items)`

yeets a range of menus out.

$path (string) — where
$start (integer) — start index
$items (integer) — how many items to remove

✨ `$app->remove_menus ($path, $items)`

same removal energy, just path + count.

$path (string) — where
$items (integer) — how many

✨ `Gnome2::App->setup_toolbar ($toolbar, $dock_item)`

a class method, not an instance one — call it on Gnome2::App itself. it sets up your toolbar. 💅

$toolbar (Gtk2::Toolbar) — the toolbar
$dock_item (Gnome2::Bonobo::DockItem) — the dock item

✨ `scalar = $app->statusbar`

the statusbar, as a scalar.

✨ `$app->set_statusbar_custom ($container, $statusbar)`

custom statusbar setup, because sometimes you need your own container.

$container (Gtk2::Widget) — the container
$statusbar (Gtk2::Widget) — the statusbar widget

✨ `$app->set_statusbar ($statusbar)`

the regular, non-custom statusbar setter.

$statusbar (Gtk2::Widget) — the statusbar widget

✨ `$app->set_toolbar ($toolbar)`

sets the toolbar.

$toolbar (Gtk2::Toolbar) — the toolbar

✨ `scalar = $app->vbox`

the vbox, as a scalar. and that's the last one bestie, you made it. 😭

💜 PROPERTIES 💜

'app-id' (string : default undef : readable / writable / construct) — the application ID string. she's readable, she's writable, she's construct. triple threat. 👑

🌈 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 `Gnome2::Bonobo::DockPlacement`

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

🫶 SEE ALSO 🫶

go read these next, bestie, they're all part of the family:

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

📜 COPYRIGHT 📜

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

and that's the whole page, babe!! this gem of a doc came to you via perl v5.42.0, dated 2025-07-25, and she's filed under Gnome2::App(3). go build something iconic with her. 💖✨🎀🦋

📦 where this page comes from

fedora 43: perl-Gnome2 1.048-18.fc43 · LGPL-2.1-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms

Gnome2::App(3)

💖 Gnome2::App 💖

🌸 NAME 🌸

🦋 HIERARCHY 🦋

🎀 INTERFACES 🎀

👑 METHODS 👑

✨ widget = Gnome2::App->new ($appname, $title=undef)

✨ scalar = $app->accel_group

✨ $app->add_dock_item ($item, $placement, $band_num, $band_position, $offset)

✨ widget = $app->add_docked ($widget, $name, $behavior, $placement, $band_num, $band_position, $offset)

✨ $app->add_toolbar ($toolbar, $name, $behavior, $placement, $band_num, $band_position, $offset)

✨ scalar = $app->contents

✨ $app->set_contents ($contents)

✨ $app->create_menus ($uiinfo)

✨ $app->create_toolbar ($uiinfo)

✨ scalar = $app->dock

✨ dock = $app->get_dock

✨ dockitem = $app->get_dock_item_by_name ($name)

✨ $app->enable_layout_config ($enable)

✨ scalar = $app->get_enable_layout_config

✨ $app->insert_menus ($path, $menuinfo)

✨ $app->install_menu_hints ($uiinfo)

✨ scalar = $app->layout

✨ scalar = $app->menubar

✨ $app->set_menus ($menubar)

✨ scalar = $app->prefix

✨ $app->remove_menu_range ($path, $start, $items)

✨ $app->remove_menus ($path, $items)

✨ Gnome2::App->setup_toolbar ($toolbar, $dock_item)

✨ scalar = $app->statusbar

✨ $app->set_statusbar_custom ($container, $statusbar)

✨ $app->set_statusbar ($statusbar)

✨ $app->set_toolbar ($toolbar)

✨ scalar = $app->vbox