Gtk2::E...::Popup(3)

💖 Gtk2::E...::Popup — bestie edition 💖

okay so this is Gtk2::Ex::FormFactory::Popup, from the User Contributed Perl Documentation manual, and it's literally the popup widget of the FormFactory universe. sit down, grab a boba, we're doing this 🧋✨

---

✨ NAME ✨

Gtk2::Ex::FormFactory::Popup — a Popup inside a FormFactory framework 🫶

---

🌸 SYNOPSIS 🌸

Gtk2::Ex::FormFactory::Popup->new (
  ...
  Gtk2::Ex::FormFactory::Widget attributes
);

---

💅 DESCRIPTION 💅

This class implements a Popup in a Gtk2::Ex::FormFactory framework. And here's the vibe: whichever entry is selected in your Popup is controlled by the value of the associated application object attribute. That attribute is either:

• an index into an array of possible Popup entries, or
• a key of a hash of possible Popup entries.

So like, the app object is the main character and the Popup is just following its lead, periodt. 👑

Head over to the chapter REQUIREMENTS FOR ASSOCIATED APPLICATION OBJECTS for the details, bestie — don't skip it, it's important fr fr.

---

🦋 OBJECT HIERARCHY 🦋

Gtk2::Ex::FormFactory::Intro

Gtk2::Ex::FormFactory::Widget
+--- Gtk2::Ex::FormFactory::Popup

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

look at her, sitting right under Gtk2::Ex::FormFactory::Widget like the icon she is 💖

---

🎀 ATTRIBUTES 🎀

So attributes are handled through the common get_ATTR(), set_ATTR() style accessors — very standard, very demure. But here's the thing: they're mostly passed once to the object constructor and must not be altered after the associated FormFactory was built. So set it and forget it, no take-backs 🙈

• items = ARRAYREF|HASHREF [optional] — this attribute takes a static list of popup items, for when the popup shouldn't be controlled dynamically by an associated application object. Refer to the next chapter for details of the data structure applied here. ✨

---

🌈 REQUIREMENTS FOR ASSOCIATED APPLICATION OBJECTS 🌈

Application objects represented by a Gtk2::Ex::FormFactory::Popup must define additional methods — unless their content is static by setting items. So either you bring the methods or you bring the items, pick a struggle 💀

The naming of the methods listed beyond uses the standard get_ prefix for the attribute read accessor. ATTR needs to be replaced by the actual name of the attribute associated with the widget. So swap in your real attribute name, don't leave it as ATTR, iykyk.

• get_ATTR_list — this returns the entries of the Popup. Three data models are supported here:
  • Simple ARRAY — if the method returns a reference to a simple array, the popup will be filled with the array values in the original array order.

The index of the actually selected popup entry is stored in the attribute of the associated application object. 🍓

• Two dimensional ARRAY — the method may return a reference to a two dimensional array. Each row needs to have the attribute value in the first column and the label for the corresponding item in the second. 👑
• HASH — if the method returns a reference to a hash, the popup will be filled with the alphanumerically sorted hash values.

In turn the hash key of the actually selected popup entry is stored in the attribute of the associated application object. 🔥

---

💜 AUTHORS 💜

Jörn Reder <joern at zyn dot de> — shoutout to the 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.

ngl the all-caps "WITHOUT ANY WARRANTY" is giving scary but it's just the standard license energy, no cap 💀

---

🙈 POD ERRORS 🙈

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

Around line 245:

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

like... the umlaut in Jörn said "I'm not waiting for an =encoding line, I'm assuming UTF-8 and I'm leaving" and honestly? valid. 😭

---

and that's the whole page, bestie!! this doc ships with perl v5.42.0, dated 2025-07-25 — go forth, build your popups, and slay 💅✨🌈