NAME
Tk::Wizard::FileSystem - Tk::Wizard
pages to allow end-user filesystem access
SYNOPSIS
Currently automatically loaded by Tk::Wizard
, though this behaviour is deprecated and is expected to change in 2008.
DESCRIPTION
Adds a number of methods to Tk::Wizard
, to allow the end-user to access the filesystem.
METHODS
addDirSelectPage
$wizard->addDirSelectPage ( -variable => \$chosen_dir )
Adds a page (Tk::Frame
) that contains a scrollable tree list of all directories including, on Win32, logical drives.
Supply in -variable
a reference to a variable to set the initial directory, and to have set with the chosen path.
Supply -nowarnings
with a value of 1
to list only drives which are accessible, thus avoiding Tk::DirTree
warnings on Win32 where removable drives have no media.
Supply in -nowarnings
a value other than 1
to avoid listing drives which are both inaccessible and - on Win32 - are either fixed drives, network drives, or RAM drives (that is types 3, 4, and 6, according to "GetDriveType" in Win32API::File).
You may also specify the -title
, -subtitle
and -text
parameters, as in "blank_frame".
An optional -background
argument is used as the background of the Entry and DirTree widgets (default is white).
Also see "callback_dirSelect".
callback_dirSelect
A callback to check that the directory, passed as a reference in the sole argument, exists, or can and should be created.
Will not allow the Wizard to continue unless a directory has been chosen. If the chosen directory does not exist, a messageBox will ask if it should be created. If the user affirms, it is created; otherwise the user is again asked to choose a directory.
Returns a Boolean value.
addFileSelectPage
$wizard->addFileSelectPage(
-directory => 'C:/Windows/System32',
-variable => \$chosen_file,
);
Adds a page (Tk::Frame
) that contains a "Browse" button which pops up a file-select dialog box. The selected file will be displayed in a read-only Entry widget.
Supply in -directory
the full path of an existing folder where the user's search shall begin.
Supply in -variable
a reference to a variable to have set with the chosen file name.
You may also specify the -title
, -subtitle
and -text
parameters, as in "blank_frame".
An optional -background
argument is used as the background of the Entry widget (default is white).
AUTHOR
Lee Goddard (lgoddard@cpan.org).
COPYRIGHT
Copyright (C) Lee Goddard, 11/2002 - 01/2008, 06/2015 ff.
Made available under the same terms as Perl itself.