Smalltalk/X Webserver

Documentation of class 'FileBrowserV2':

Class: FileBrowserV2

Inheritance
Description
Class protocol
Instance protocol

Inheritance:

   Object
   |
   +--Model
      |
      +--ApplicationModel
         |
         +--ApplicationWithFileHistory
            |
            +--AbstractFileBrowser
               |
               +--FileBrowserV2

Package:: stx:libtool

Category:: Interface-Tools-File

Version:: rev: 1.275 date: 2023/08/03 09:58:12; user: cg; file: FileBrowserV2.st directory: libtool; module: stx stc-classLibrary: libtool

Description:

FileBrowserV2 is based on Filebrowser

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) 2002 by eXept Software AG
             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.

toDo- the tab for the directory description text editor is not changed if the
  directory description changes to a normal text editor
- FileDialog should get a file history
- directorycontentsItem isDirectory fails if it is a symbolic link
- on sort order change in directory contents browser the columnspec shouldnt not reloaded
- check all windowspecs with different font types
- multiple select with mouse moving is flickering (see bestFilename in FilenameEditField)
- too many system calls on update cycle
- stop monitoring task for DirectoryTreebrowser and DirectoryContentsBrowser

Class protocol:

class initialization

initialize

self installInLauncher. - now done in phase 2

installInLauncher

add myself to the launcher menu and toolBar

Usage example(s):

     self installInLauncher
     self removeFromLauncher

removeFromLauncher

remove myself from the launcher's menu & settings dialog

Usage example(s):

     self removeFromLauncher

update: something with: aParameter from: changedObject

(comment from inherited method)
flush resources on language changes

defaults

entryFieldEndStringForMultipleSelection

help specs

helpSpec: This resource specification was automatically generated
by the UIHelpTool of ST/X.

image specs

applicationIcon
closePreviewButtonImage
defaultIcon: (comment from inherited method)
default is: no icon (should be redefined by concrete class if an icon is wanted).
encodingLockIcon
hideFilenameEntryFieldIcon
hideToolBarIcon

instance creation

on: aDirectoryPath

return a new FileBrowserV2 in a pathname.
The browser is not yet open

Usage example(s):

     (self on:'/etc') open

open

start a new FileBrowserV2 (in the current directory)

Usage example(s):

     FileBrowserV2 open.
     FileBrowserV2 openOn:(OrderedCollection with:(Filename currentDirectory asAbsoluteFilename)) withExtent:800@600

openIn: aDirectoryPath

backward compatibility

openOn: aFileOrDirectoryPath

start a new FileBrowserV2 on aFileOrDirectoryPath.
if it represents a file, it is opened and shown for editing;
if it represents a directory, the directory is shown.

Usage example(s):

     FileBrowserV2 openOn:(Filename currentDirectory asAbsoluteFilename)
     FileBrowserV2 openOn:'Makefile'

openOn: aFileOrDirectoryPath filterPattern: filterPatternOrNil

start a new FileBrowserV2 on aFileOrDirectoryPath.
if it represents a file, it is opened and shown for editing;
if it represents a directory, the directory is shown.

Usage example(s):

     FileBrowserV2 openOn:(Filename currentDirectory asAbsoluteFilename) filterPattern:'*.st'
     FileBrowserV2 openOn:'Makefile' filterPattern:'Mak*'

openOn: aDirectoryPath withExtent: extentOrNil

start a new FileBrowserV2 on aDirectoryPath

Usage example(s):

     FileBrowserV2 openOn:(Filename currentDirectory) withExtent:800@600

openOn: aDirectoryPath withExtent: extentOrNil filterPattern: filterPatternOrNil

start a new FileBrowserV2 on aDirectoryPath

Usage example(s):

     FileBrowserV2 openOn:(Filename currentDirectory) withExtent:800@600

openOnDirectory: aDirectoryPath

start a new FileBrowserV2 in a pathname

openOnFileNamed: aFilename

start a new FileBrowserV2 on a aFilename.
The browser looks for an appropriate viewer and uses that if one is found;
otherwise, the file is opened for text editing.

Usage example(s):

     FileBrowserV2 openOnFileNamed:'Makefile'

openOnFileNamed: aFilename editing: editing

start a new FileBrowserV2 on a aFilename;
If editing is true, the browser opens the document as text to be edited;
if false, it looks for an appropriate viewer and uses that if one is found.

Usage example(s):

     FileBrowserV2 openOnFileNamed:'Makefile'

openOnFileNamed: aFilename filterPattern: filterPatternOrNil

start a new FileBrowserV2 on a aFilename.
The browser looks for an appropriate viewer and uses that if one is found;
otherwise, the file is opened for text editing.

Usage example(s):

     FileBrowserV2 openOnFileNamed:'Makefile' filterPattern:'Mak*'

openOnFileNamed: aFilename filterPattern: filterPatternOrNil editing: editing

start a new FileBrowserV2 on a aFilename;
If editing is true, the browser opens the document as text to be edited;
if false, it looks for an appropriate viewer and uses that if one is found.

Usage example(s):

     FileBrowserV2 openOnFileNamed:'Makefile'

openWithAspects: someAspects withExtent: extent

start a new FileBrowserV2 taking aspects from a dictionary
(internal interface - only for spawn)

interface specs

windowSpec

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

Usage example(s):

     UIPainter new openOnClass:FileBrowserV2 andSelector:#windowSpec
     FileBrowserV2 new openInterface:#windowSpec
     FileBrowserV2 open

menu specs

editModeInfoLabelMenu

encodingMenu