Curses:...:Status(3)

💖 NAME 💖

Curses::UI::Dialog::Status — Create and manipulate status dialogs ✨

Okay so bestie, this is the Curses:...:Status(3) page from the User Contributed Perl Documentation, and it's literally all about making status dialogs with Curses::UI. No cap, it's giving useful.

---

🌈 CLASS HIERARCHY 🌈

The family tree is serving inheritance realness:

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

---

✨ SYNOPSIS ✨

Here's the whole flow, 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::Status',
-message   => 'Hello, world!',
);

$dialog->draw();

$win->delete('mydialog');

# The easy way (see Curses::UI documentation).
# --------------------------------------------
$cui->status( -message => 'Some message' );

# or even:
$cui->status( 'Some message' );

$cui->nostatus;

---

🦋 DESCRIPTION 🦋

Okay so real talk: Curses::UI::Dialog::Status is not really a dialog, because the user has no way of interacting with it. It's merely a way of presenting status information to the user of your program. Periodt.

Want a short demo? Check exampes/demo-Curses::UI::Dialog::Status in the distribution. Yes, that's the path exactly as written — iykyk.

---

🎀 OPTIONS 🎀

• -title < TEXT > — Sets the title of the dialog window to TEXT.
• -message < TEXT > — This option sets the initial message to show to TEXT.

---

💅 METHODS 💅

• new ( OPTIONS ) — Standard method vibes. It takes OPTIONS.
• layout ( ) — Standard method. No args, just layout energy.
• draw ( BOOLEAN ) — Standard method. It takes BOOLEAN.

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

• message ( TEXT ) — This method will update the message of the status dialog to TEXT. For this update to show, you will have to call the draw method of the progress dialog.

Heads up bestie: yes, it says progress dialog on this page. And the update won't show until you call draw. That's the vibe check. 💅

---

👑 SEE ALSO 👑

Curses::UI, Curses::UI::Container

---

🌸 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.

---

Okay bestie, that's the whole page. It comes from perl v5.42.2, dated 2023-07-03, and it's the Curses:...:Status(3) manual. Go make those status dialogs iconic 💖✨🦋