Gtk2::E...kWidget(3)

✨ NAME ✨

Gtk2::Ex::FormFactory::GtkWidget — bestie, it's literally just "Wrap arbitrary Gtk widgets" 💅 that's the whole vibe, that's the whole job.

Oh and hi, this page lives in the User Contributed Perl Documentation section of your manual, and the man page name is Gtk2::E...kWidget(3) (yes the name is truncated like that, she's mysterious, she's got main character energy 🎀).

---

🌸 SYNOPSIS 🌸

okay so here's the whole entire move:

Gtk2::Ex::FormFactory::GtkWidget->new (
  custom_gtk_widget => Gtk::Widget,
  ...
  Gtk2::Ex::FormFactory::Widget attributes
);

that's it. that's the whole thing. periodt. ✨

---

💖 DESCRIPTION 💖

So the way this module works: you can drop arbitrary Gtk widgets into a FormFactory. Like, any Gtk widget. Whatever you want. They just get displayed there, looking all cute in the form 🫶.

BUT — and this is the important part, bestie, listen — their state isn't managed by Gtk2::Ex::FormFactory, because FormFactory literally knows nothing about the widget. No details. Zero. She's just sitting there looking pretty, not participating in any of the state management. Not me being like "okay and?" 😭

So if you actually need the full functionality for a custom Gtk widget, you're gonna need to implement your own Gtk2::Ex::FormFactory::Widget for it. Go read the docs for Gtk2::Ex::FormFactory::Widget — that's where the deets about implementing your own FormFactory widgets live. iykyk 📖✨

---

🌈 OBJECT HIERARCHY 🌈

look at the family tree, she's gorgeous:

Gtk2::Ex::FormFactory::Intro

Gtk2::Ex::FormFactory::Widget
+--- Gtk2::Ex::FormFactory::GtkWidget

Gtk2::Ex::FormFactory::Layout
Gtk2::Ex::FormFactory::Rules
Gtk2::Ex::FormFactory::Context
Gtk2::Ex::FormFactory::Proxy

see that +---? that's her. she's the child of Gtk2::Ex::FormFactory::Widget. iconic lineage, no cap 👑

---

💅 ATTRIBUTES 💅

So attributes here get handled through the classic get_ATTR() / set_ATTR() style accessors — you know the drill. But lowkey, they're mostly passed once to the object constructor and then you must not alter them after the associated FormFactory was built. Like, once the FormFactory is built, that's it, hands off 🚫

• custom_gtk_widget = Gtk::Widget [mandatory] — this is a Gtk::Widget to be displayed inside a FormFactory. Note that it's custom_gtk_widget (underscores, bestie) and it's mandatory, so no skipping it 🙈

For more attributes, go check out Gtk2::Ex::FormFactory::Widget. She's got the rest of them.

---

🎀 AUTHORS 🎀

Jörn Reder <joern at zyn dot de>

(one author. one legend. we stan 🫶)

---

👑 COPYRIGHT AND LICENSE 👑

Copyright 2004-2006 by Jörn Reder.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.

okay real talk, that "WITHOUT ANY WARRANTY" part is in all caps for a reason — no promises, no guarantees, she said what she said 💀

---

😭 POD ERRORS 😭

Hey! The above document had some coding errors, which are explained below:

Around line 91:

Non-ASCII character seen before =encoding in 'Jörn'. Assuming UTF-8

not the ö in 'Jörn' getting flagged by the POD parser 😭 she's just German, leave her alone 🙈 (it assumed UTF-8, it's fine, we move on)

---

and that's the whole page bestie, you're officially an expert 💜 this was perl v5.42.0, dated 2025-07-25, and it's the Gtk2::E...kWidget(3) man page — go forth and wrap some arbitrary Gtk widgets, slay ✨🦋