eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'ToolApplicationModel':
Home

everywhere
www.exept.de
for:
[back]

Class: ToolApplicationModel

Inheritance:

   Object
   |
   +--Model
      |
      +--ApplicationModel
         |
         +--ToolApplicationModel
            |
            +--AbstractLauncherApplication
            |
            +--ApplicationBuilder
            |
            +--AssistantApplication
            |
            +--MultiViewToolApplication
            |
            +--NewChangesBrowser
            |
            +--ResourceSpecEditor
Package:
stx:libview2
Category:
Interface-Framework
Version:
rev: 1.137 date: 2010/03/09 10:33:12
user: cg
file: ToolApplicationModel.st directory: libview2
module: stx stc-classLibrary: libview2
Author:
Thomas Zwick, eXept Software AG

Description:


Framework class for tool applications (UIPainter, MenuEditor etc.).
Provides hooks for modifiedChannels, history management,
showing help texts, about menu, help menu etc.

Class protocol:

accessing
o  allToolInstances

o  authorLinesForAboutBox
extracts the author(s) from the documentation method.

o  forgetInstance: anInstance

o  label
returns the label for the tool instances of this class;
extracted from the class name;
can be redefined in subclasses

o  rememberInstance: anInstance

o  settings
returns the settings dictionary

o  showingHelp
returns true if active help is turned on for instances of this class

o  showingHelp: aBoolean
enable/disable active help for instances of this class

clipboard
o  clipboard
returns the clipboard of this tool class

o  clipboard: anEditObject
sets the clipboard for this tool class

help
o  openAboutSTX
opens an about box (on ST/X)

help specs
o  flyByHelpSpec

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

history
o  getFileHistory
returns the file-history for this tool class

o  getHistory
returns the history for this tool class

o  historyMaxSize
returns the maximum size for the history of this tool class

image specs
o  desktopIcon
returns the icon used for the desktop

o  menuIcon
returns the icon used for the menu bar

interface specs
o  windowSpecForCommit
This resource specification was automatically generated
by the UIPainter of ST/X.

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

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

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

menu specs
o  menuAbout
This resource specification was automatically generated
by the MenuEditor of ST/X.

o  menuHelp
This resource specification was automatically generated
by the MenuEditor of ST/X.

o  xxxmenuFont
This resource specification was automatically generated
by the MenuEditor of ST/X.

queries
o  isVisualStartable
return true, if this application can be started via #open.
(to allow start of a change browser via double-click in the browser)

startup & release
o  preSnapshot
removes the clipboard before snap shoting

o  uninitialize
resets the class instance variables

Instance protocol:

aspects
o  acceptChannel
returns a valueHolder which can be set to true to force all inputFields
to accept their value.

o  canCopyHolder
returns whether can copy as value holder

o  canCutHolder
returns whether can cut as value holder

o  canPasteHolder
returns whether can paste as value holder

o  canUndoHolder
returns whether can undo as value holder

o  enablingCommitButtonsHolder
returns the enabling of the commit of this tool as value holder

o  havingDocumentationHolder
returns the enabling of having documentation for this tool as value holder

o  infoLabelHolder
returns the info label as value holder

o  infoLabelHolder: aValueHolder

o  modifiedChannel
returns a valueHolder which is set to true, whenever any of
my editfields is modified - this is hooked to
the enablingCommitButtonsHolder channel

o  timeLabelHolder
returns the time label as value holder

o  valueOfCanCopy

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfCanCut

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfCanPaste

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfCanUndo

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfEnablingCommitButtons

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfHavingDocumentation

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfInfoLabel

** This is an obsolete interface - do not use it (it may vanish in future versions) **

o  valueOfTimeLabel

** This is an obsolete interface - do not use it (it may vanish in future versions) **

clipboard
o  clipboard
returns the clipboard

o  clipboard: anEditObject
sets the clipboard and the value holder for can pasting

clock handling
o  startClock
start the time-block

o  startClockOnTimedBlock: aBlock
sets and starts the (optional) time block

o  stopClock
stop the time-block

o  updateTime
update my time-field

defaults
o  aboutImage
the image to be displayed in my about-box;
If nil is returned, thhe ST/X default image is used.

help
o  aboutThisApplicationText
text for an about box for this application.
Extracts some common info (i.e. class revision, author etc.) from
the classes documentation.

o  defaultInfoLabel
returns the default info label; here an empty string

o  openAbout
opens an about box (on ST/X)

o  openHTMLDocument: aHTMLFilename
opens a HTML browser on aHTMLFilename

o  showHelp: aHelpText for: view
displays aHelpText in the info label.
Only text up to '.' is shown

o  showingHelp
returns true, if automatic display of help is enabled for this
application; false otherwise

o  showingHelp: aValue
toggles showing help for this application

o  updateInfoLabel
updates the info label at the bottom of this application

o  xxopenAboutThisApplication
opens an about box for this application.
Extracts some common info (i.e. class revision, author etc. from
the classes documentation.

history
o  add: aHistoryEntry toHistory: aHistory
adds aHistoryEntry (format: loadMessage -> evalString) at the top of aHistory,
and checks for maximum size of the history

o  addHistoryEntryForClass: classToAdd selector: selectorToAdd
adds aHistoryEntry (format: loadMessage -> evalString) at the top of the history,
and checks for maximum size of the history

o  addHistoryEntryForFile: fileName

o  addToFileHistory: aHistoryEntry
adds aHistoryEntry (format: loadMessage -> evalString) at the top of the file-history,
and checks for maximum size of the history

o  addToHistory: aHistoryEntry
adds aHistoryEntry (format: loadMessage -> evalString) at the top of the history,
and checks for maximum size of the history

o  emptyFileHistory
removes all history entries

o  emptyHistory
removes all history entries

o  fileHistory
returns the file-history from tool class

o  fileHistoryEntries
returns the file history entries, i.e. the evaluatable values containing the information

o  history
returns the history from tool class

o  historyEntries
returns the history entries, i.e. the evaluatable values containing the information

o  menuHistory
returns a dynamic history submenu

o  remove: aHistoryEntry fromHistory: aHistory
removes aHistoryEntry from the history

o  removeFromHistory: aHistoryEntry
removes aHistoryEntry from the history

initialization
o  initialize

misc
o  clearModifiedFlag
clear the modifiedChannel.
That one is hooked to components in the right noteBook,
and will be set, when any value is modified.
(to enable OK and cancel buttons)

queries
o  allToolInstances
returns all instances of this tool class

o  preferredExtent
preferred extent of my window; top/main menu and top toolbar (named by 'menuToolbarView')
will be considered

startup & release
o  closeDownViews
uninitializes and closes this tool

o  loadFromHistoryEntry: aHistoryEntry

o  postOpenWith: aBuilder
starts the active help for this tool (if turned on in the settings)
and updates the info label and the fonts (from the settings)

o  restarted
sent by my windowGroup, when restarted from an image.
restart timed block if defined.

o  uninitialize
stops active help for this tool and (if defined) removes the time block

Private classes:

    HistoryEntry
    HistoryEntryForFile
    HistoryEntryForMethod

ST/X 6.1.1; WebServer 1.620 at exept:8081; Wed, 23 May 2012 21:43:21 GMT