{"id":6995,"date":"2022-12-20T19:34:35","date_gmt":"2022-12-20T22:34:35","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/cursesuicalendar-man3\/"},"modified":"2022-12-20T19:34:35","modified_gmt":"2022-12-20T22:34:35","slug":"cursesuicalendar-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/cursesuicalendar-man3\/","title":{"rendered":"Curses::UI::Calendar (man3)"},"content":{"rendered":"

Curses::UI::Calendar<\/h1>\n

NAME<\/a>
CLASS HIERARCHY<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
STANDARD OPTIONS<\/a>
WIDGET-SPECIFIC OPTIONS<\/a>
METHODS<\/a>
DEFAULT BINDINGS<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

Curses::UI::Calendar \u2212 Create and manipulate calendar widgets<\/p>\n

CLASS HIERARCHY <\/a> <\/h2>\n

Curses::UI::Widget
|
+\u2212\u2212\u2212\u2212Curses::UI::Calendar<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

use Curses::UI;
my $cui = new Curses::UI;
my $win = $cui\u2212>add(‘window_id’, ‘Window’);
my $calendar = $win\u2212>add(
‘mycalendar’, ‘Calendar’,
\u2212date => ‘2002\u22121\u221214’
);
$calendar\u2212>focus();
my $date = $calendar\u2212>get();<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

Curses::UI::Calendar is a widget that can be used to create a calendar in which the user can select a date. The calendar widget looks like this:<\/p>\n

+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+
| mmm dd yyyy |
+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+
| su mo tu we th fr sa |
| |
| 01 02 03 04 05 |
| 06 07 08 09 10 11 12 |
| 13 14 15 16 17 18 19 |
| 20 21 22 23 24 25 26 |
| 27 28 29 30 31 |
+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+<\/p>\n

See exampes\/demo\u2212Curses::UI::Calendar in the distribution for a short demo.<\/p>\n

STANDARD OPTIONS <\/a> <\/h2>\n

\u2212parent<\/b>, \u2212x<\/b>, \u2212y<\/b>, \u2212width<\/b>, \u2212height<\/b>, \u2212pad<\/b>, \u2212padleft<\/b>, \u2212padright<\/b>, \u2212padtop<\/b>, \u2212padbottom<\/b>, \u2212ipad<\/b>, \u2212ipadleft<\/b>, \u2212ipadright<\/b>, \u2212ipadtop<\/b>, \u2212ipadbottom<\/b>, \u2212title<\/b>, \u2212titlefullwidth<\/b>, \u2212titlereverse<\/b>, \u2212onfocus<\/b>, \u2212onblur<\/b><\/p>\n

For an explanation of these standard options, see Curses::UI::Widget.<\/p>\n

Remark<\/b>: \u2212width<\/b> and \u2212height<\/b> can be set, but this widget really want to have its content space at a minimum size. If your \u2212width<\/b> or \u2212height<\/b> is not large enough, the widget will automatically fix its value.<\/p>\n

WIDGET-SPECIFIC OPTIONS <\/a> <\/h2>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

\u2212date<\/b> < DATE<\/small> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

This option sets the date to start with. If you do not specify a date, today\u2019s date will be used automatically. The format that you can use for this date is one of:<\/p>\n

* YYYY-M-D<\/b> (e.g. 2002\u22121\u221210 or 2002\u221201\u221210)<\/p>\n

* YYYY\/M\/D<\/small><\/b> (e.g. 2002\/1\/10 or 2002\/01\/10))<\/p>\n

* YYYYMMDD<\/small><\/b> (e.g. 20020110)<\/p>\n

* D\u2212M-YYYY<\/b> (e.g. 10\u22121\u22122002 or 10\/01\/2002)<\/p>\n

* D\/M\/YYYY<\/b> (e.g. 10\/1\/2002 or 10\/01\/2002)<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

\u2212onchange<\/b> < CODEREF<\/small> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

This sets the onChange event handler for the calendar widget. If a new date is selected, the code in CODEREF<\/small> will be executed. It will get the widget reference as its argument.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

\u2212drawline<\/b> < CODEREF<\/small> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

This option specifies whether or not a line should be drawn under the calendar.<\/p>\n

METHODS <\/a> <\/h2>\n\n\n\n\n\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

new<\/b> ( OPTIONS<\/small> )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

layout<\/b> ( )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

draw<\/b> ( BOOLEAN<\/small> )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

focus<\/b> ( )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

onFocus<\/b> ( CODEREF<\/small> )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

onBlur<\/b> ( CODEREF<\/small> )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

intellidraw<\/b> ( )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

These are standard methods. See Curses::UI::Widget for an explanation of these.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

get<\/b> ( )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

This method will return the currently selected date in the format \u2019 YYYY\u2212MM\u2212DD<\/small> \u2019.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

setdate<\/b> ( DATE,<\/small> [ BOOLEAN<\/small> ] )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Set the selected date of the widget to DATE.<\/small> See \u2212date<\/b> above for the possible formats. The widget will redraw itself, unless BOOLEAN<\/small> has a true value.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

onChange<\/b> ( CODEREF<\/small> )<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

This method can be used to set the \u2212onchange<\/b> event handler (see above) after initialization of the calendar.<\/p>\n

DEFAULT BINDINGS <\/a> <\/h2>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<tab<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019loose\u2212focus\u2019 routine. This will have the menubar loose its focus and return the value \u2019 LOOSE_FOCUS<\/small> \u2019 to the calling routine.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<enter<\/b>>, <space<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212select\u2019 routine. This will select the date on which the cursor is.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<cursor-left<\/b>>, <h<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212prevday\u2019 routine. This will have the date cursor go back one day.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<cursor-right<\/b>, <l<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212nextday\u2019 routine. This will have the date cursor go forward one day.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<cursor-down<\/b>>, <j<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212nextweek\u2019 routine. This will have the date cursor go forward one week.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<cursor-up<\/b>>, <k<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212prevweek\u2019 routine. This will have the date cursor go back one week.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<page-up<\/b>>, < SHIFT+K<\/small><\/b> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212prevmonth\u2019 routine. This will have the date cursor go back one month.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<page-down<\/b>>, < SHIFT+J<\/small><\/b> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212nextmonth\u2019 routine. This will have the date cursor go forward one month.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<p<\/b>>, < SHIFT+H<\/small><\/b> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212prevyear\u2019 routine. This will have the date cursor go back one year.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<n<\/b>>, < SHIFT+L<\/small><\/b> ><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212nextyear\u2019 routine. This will have the date cursor go forward one year.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<home<\/b>>, < CTRL+A<\/small><\/b> >, <c<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212selected\u2019 routine. This will have the date cursor go to the current selected date.<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

<t<\/b>><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Call the \u2019date\u2212today\u2019 routine. This will have the date cursor go to today\u2019s date.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

Curses::UI, Curses::UI::Widget, Curses::UI::Common<\/p>\n

AUTHOR <\/a> <\/h2>\n

Copyright (c) 2001\u22122002 Maurice Makaay. All rights reserved.<\/p>\n

Maintained by Marcus Thiesen (marcus@cpan.thiesenweb.de)<\/p>\n

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.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Curses::UI::Calendar \u2212 Create and manipulate calendar widgets <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3345,3007],"class_list":["post-6995","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-cursesuicalendar","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6995","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6995"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6995\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6995"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6995"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6995"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}