Class: FilenameWidgetWithHistory

• Inheritance
• Description
• Related information
• Instance protocol
  • accessing
  • accessing-channels
  • accessing-editField attributes
  • initialization
  • queries
  • user actions
• Examples

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--FilenameWidgetWithHistory
               |
               +--FilenameWidgetWithoutHistory

Package:

stx:libwidg2

Category:

Views-Interactors

Version:

rev: 1.30 date: 2018/11/09 23:27:37

user: cg

file: FilenameWidgetWithHistory.st directory: libwidg2

module: stx stc-classLibrary: libwidg2

Author:

Claus Gittinger

Description:

A Filename InputField with history-list and a browse-button, which opens a file dialog.

Related information:

    ComboBoxView
    FilenameEditField
    FilenameComboBoxView

Instance protocol:

 acceptOnExpand: aBoolean

 baseDirectory

 baseDirectory: something

 contents

 dialogTitle: something

set the dialog's title

 directoriesOnly: aBoolean

if true, directories are selectable only.
If both filesOnly and directoriesOnly are false, which is the default,
anything is selectable.

 fileNameTranslationHook

 fileNameTranslationHook: aBlock

an optional hook which gets the filename from the editField
and produces a full path for the file dialog (in the ...-button).
Use this, if the filename contains $(xxx) variables to be expanded

 filesOnly: aBoolean

if true, files are selectable only.
If both filesOnly and directoriesOnly are false, which is the default,
anything is selectable.

 historyList

 historyList: aCollection

set the history - useful when two or more such fields shall share a common history

 initialDirectoryHolder

can be used to force the file-dialog into some initial directory

 model

 model: aFilenameHolder

 selectAllInitially

 acceptChannel: aValueHolder

 backgroundChannel

 backgroundChannel: aValueHolder

 enableChannel: aValueHolder

 foregroundChannel

 foregroundChannel: aValueHolder

 modifiedChannel: aValueHolder

 acceptIfUnchanged: aBoolean

 acceptOnLeave: aBoolean

 acceptOnLostFocus: aBoolean

 acceptOnPointerLeave: aBoolean

 acceptOnReturn: aBoolean

 acceptOnTab: aBoolean

 contents: aString

 immediateAccept: aBoolean

 maxChars: aBoolean

 readOnly: aBoolean

 initialize

(comment from inherited method)
initialize all state of the view - usually redefined in subclasses,
but always doing a 'super initialize'. Each class should setup its
locals - and not forget the others.
View setup is separated into two parts, the general setup done here
and the style specific setup in initStyle. Each view should be prepared
for a stylechange by being sent another initStyle with a new style value.
(in this case, it should set all of its style-dependent things, but
leave the state and contents as-is)

 initializeBrowseButton

 initializeFilenameField

 computePreferredExtent

max: browseButton preferredExtent y

 browseForDestinationDirectory

 browseForFileOrDirectory

lastDirectoryHolder value:path directory.

Examples:

     |top b|

     top := StandardSystemView new.
     top extent:(300 @ 200).

     b := FilenameWidgetWithHistory in:top.
     b origin:(0.0 @ 0.0) corner:(1.0 @ 0.0).
     b bottomInset:(b preferredExtent y negated).

     top open.