NAME Tk::ReportBox - Perl extension for Displaying Reports SYNOPSIS use Tk::ReportBox; $reportbox = $main->ReportBox( -title => 'Head', -file => 'test.rp', -mode => 1, -headers => 2 ); my $result = $reportbox->deliver(); The '-file' option is mandatory. DESCRIPTION This widget is meant for display of reports. In certain applications, programmers create reports using formats and write them to temporary files, and then read the files and display them. Typically, the user would want to scroll through the report, print it or store it in some file of their choice for future use. In accounting programs, a ledger may be displayed as a scrollable list. On selecting an item on the list, the user can get the subledger or voucher summarised on that line. ReportBox caters to both these needs, creating either a static readonly text report, or a scrollable list which can return a list item for further processing. The file 'test.rp' in the distribution gives an example report of a series of vouchers in an accounting package. 'example.pl' shows how it works. Options: ******** The '-file' option is mandatory. ******************* -startdir: The start directory to be passed to FileSelect. Defaults to './'. -printstr: The print command for your system. Defaults to "lp $file". The print command would then be 'system ("lp $file")'. -headers: For the listbox form of report, the number of header lines at the top that are not list items and hence should not be editable. Defaults to 2. -file: the name of the temporary file from which to read the report. -mode: this is 0 for static report and 1 for editable report. Defaults to 0. -title: this is for the title of the ReportBox. Methods: There is only one method: 'deliver'. This returns the editable string in the listbox report if the 'edit' button is pressed and '0' otherwise. PREREQUISITES 1. Tk INSTALLATION Unpack the distribution perl Makefile.PL make make install AUTHOR Kenneth Gonsalves. I welcome all comments, suggestions and flames to lawgon@thenilgiris.com LICENCE Same as perl BUGS Must be any number crawling around - havent found any though.