NAME
Tk::Wizard::Installer - building-blocks for a software install wizard
DESCRIPTION
This module comprises the first moves towards a Tk::Wizard extension to automate software installation, primarily for end-users, in the manner of Inno Setup, Install Sheild, etc.
DETAILS
All the methods and means of Tk::Wizard, plus those below:
METHOD addLicencePage
$wizard->addLicencePage ( -filepath => $path_to_licence_text )Adds a page (Tk::Frame) that contains a scroll texxt box of a licence text file specifed in the -filepath argument. Presents the user with two options, accept and continue, or not accept and quit. The user cannot progress until the 'agree' option has been chosen. The choice is entered into the object field licence_agree, which you can test as the Next button is pressed, either using your own function or with the Wizard's callback_licence_agreement function.
You could supply the GNU Artistic Licence....
See "CALLBACK callback_licence_agreement" and "METHOD page_licence_agreement".
METHOD addDirSelectPage
$wizard->addDirSelectPage ( -variable => \$chosen_dir )Adds a page (Tk::Frame) that contains a scrollable texxt box 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 to list only drives which are accessible, thus avoiding Tk::DirTree warnings on Win32 where removable drives have no media.
You may also specify the -title, -subtitle and -text paramters, as in "METHOD blank_frame".
See "CALLBACK callback_dirSelect".
CALLBACK callback_licence_agreement
Intended to be used with an action-event handler like -preNextButtonAction, this routine check that the object field licence_agree is a Boolean true value. If that operand is not set, it warns the user to read the licence; if that operand is set to a Boolean false value, a message box says goodbye and quits the program.
SEE ALSO
Tk; Tk::Wizard; Tk::Wizard::Install::Win32.
AUTHOR
Lee Goddard (lgoddard@cpan.org) based on work Daniel T Hable.
KEYWORDS
Wizard; set-up; setup; installer; uninstaller; install; uninstall; Tk; GUI.
COPYRIGHT
Copyright (c) Daniel T Hable, 2/2002.
Modifications Copyright (C) Lee Goddard, 11/2002 ff.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
THIS SOFTWARE AND THE AUTHORS OF THIS SOFTWARE ARE IN NO WAY CONNECTED TO THE MICROSOFT CORP. THIS SOFTWARE IS NOT ENDORSED BY THE MICROSOFT CORP MICROSOFT IS A REGISTERED TRADEMARK OF MICROSOFT CROP.
1;