Smalltalk/X Webserver

Documentation of class 'FileBrowser':

Class: FileBrowser

Inheritance
Description
Class protocol
Instance protocol

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--TopView
                  |
                  +--StandardSystemView
                     |
                     +--FileBrowser

Package:: stx:libtool

Category:: Interface-Tools-File

Version:: rev: 1.743 date: 2024/03/26 12:59:54; user: cg; file: FileBrowser.st directory: libtool; module: stx stc-classLibrary: libtool

Description:

Notice: this is the old (V1) FileBrowser, which has now been 
        more or less obsoleted by the FileBrowserV2
        (which is the default file browser now)

this used to be a very simple demo application,
but migrated into a quite nice tool, includes all kinds of 
warning and information boxes, background processes for directory-
reading and internationalized strings. 
A good example for beginners, on how to do things .... 
(and maybe how not to do things ;-, since some
 stuff is historic and was implemented at times when better mechanisms
 were not available)

See additional information in 'doc/misc/fbrowser.doc'.

WARNING: files edited with FileBrowser will have leading spaces (multiple-8)
         being replaced by tabs. If tabs are to be preserved at other
         positions (for example, sendmail-config files) they will be
         corrupt after being written.

[instance variables]:

    checkDelta      <Integer>       number of seconds of check interval
                                    (looks ever so often if shown directory
                                     has changed). You may make this number
                                    higher, if your network-times are
                                    incorrect and thus, the filebrowser
                                    checks too often.

    compressTabs    <Boolean>       if true, leading spaces will be
                                    replaced by tabs when saving text

some of the defaults (long/short list etc.) can be set by the resource file;
see FileBrowser>>initialize for more details..

copyrightCOPYRIGHT (c) 1991 by Claus Gittinger
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

Class protocol:

aspects

directoryBookmarks
directoryHistory: a global visitedDirectories list

defaults

default

the class to be used for file browsing (from the preferences).
This is now usually FileBrowserV2, but may also be AppSpecificFileBrowser
in end user apps (eg. expecco)

Usage example(s):

  FileBrowser default open

defaultIcon

return the file browsers default window icon

fileList user interaction

goodRenameDefaultForFile: oldName lastOld: lastOldName lastNew: lastNewName

history

addToCommandHistory: aCommandString for: aFilename
addToVisitedFileHistory: path: already been there before; move the entry to
the beginning, so it will fall out later.

instance creation

on: aDirectoryPath

return a new FileBrowser in a pathname

Usage example(s):

     (FileBrowser on:'/usr/local/bin') open
     (FileBrowser on:'/etc'          ) open
     (FileBrowser on:'..'            ) open
     (FileBrowser on:'.'             ) open

openOn: aDirectoryPath

start a new FileBrowser in a pathname

Usage example(s):

     FileBrowser openOn:'/etc'
     FileBrowser openOn:'..'
     FileBrowser openOn:'.'

openOn: aDirectoryPath withExtent: extent

start a new FileBrowser in a pathname

Usage example(s):

     FileBrowser openOn:'/etc'           withExtent:200@300
     FileBrowser openOn:'..'             withExtent:200@300
     FileBrowser openOn:'.'              withExtent:200@300

openOnDirectory: aDirectoryPath

start a new FileBrowser in a pathname

openOnFileNamed: aFilename

start a new FileBrowser on a file

Usage example(s):

     FileBrowser openOnFileNamed:'Makefile'
     FileBrowser openOnFileNamed:'../Makefile'
     FileBrowser openOnFileNamed:'/tmp/foo'

interface specs

fileSearchDialogSpec

This resource specification was automatically generated
by the UIPainter of ST/X.

Usage example(s):

     UIPainter new openOnClass:FileBrowser andSelector:#fileSearchDialogSpec

menu specs

baseBookmarksMenuSpec