Prima::Tie(3)

🎀 NAME 🎀

Okay so bestie, welcome to the Prima::Tie(3) page — it’s from the User Contributed Perl Documentation, and the manual name is right up front: Prima::Tie. The whole vibe? tie widget properties to scalars and arrays. That’s the name, that’s the assignment, and it’s lowkey iconic. 💅

💖 DESCRIPTION 💖

Here’s the tea ☕: Prima::Tie contains two abstract classes, Prima::Tie::Array and Prima::Tie::Scalar, and they tie an array or a scalar to a widget’s arbitrary array or scalar property.

It also contains the classes Prima::Tie::items, Prima::Tie::text, and Prima::Tie::value, which tie a variable to a widget’s items, text, and value properties respectively. Slay. ✨

✨ SYNOPSIS ✨

use Prima::Tie;

tie @items, 'Prima::Tie::items', $widget;

tie @some_property, 'Prima::Tie::Array', $widget, 'some_property';

tie $text, 'Prima::Tie::text', $widget;

tie $some_property, 'Prima::Tie::Scalar', $widget, 'some_property';

🦋 USAGE 🦋

These classes give you immediate access to a widget’s array and scalar properties — especially the popular ones, items and text. And bestie, it is considerably simpler to say:

splice(@items,3,1,'new item');

than to say:

my @i = @{$widget->items};
splice(@i,3,1,'new item');
$widget->items(\@i);

That way, you can work directly with the text or items. Furthermore, if the only reason you keep an object around after creation is to access its text or items, you no longer need to do so:

tie @some_array, 'Prima::Tie::items', Prima::ListBox->new(@args);

As opposed to:

my $widget = Prima::ListBox->new(@args);
tie @some_array, 'Prima::Tie::items', $widget;

Prima::Tie::items requires the ::items property to be available on the widget. Also, it takes advantage of additional get_items, add_items, and the like methods if available. No cap, that’s the whole usage vibe. 🫶

🌸 Prima::Tie::items 🌸

This class is applicable to Prima::ListViewer, Prima::ListBox, Prima::Widget::Header, and their descendants — and in a limited fashion to Prima::OutlineViewer and its descendants Prima::StringOutline and Prima::Outline. Limited fashion is still fashion, bestie. 💅

🌈 Prima::Tie::text 🌈

This class is applicable to any widget. Periodt. ✨

👑 Prima::Tie::value 👑

This class is applicable to:

• Prima::GroupBox
• Prima::Dialog::ColorDialog
• Prima::SpinEdit
• Prima::Gauge
• Prima::Slider
• Prima::CircularSlider
• Prima::ScrollBar

The listed widget crew, lined up and ready. 👑💖

💅 COPYRIGHT 💅

Copyright 2004 Teo Sankaro

This program is distributed under the BSD License. (Although a credit would be nice.) Yes, bestie, a credit would be nice — don’t be shy. 🎀

🫶 AUTHORS 🫶

Teo Sankaro, <teo_sankaro@hotmail.com>. Dmitry Karasik, <dmitry@karasik.eu.org>.

Shoutout to the authors, fr fr. 💜

---

And that’s the page, bestie! Footer tea for the record: this is Prima::Tie(3), from perl v5.42.0, dated 2024-08-20. You understood the assignment. Mwah 💋