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

Curses::UI::Menubar<\/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::Menubar \u2212 Create and manipulate menubar widgets<\/p>\n

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

Curses::UI::Widget
|
+\u2212\u2212\u2212\u2212Curses::UI::Container
|
+\u2212\u2212\u2212\u2212Curses::UI::Window
|
+\u2212\u2212\u2212\u2212Curses::UI::Menubar<\/p>\n

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

use Curses::UI;
my $cui = new Curses::UI;
# define the menu datastructure.
my $menu_data = [….];
my $menu = $cui\u2212>add(
‘menu’, ‘Menubar’,
\u2212menu => $menu_data
);
$menu\u2212>focus();<\/p>\n

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

This class can be used to add a menubar to Curses::UI. This menubar can contain a complete submenu hierarchy. It looks (remotely :\u2212) 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\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212
menu1 | menu2 | menu3 | ….
\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212
+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+
|menuitem 1 |
|menuitem 2 |+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+
|menuitem 3 >>||submenuitem 1 |
|menuitem 4 ||submenuitem 2 |
+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+|submenuitem 3 |
|submenuitem 4 |
|submenuitem 5 |
+\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212+<\/p>\n

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

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

This class does not use any of the standard options that are provided by Curses::UI::Widget.<\/p>\n

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

There is only one option: \u2212menu<\/b>. The value for this option is an ARRAYREF.<\/small> This ARRAYREF<\/small> behaves exactly like the one that is described in Curses::UI::MenuListbox. The difference is that for the top-level menu, you will only use \u2212submenu\u2019s. Example data structure:<\/p>\n

my $menu1 = [
{ \u2212label => ‘option 1’, \u2212value => ‘1\u22121’ },
{ \u2212label => ‘option 2’, \u2212value => ‘1\u22122’ },
{ \u2212label => ‘option 3’, \u2212value => ‘1\u22123’ },
];
my $menu2 = [
{ \u2212label => ‘option 1’, \u2212value => &sel1 },
{ \u2212label => ‘option 2’, \u2212value => &sel2 },
{ \u2212label => ‘option 3’, \u2212value => &sel3 },
];
my $submenu = [
{ \u2212label => ‘suboption 1’, \u2212value => ‘3\u22123\u22121’ },
{ \u2212label => ‘suboption 2’, \u2212callback=> &do_it },
];
my $menu3 = [
{ \u2212label => ‘option 1’, \u2212value => &sel2 },
{ \u2212label => ‘option 2’, \u2212value => &sel3 },
{ \u2212label => ‘submenu 1’, \u2212submenu => $submenu },
];
my $menu = [
{ \u2212label => ‘menu 1’, \u2212submenu => $menu1 },
{ \u2212label => ‘menu 2’, \u2212submenu => $menu2 }
{ \u2212label => ‘menu 3’, \u2212submenu => $menu3 }
];<\/p>\n

METHODS <\/a> <\/h2>\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<\/table>\n

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

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

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

<\/td>\n\n

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

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

Call the \u2019escape\u2019 routine. This will have the menubar loose its focus and return the value \u2019 ESCAPE<\/small> \u2019 to the calling routine.<\/p>\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 \u2019return\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

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

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

Call the \u2019pulldown\u2019 routine. This will open the menulistbox for the current menu and give that menulistbox the focus. What happens after the menulistbox loses its focus, depends upon the returnvalue of it:<\/p>\n

* the value \u2019 CURSOR_LEFT<\/small> \u2019<\/p>\n

Call the ‘cursor\u2212left’ routine and after that
call the ‘pulldown’ routine. So this will open
the menulistbox for the previous menu.<\/p>\n

* the value \u2019 CURSOR_RIGHT<\/small> \u2019<\/p>\n

Call the ‘cursor\u2212right’ routine and after that
call the ‘pulldown’ routine. So this will open
the menulistbox for the next menu.<\/p>\n

* the value \u2019 LOOSE_FOCUS<\/small> \u2019<\/p>\n

The menubar will keep the focus, but no
menulistbox will be open.<\/p>\n

* the value \u2019 ESCAPE<\/small> \u2019<\/p>\n

The menubar will loose its focus and return the
value ‘ESCAPE’ to the calling routine.<\/p>\n

* A CODE<\/small> reference<\/p>\n

The code will be excuted, the menubar will loose its
focus and the returnvalue of the CODE will be
returned to the calling routine.<\/p>\n

* Any other value<\/p>\n

The menubar will loose its focus and the value will
be returned to the calling routine.<\/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 \u2019cursor\u2212left\u2019 routine. This will select the previous menu. If the first menu is already selected, the last menu will be selected.<\/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 \u2019cursor\u2212right\u2019 routine. This will select the next menu. If the last menu is already selected, the first menu will be selected.<\/p>\n

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

Curses::UI, Curses::UI::MenuListbox, Curses::UI::Listbox<\/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::Menubar \u2212 Create and manipulate menubar 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":[3719,3007],"class_list":["post-7406","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-cursesuimenubar","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7406","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=7406"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7406\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7406"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7406"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7406"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}