"

 COPYRIGHT (c) 1997 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.

"

ApplicationModel subclass:#ToolApplicationModel

	instanceVariableNames:'timeBlock'

	classVariableNames:''

	poolDictionaries:''

	category:'Interface-Framework'

!

ToolApplicationModel class instanceVariableNames:'history clipboard settings showingHelp'

"

 The following class instance variables are inherited by this class:

	ApplicationModel - ClassResources

	Model - 

	Object - 

"

!

!ToolApplicationModel class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1997 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.

"

!

documentation

"

    Framework class for tool applications.

    Provides hooks for history management,

    showing help texts, about menu, help menu etc.

    [author:]

        Thomas Zwick, eXept Software AG

"

! !

!ToolApplicationModel class methodsFor:'accessing'!

authorLinesForAboutBox

    "extracts the author(s) from the documentation method."

    |firstClassWithDocumentation src s line lines|

    firstClassWithDocumentation := self class withAllSuperclasses detect:[:metacls| metacls implements:#documentation].

    firstClassWithDocumentation notNil ifTrue:[

        (firstClassWithDocumentation inheritsFrom:ToolApplicationModel class) ifTrue:[

            src := (firstClassWithDocumentation compiledMethodAt:#documentation) source.

            src notNil ifTrue:[

                s := src readStream.

                s upToAll:'[author:]'.

                s nextLine.   "/ skip to end

                line := s nextLine.   "/ line after [author:]

                lines := OrderedCollection new.

                [line notNil and:[line notEmpty]] whileTrue:[

                    line := line trimBlanks.

                    line size > 1 ifTrue:[

                        lines add:line trimBlanks.

                        line := s nextLine.

                    ] ifFalse:[

                        line := nil

                    ]

                ].

                ^ lines.

            ]

        ]

    ].

    ^ #('unnown')

    "Created: / 1.2.1998 / 15:41:43 / cg"

    "Modified: / 1.2.1998 / 15:59:10 / cg"

!

label

    "returns the label for the tool instances of this class;

     extracted from the class name;

     can be redefined in subclasses"

    |label|

    label := ''.

    self name do:

    [:c|

        c isUppercase ifTrue: [label := label, $ ].

        label := label, c

    ].

    ^label trimBlanks

    "Modified: / 31.7.1998 / 18:04:18 / cg"

!

settings

    "returns the settings dictionary"

    settings isNil ifTrue: [settings := IdentityDictionary new].

    ^settings

!

showingHelp

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

    showingHelp isNil ifTrue: [showingHelp := true].

    ^showingHelp

    "Created: / 31.7.1998 / 18:03:38 / cg"

    "Modified: / 31.7.1998 / 18:16:55 / cg"

!

showingHelp: aBoolean

    "enable/disable active help for instances of this class"

    ^ showingHelp := aBoolean

    "Modified: / 31.7.1998 / 18:17:14 / cg"

! !

!ToolApplicationModel class methodsFor:'clipboard'!

clipboard

    "returns the clipboard of this tool class"

    ^clipboard

!

clipboard: anEditObject

    "sets the clipboard for this tool class"

    clipboard := anEditObject

! !

!ToolApplicationModel class methodsFor:'help'!

openAboutSTX

    "opens an about box (on ST/X)"

    |box|

    AboutBox isNil ifTrue:[

        "/ this handles bad installations of ST/X,

        "/ where the AboutBox is missing.

        "/ (May vanish in the future)

        ^ self information:('Smalltalk/X rev.' , Smalltalk versionString)

    ].

    box := AboutBox new.

    box autoHideAfter:10 with:[].

    box showAtPointer

    "Modified: / 14.8.1998 / 13:03:58 / cg"

    "Created: / 14.8.1998 / 13:17:43 / cg"

! !

!ToolApplicationModel class methodsFor:'help specs'!

helpSpec

    "This resource specification was automatically generated

     by the UIHelpTool of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the UIHelpTool may not be able to read the specification."

    "

     UIHelpTool openOnClass:ToolApplicationModel    

    "

    <resource: #help>

    ^super helpSpec addPairsFrom:#(

#about

'About functions.'

#aboutSTX

'Open an InfoBox showing details of the running ST/X.'

#aboutThisAppliaction

'Open an InfoBox about that applications release and its author.'

#add

'Add functions.'

#commitCancel

'Cancels changes.'

#commitOK

'Commit changes.'

#edit

'Edit functions.'

#editCopy

'Copy the selected item(s) to the clipboard.'

#editCut

'Move the selected item(s) to the clipboard.'

#editDelete

'Delete the selected item(s).'

#editMoveDown

'Moves the selected item one step down in the order list.'

#editMoveIn

'Moves the selected item into next item as child item.'

#editMoveOut

'Moves the selected item out of its parent item.'

#editMoveUp

'Moves the selected item one step up in the order list.'

#editPaste

'Paste from the clipboard.'

#editUndo

'Undo the last action.'

#file

'File functions.'

#fileBrowseClass

'Open a System Browser on the current class.'

#fileDefineClass

'Open a dialog to define the current class.'

#fileDefineClassAndSelector

'Open a dialog to define the current class and selector.'

#fileExit

'Exit this application.'

#generate

'Code generation.'

#help

'Help functions.'

#helpHelpTool

'Show the Help Tools documentation.'

#helpShowHelp

'Toggle display of help texts.'

#helpTutorial

'Show this applications documentation.'

#history

'History functions.'

#historyEmptyMenu

'Clear the history.'

#historyMenuItem

'Switch to that item.'

#settings

'Settings functions.'

#test

'Test functions.'

)

    "Modified: / 31.7.1998 / 19:28:14 / cg"

! !

!ToolApplicationModel class methodsFor:'history'!

getHistory

    "returns the history for this tool class"

    history isNil ifTrue: [history := OrderedCollection new].

    ^history

!

historyMaxSize

    "returns the maximum size for the history of this tool class"

    ^10

! !

!ToolApplicationModel class methodsFor:'image specs'!

desktopIcon

    "returns the icon used for the desktop"

    ^Icon

        constantNamed:#'ToolApplicationModel desktopIcon'

        ifAbsentPut:

        [

            |desktopIcon|

            desktopIcon := Icon stxIcon.

            desktopIcon magnifiedBy: Display preferredIconSize/desktopIcon extent

        ]

!

menuIcon

    "returns the icon used for the menu bar"

    ^Icon

        constantNamed:#'ToolApplicationModel menuIcon'

        ifAbsentPut:

        [

            |menuIcon|

            menuIcon := Icon stxIcon.

            menuIcon magnifiedBy: MenuPanel defaultFont height/menuIcon height

        ]

! !

!ToolApplicationModel class methodsFor:'interface specs'!

windowSpecForCommit

    "This resource specification was automatically generated

     by the UIPainter of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the UIPainter may not be able to read the specification."

    "

     UIPainter new openOnClass:ToolApplicationModel andSelector:#windowSpecForCommit

     ToolApplicationModel new openInterface:#windowSpecForCommit

    "

    <resource: #canvas>

    ^

       #(#FullSpec

          #window: 

           #(#WindowSpec

              #name: 'Commit Buttons'

              #layout: #(#LayoutFrame 344 0 371 0 643 0 430 0)

              #label: 'Commit Buttons'

              #min: #(#Point 100 22)

              #max: #(#Point 1152 900)

              #bounds: #(#Rectangle 344 371 644 431)

              #usePreferredExtent: false

          )

          #component: 

           #(#SpecCollection

              #collection: 

               #(

                 #(#ActionButtonSpec

                    #name: 'cancelButton'

                    #layout: #(#LayoutFrame 5 0 0 0 -2 0.5 0 1)

                    #activeHelpKey: #commitCancel

                    #label: 'Cancel'

                    #translateLabel: true

                    #tabable: true

                    #model: #cancel

                    #enableChannel: #valueOfEnablingCommitButtons

                )

                 #(#ActionButtonSpec

                    #name: 'okButton'

                    #layout: #(#LayoutFrame 2 0.5 0 0.0 -5 1 0 1.0)

                    #activeHelpKey: #commitOK

                    #label: 'OK'

                    #translateLabel: true

                    #tabable: true

                    #model: #accept

                    #enableChannel: #valueOfEnablingCommitButtons

                )

              )

          )

      )

    "Modified: / 20.5.1998 / 03:31:54 / cg"

!

windowSpecForCommitWithoutChannels

    "This resource specification was automatically generated

     by the UIPainter of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the UIPainter may not be able to read the specification."

    "

     UIPainter new openOnClass:ToolApplicationModel andSelector:#windowSpecForCommitWithoutChannels

     ToolApplicationModel new openInterface:#windowSpecForCommitWithoutChannels

    "

    <resource: #canvas>

    ^

       #(#FullSpec

          #window: 

           #(#WindowSpec

              #name: 'Commit Buttons Without Channels'

              #layout: #(#LayoutFrame 500 0 326 0 799 0 385 0)

              #label: 'Commit Buttons Without Channels'

              #min: #(#Point 100 22)

              #max: #(#Point 1152 900)

              #bounds: #(#Rectangle 500 326 800 386)

              #usePreferredExtent: false

          )

          #component: 

           #(#SpecCollection

              #collection: 

               #(

                 #(#ActionButtonSpec

                    #name: 'cancelButton'

                    #layout: #(#LayoutFrame 5 0 0 0 -2 0.5 0 1)

                    #activeHelpKey: #commitCancel

                    #label: 'Cancel'

                    #translateLabel: true

                    #tabable: true

                    #model: #cancel

                )

                 #(#ActionButtonSpec

                    #name: 'okButton'

                    #layout: #(#LayoutFrame 2 0.5 0 0.0 -5 1 0 1.0)

                    #activeHelpKey: #commitOK

                    #label: 'OK'

                    #translateLabel: true

                    #tabable: true

                    #model: #accept

                )

              )

          )

      )

    "Modified: / 20.5.1998 / 03:30:09 / cg"

!

windowSpecForInfoBar

    "This resource specification was automatically generated

     by the UIPainter of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the UIPainter may not be able to read the specification."

    "

     UIPainter new openOnClass:ToolApplicationModel andSelector:#windowSpecForInfoBar

     ToolApplicationModel new openInterface:#windowSpecForInfoBar

    "

    <resource: #canvas>

    ^

       #(#FullSpec

          #window: 

           #(#WindowSpec

              #name: 'Info Bar'

              #layout: #(#LayoutFrame 233 0 218 0 732 0 563 0)

              #label: 'Info Bar'

              #min: #(#Point 400 320)

              #max: #(#Point 1152 900)

              #bounds: #(#Rectangle 233 218 733 564)

              #menu: #menu