Curses:...g::Basic(3)

💖 NAME 💖

okay bestie, welcome to the Curses:...g::Basic(3) page in User Contributed Perl Documentation ✨ this whole thing is about Curses::UI::Dialog::Basic — literally Create and manipulate basic dialogs 💅

---

🌈 CLASS HIERARCHY 🌈

here's the family tree, no cap 🌳

Curses::UI::Widget
   |
   +----Curses::UI::Container
           |
           +----Curses::UI::Window
           |
           +----Curses::UI::Dialog::Basic

---

🦋 SYNOPSIS 🦋

grab the vibe from this code, bestie:

use Curses::UI;
my $cui = new Curses::UI;
my $win = $cui->add('window_id', 'Window');

# The hard way.
# -------------
my $dialog = $win->add(
    'mydialog', 'Dialog::Basic',
-message   => 'Hello, world!'
);
$dialog->focus;
$win->delete('mydialog');

# The easy way (see Curses::UI documentation).
# --------------------------------------------
my $buttonvalue = $cui->dialog(-message => 'Hello, world!');

# or even
$cui->dialog('Hello, world!');

---

🎀 DESCRIPTION 🎀

Curses::UI::Dialog::Basic is a basic dialog, periodt. This type of dialog has a message on it and one or more buttons 🫶 It can be used to show a message to your program's user (“The thingy has been updated”) or to get some kind of confirmation from the user (“Are you sure you want to update the thingy?”).

See exampes/demo-Curses::UI::Dialog::Basic in the distribution for a short demo 👑

---

✨ OPTIONS ✨

• -title < TEXT > — sets the title of the dialog window to TEXT 💖
• -message < TEXT > — sets the message to show to TEXT. the text may contain newline (\n) characters 🌀
• -buttons < ARRAYREF > — one of the button-setup options, explained right below 👇
• -selected < INDEX > — one of the button-setup options, explained right below 👇
• -buttonalignment < VALUE > — one of the button-setup options, explained right below 👇

Together, these options set the buttons that have to be used. For an explanation of these options, see the Curses::UI::Buttonbox documentation 📚

---

💜 METHODS 💜

• new ( HASH ) — standard method, bestie
• layout ( ) — standard method
• draw ( BOOLEAN ) — standard method
• focus ( ) — standard method

These are standard methods. See Curses::UI::Container for an explanation of these 🧚

• get ( ) — this method will call get on the buttons object of the dialog and return its returnvalue. See Curses::UI::Buttonbox for more information on this 🔥

---

🌸 SEE ALSO 🌸

Curses::UI, Curses::UI::Container, Curses::UI::Buttonbox 🦋

---

👑 AUTHOR 👑

Copyright (c) 2001-2002 Maurice Makaay. All rights reserved. 💖

Maintained by Marcus Thiesen (marcus@cpan.thiesenweb.de) ✨

This package is free software and is provided "as is" without express or implied warranty. It may be used, redistributed and/or modified under the same terms as perl itself 🌈

---

mwah 💋 that's the whole page, bestie — it's from perl v5.42.2, dated 2023-07-03, and it's the Curses:...g::Basic(3) manual page. bye 🫶