Curses:...alendar(3)

💖 NAME 💖

okay so welcome to the Curses:...alendar(3) page from the User Contributed Perl Documentation, bestie ✨ this one is all about Curses::UI::Dialog::Calendar — Create and manipulate calendar dialogs. periodt.

---

🌳 CLASS HIERARCHY 🌳

the family tree is giving very structured, very iconic:

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

---

🌈 SYNOPSIS 🌈

okay here's the code, copy it exactly because it's main character energy:

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

           # The hard way.
           # -------------
           my $dialog = $win->add(
               'mydialog', 'Dialog::Calendar'
           );
           $dialog->modalfocus;
           $win->delete('mydialog');
           my $date = $dialog->get();

           # The easy way (see Curses::UI documentation).
           # --------------------------------------------
           $date = $cui->calendardialog();

---

🦋 DESCRIPTION 🦋

Curses::UI::Dialog::Calendar is a calendar dialog. This type of dialog can be used to select a date. 💖

want a short demo? see exampes/demo-widgets in the distribution. yes, that's the path, iykyk.

---

🎀 OPTIONS 🎀

• -title < TEXT > — sets the title of the dialog window to TEXT. 💅
• -date < DATE > — sets the date to start with to DATE. if -date is not defined, today will be used as the startdate. 🗓️

---

✨ METHODS ✨

• new ( OPTIONS ) — standard method.
• layout ( ) — standard method.
• draw ( BOOLEAN ) — standard method.
• focus ( ) — standard method.
• modalfocus ( ) — standard method.

these are standard methods, bestie — Curses::UI::Container has the explanation of these.

• get ( ) — returns the date that was selected, or undef if no date was selected. 🫶

---

💅 SPECIAL BINDINGS 💅

• escape — invokes the cancel button, so the calendar dialog returns without selecting any date. 🙈

---

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

---

okay that's the whole page, bestie — source/version is perl v5.42.2, date is 2023-07-03, and you're gonna slay those calendar dialogs 💅✨