UI::Di...::GNOME(3pm)

📦
version 1.21 · 3 versions
, in ubuntu jammy, ubuntu noble

💖 UI::Dialog::GNOME — the perl manual page, but make it slay 💖

okay bestie, so this is UI::Dialog::GNOME(3pm), straight out of the User Contributed Perl Documentation ✨ it's a whole manpage and we're gonna read it together, no skipping 🫶

🌸 NAME 🌸

UI::Dialog::GNOME — a GNOME GUI meta-class for UI::Dialog. it's giving "same energy, different priorities" 💅

✨ SYNOPSIS ✨

here's the vibe, copy it exactly:

use UI::Dialog::GNOME;
my $d = new UI::Dialog::GNOME ( title => 'Default title',
                                height => 20, width => 65 ,
                                listheight => 5,
                                order => [ 'zenity', 'xdialog' ] );

# Either a Zenity or Xdialog msgbox widget should popup,
# with a preference for Zenity.
$d->msgbox( title => 'Welcome!', text => 'Welcome one and all!' );

so either a Zenity widget or an Xdialog widget should pop up, and it lowkey prefers Zenity 🎀

🦋 ABSTRACT 🦋

UI::Dialog::GNOME is just another meta-class for UI::Dialog. literally the only glow-up is a different order of priority than UI::Dialog, plus no console support 🙈 that's the whole thing, periodt.

💜 DESCRIPTION 💜

this class is a cute way to try and guarantee a GNOME based widget set, bestie. and the editbox() widget? it's provided on top of the standard widgets, because both the XDialog and Zenity backends effectively support it being used 🌈

⚠️ ok important: if you're still using GDialog and not Zenity (Zenity provides a very nice gdialog wrapper, fyi), then the editbox() widget will make your application die with a "missing method editbox()" error 💀 not a vibe. heads up.

🎀 EXPORT 🎀

None

nothing. zero. nada. iconic minimalism ✨

👑 INHERITS 👑

UI::Dialog

that's the parent, the blueprint, the ancestry 💖

🌟 CONSTRUCTOR 🌟

new( @options )

EXAMPLE

my $d = new( title => 'Default Title', backtitle => 'Backtitle',
             width => 65, height => 20, listheight => 5,
             order => [ 'zenity', 'xdialog', 'gdialog' ] );

DESCRIPTION

this is the Class Constructor method, bestie. it takes a list of key => value pairs and uses them as the defaults whenever you interact with the various widgets 🫶

RETURNS

a blessed object reference of the UI::Dialog::GNOME class. yes ma'am, an object, a whole little guy 💅

OPTIONS

the (...) after each option tells you the default, iykyk:

  • debug = 0,1,2 — (default 0)
  • order = [ zenity, xdialog, gdialog ] — (as indicated)
  • PATH = [ /bin, /usr/bin, /usr/local/bin, /opt/bin ] — (as indicated)
  • backtitle = "backtitle" — (default '')
  • title = "title" — (default '')
  • beepbefore = 0,1 — (default 0)
  • beepafter = 0,1 — (default 0)
  • height = \d+ — (default 20)
  • width = \d+ — (default 65)
  • listheight = \d+ — (default 5)

🔥 WIDGET METHODS 🔥

editbox( )

EXAMPLE

$d->editbox( path => '/path/to/a/text/file' );

DESCRIPTION

presents your end user with an editable textbox stuffed with the contents of the given text file 📝 main character energy fr fr.

RETURNS

a SCALAR containing the edited text if the response is OK — and FALSE (0) for anything else. that's it, that's the deal 🌸

💀 SEE ALSO 💀

PERLDOC

  • UI::Dialog
  • UI::Dialog::Backend
  • UI::Dialog::Backend::GDialog
  • UI::Dialog::Backend::Nautilus
  • UI::Dialog::Backend::XDialog
  • UI::Dialog::Backend::XOSD
  • UI::Dialog::Backend::Zenity

MAN FILES

zenity(1), gdialog(1), Xdialog(1), osd_cat(1) and nautilus(1) — go read those too bestie 📚

🐛 BUGS 🐛

please email the author with any bug reports! and put the name of the module in the subject line, or else it's chaos 🙈

🧚 AUTHOR 🧚

Kevin C. Krinke, <kevin@krinke.ca> — legend behavior, honestly 👑

Copyright (C) 2004-2016  Kevin C. Krinke <kevin@krinke.ca>

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser 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
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser 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
⚠️ note the WITHOUT ANY WARRANTY line, bestie — it's free software, it's LGPL v2.1 or later, and there's no promise it'll do anything in particular. read it, respect it 💅

okay that's the whole page!! this one came from perl v5.28.0 and it's dated 2018-10-27 🎀 thanks for reading the UI::Di...::GNOME(3pm) manpage with me, mwah 💋✨

📦 where this page comes from