Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

SelFile
a widget for choosing a file to read or write

SelFile - a widget for choosing a file to read or write


NAME


 SelFile - a widget for choosing a file to read or write


SYNOPSIS


 use Tk;

 use Tk::SelFile;

 $mw = MainWindow->new;  # As an example.

 $start_dir = ".";       # As an example.

 $sfw = $mw->SelFile(

                     -directory => $start_dir,

                     -width     =>  30,

                     -height    =>  20,

                     -filelistlabel  => 'Files',

                     -filter         => '*',

                     -filelabel      => 'File',

                     -dirlistlabel   => 'Directories',

                     -dirlabel       => 'Filter',

                     -readbutlabel   => 'Read',

                     -writebutlabel  => 'Write',

                     -cancelbutlabel => 'Cancel',

                     );

 Please see the Populate subroutine as the configuration

 list may change.

 ($opcode, $filename) = $sfw->Show;

 $opcode will have the value -readbutlabel (e.g. 'READ'),

 -writebutlabel (e.g. 'WRITE') or -cancelbutlabel (e.g. 'CANCEL').

 An empty string for the text assigned to -readbutlabel or

 -writebutlabel will eliminate that particular button.

 $filename will be a file pathname, or in the case of CANCEL

 it will be a single space character.

 $SFref = $sfw->configure(option => value[, ...])


DESCRIPTION


   This Module pops up a file selector box, with a directory entry

   with filter on top, a list of directories in the current directory,

   a list of files in the current directory, an entry for entering

   or modifying a file name, a read button, a write button, a

   cancel button, a HOME button, and a button to return to the

   starting directory (-directory).

   The button to return to the starting directory is motivated by

   the idea that an application may have a directory unrelated to

   the home directory, e.g. a library of data, that is set to be

   the starting directory.  If the user goes to the home directory,

   the user may not recall the starting directory that was set by

   the application.

   A call to SelFile few (or no options, such as shown below)

   will result in the default values shown in the example

   given in the SYNOPSIS section.  The most uptodate list of

   configuration variables and default values can be found in the

   subroutine Populate as arguments to the subroutine ConfigSpecs.

   $sfw = $mw->SelFile;

   A dialog box error message is generated if the user clicks the

   Read button for a file that does not exist.

   For Write, a dialog box that requests whether the user wishes

   to overwrite the file is generated for a file that already exists.

   Also for Write, a dialog box error message is generated is the

   file name is blank.

   This widget can be configured for requesting a file name to read,

   requesting a file name for writing, or for requesting either.

   For the initial call to SelFile that configures the widget,

   if -readbutlabel is not a member of the argument list, then

   the default value is used (i.e. Read).  If on the other hand

   it is present but specifies an empty string, as shown below

   -readbutlabel   => '',

   then the button is not created.  An analogous rule applies

   to the argument -writebutlabel.

   The file name output is a single space character rather than undef

   when CANCEL is selected so that the user can process the return values

   without checking the values, e.g. storing the result for later use.


AUTHORS

Based on original FileSelect by Klaus Lichtenwalder, Lichtenwalder@ACM.org, Datapat GmbH, Munich, April 22, 1995 adapted by Frederick L. Wagner, derf@ti.com, Texas Instruments Incorporated, Dallas, 21Jun95 further adapted by Alan Louis Scheinine, scheinin@crs4.it, Centro di Ricerca, Sviluppo e Studi Superiori in Sardegna (CRS4) Cagliari, 14 November 1995


HISTORY

Alan Scheinine wants to thank David Greaves (davidg@oak.reading.sgi.com) for pointing out errors and for suggesting improvements. He also wants to thank Nick Ing-Simmons (nik@tiuk.ti.com) for sending the soon-to-be FileSelect for Tk-b9. This SelFile program diverges from SelectFile with regard to style but nonetheless has benefited from the ideas and actual code of SelectFile.

Future history. For Tk-b9, ``show'' and ``subwidget'' should become ``Show'' and ``Subwidget'' Change $cw->subwidget('dialog')->show; Tk-b8 to $cw->Subwidget('dialog')->Show; Tk-b9

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy