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

Curses::UI::Dialog::Filebrowser<\/h1>\n

NAME<\/a>
CLASS HIERARCHY<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
OPTIONS<\/a>
METHODS<\/a>
SPECIAL BINDINGS<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n

\n

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

Curses::UI::Dialog::Filebrowser \u2212 Create and manipulate filebrowser dialogs<\/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::Dialog::Filebrowser<\/p>\n

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

use Curses::UI;
my $cui = new Curses::UI;
my $win = $cui\u2212>add(‘window_id’, ‘Window’);
# The hard way.
# \u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212
my $dialog = $win\u2212>add(
‘mydialog’, ‘Dialog::Filebrowser’
);
$dialog\u2212>focus;
my $file = $dialog\u2212>get();
$win\u2212>delete(‘mydialog’);
# The easy way (see Curses::UI documentation).
# \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
$file = $cui\u2212>filebrowser();
$file = $cui\u2212>loadfilebrowser();
$file = $cui\u2212>savefilebrowser();<\/p>\n

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

Curses::UI::Dialog::Filebrowser is a filebrowser dialog. This type of dialog can be used to select a file, anywhere on the filesystem.<\/p>\n

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

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

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

<\/td>\n\n

\u2212title<\/b> < TEXT<\/small> ><\/p>\n<\/td>\n

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

Set the title of the dialog window to TEXT.<\/small><\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212path<\/b> < PATH<\/small> ><\/p>\n<\/td>\n

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

Set the path to start with to PATH.<\/small> If this path does not exist, the filebrowser will start in the rootdirectory.<\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212file<\/b> < FILE<\/small> ><\/p>\n<\/td>\n

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

Set the filename to start with to FILE.<\/small><\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212editfilename<\/b> < BOOLEAN<\/small> ><\/p>\n<\/td>\n

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

If BOOLEAN<\/small> has a true value, the user may edit the filename. This is for example useful for a filebrowser that is used to select a filename to save to. By default this option is set to false.<\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212show_hidden<\/b> < BOOLEAN<\/small> ><\/p>\n<\/td>\n

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

If BOOLEAN<\/small> has a true value, hidden files (the filename starts with a dot) will also be shown. By default this option is set to false.<\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212mask<\/b> < ARRAYREF<\/small> ><\/p>\n<\/td>\n

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

If \u2212mask<\/b> is defined, a filemask popupbox will be added to the filebrowser dialog window. This popupbox will filter the list of files that is displayed, using a regular expression (case insensitive). The ARRAYREF<\/small> contains a list of array references. Each array reference has two elements: a regexp and a description. Here\u2019s an example \u2212mask<\/b>:<\/p>\n

my $mask = [
[ ‘.’, ‘All files (*)’ ],
[ ‘.txt$’, ‘Text files (*.txt)’ ]
[ ‘howto’, ‘HOWTO documentation’ ],
[ ‘core’, ‘Core files’ ],
];<\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

\u2212mask_selected<\/b> < INDEX<\/small> ><\/p>\n<\/td>\n

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

Normally the first mask in the list of masks will be made active upon creation of the filebrowser. If you want another mask to be active, use the \u2212mask_selected<\/b> option. Set this value to the index of the mask you want to be active. For example: if you would want the “howto” mask in the above example to be active, you would use the value 2 for \u2212mask_selected<\/b>.<\/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::Container 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 complete path to the file that was selected using the filebrowser. If no file was selected, this method will return an undefined value.<\/p>\n

SPECIAL 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

This will invoke the cancel button, so the filebrowser widget returns without selecting any file.<\/p>\n\n\n
<\/td>\n\n

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

<\/td>\n\n

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

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

If the directory\u2212 or filelistbox of the dialog window has the focus and the tilde (~) button is pressed, the filebrowser will chdir to the homedirectory of the current user.<\/p>\n

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

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