"

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

"

"{ Package: 'stx:libtool2' }"

ToolApplicationModel subclass:#UIPainter

	instanceVariableNames:'specClass specSelector specSuperclass aspects treeView

	classVariableNames:''

	poolDictionaries:''

	category:'Interface-UIPainter'

!

SelectionInTreeView subclass:#TreeView

	instanceVariableNames:'lastDrawnMaster cvsEventsDisabled windowSpec windowSpecClass'

	classVariableNames:''

	poolDictionaries:''

	privateIn:UIPainter

!

!UIPainter class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1995-1998 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

"

    The GUI Painter provides the user with a graphical user interface for building own 

    interfaces by interactively assembling widgets and defining the behavior of the widgets.

    The resulting interface specifications can be saved as methods on the application

    classes, typically subclasses of the class ApplicationModel. These specifications

    are used by the UIBuilder to generate the application window and its widgets when 

    opening the application.

    [start with:]

	UIPainter open

    [author:]

	Claus Gittinger, eXept Software AG

	Claus Atzkern, eXept Software AG

	Thomas Zwick, eXept Software AG

    [see also:]

	UIBuilder

	ApplicationModel

	UISpecification

"

! !

!UIPainter class methodsFor:'instance creation'!

openOnClass:aClass andSelector:aSelector

    "open a GUI Painter on aClass and (windowSpec) aSelector

    "

    ^ self new openOnClass:aClass andSelector:aSelector

! !

!UIPainter class methodsFor:'ST-80 queries'!

preferenceFor:aSymbol

    "ST-80 compatible; always returns false

    "

    ^ false

! !

!UIPainter class methodsFor:'accessing'!

defaultNameOfCanvas

    "returns the default name of the application"

    ^'NewApplication'

! !

!UIPainter class methodsFor:'help specs'!

flyByHelpSpec

    <resource: #help>

    ^super flyByHelpSpec addPairsFrom:#(

#alignSelectionBottom

'Align bottom edges'

#alignSelectionCenterHor

'Align centers vertically'

#alignSelectionCenterVer

'Align centers horizontally'

#alignSelectionLeft

'Align left edges'

#alignSelectionLeftAndRight

'Align horizontal edges'

#alignSelectionRight

'Align right edges'

#alignSelectionTop

'Align top edges'

#alignSelectionTopAndBottom

'Align vertical edges'

#centerSelectionHor

'Center horizontally'

#centerSelectionVer

'Center vertically'

#changePositionDown

'Move towards bottom.'

#changePositionLeft

'Move towards left.'

#changePositionRight

'Move towards right.'

#changePositionUp

'Move towards top.'

#editDimensionCopyExtent

'Copy extent'

#editDimensionCopyLayout

'Copy layout'

#editDimensionPasteExtent

'Paste extent'

#editDimensionPasteHeight

'Paste height'

#editDimensionPasteLayout

'Paste layout'

#editDimensionPasteWidth

'Paste width'

#editInspectSpec

'Inspect spec'

#editInspectView

'Onspect view'

#editOpenSpecDocumentation

'WidgetDocumentation'

#fileBrowseAspectMethods

'Browse aspects'

#fileLoad

'Load spec'

#fileLoadSubspec

'Load subSpec'

#fileNew

'New spec'

#filePickAnInterface

'Pick spec'

#fileSave

'Save spec'

#fileSaveAs

'Save spec'

#fileShowWindowSpec

'View spec.'

#generateAspectMethods

'Generate aspects'

#generateHookMethods

'Generate hooks'

#moveWidgetDown

'Move down'

#moveWidgetInto

'Move into'

#moveWidgetOut

'Move out'

#moveWidgetUp

'Move up'

#pasteBuffer

'Paste'

#pasteWithLayout

'Paste with layout'

#settingsCanvas

'Toggle canvas.'

#settingsGallery

'Toggle gallery'

#spreadSelectionHor

'Spread horizontally'

#spreadSelectionVer

'Spread vertically'

#testGeometryTestMode

'Toggle test mode'

#testStartApplication

'Start application'

)

!

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:UIPainter    

    "

    <resource: #help>

    ^super helpSpec addPairsFrom:#(

#align

'Widget alignment functions.'

#alignSelectionBottom

'Aligns the selected widgets bottom edges with the bottom of the dominant widget.'

#alignSelectionCenterHor

'Aligns the selected widgets centers vertically with the center of the dominant widget.'

#alignSelectionCenterVer

'Aligns the selected widgets centers horizontally with the center of the dominant widget.'

#alignSelectionLeft

'Aligns the selected widgets left edges with the left edge of the dominant widget.'

#alignSelectionLeftAndRight

'Aligns the selected widgets left & right edges with the dominant widget.'

#alignSelectionRight

'Aligns the selected widgets right edges with the right edge of the dominant widget.'

#alignSelectionTop

'Aligns the selected widgets top edgegs with the top edge of the dominant widget.'

#alignSelectionTopAndBottom

'Aligns the selected widgets top and bottom edges with the dominant widget.'

#centerSelectionHor

'Centers the selected widgets horizontally within their containing widget.'

#centerSelectionVer

'Centers the selected widgets vertically within their containing widget.'

#changePositionDown

'Moves the selected widget(s) towards the bottom.'

#changePositionLeft

'Moves the selected widget(s) towards the left.'

#changePositionRight

'Moves the selected widget(s) towards the right.'

#changePositionUp

'Moves the selected widget(s) towards the top.'

#editDimensionCopyExtent

'Copies the extent of the selected widget.'

#editDimensionCopyLayout

'Copies the layout of the selected widget.'

#editDimensionDefaultExtent

'Sets the selected widget(s) extent to their default.'

#editDimensionDefaultHeight

'Sets the selected widget(s) height to their default.'

#editDimensionDefaultWidth

'Sets the selected widget(s) width to their default.'

#editDimensionPasteExtent

'Sets the extent of the selected widget(s) to the last copied extent.'

#editDimensionPasteHeight

'Sets the height of the selected widget(s) to the height of the last copied layout/extent.'

#editDimensionPasteLayout

'Sets the layout of the selected widget(s) to the last copied layout.'

#editDimensionPasteWidth

'Sets the width of the selected widget(s) to the width of the last copied layout/extent.'

#editInspectSpec

'Opens an inspector on the spec of the selected widget.'

#editInspectView

'Opens an inspector on the view of the selected widget.'

#editOpenSpecDocumentation

'Opens the documentation of the selected widget.'

#fileBrowseAspectMethods

'Opens a System Browser on the aspect methods.'

#fileLoad

'Opens a dialog to load a window specification from a classes spec method.'

#fileLoadSubspec

'Opens a dialog to load a sub specification from a classes windowSpec method.'

#fileNew

'Creates a new window spec.'

#filePickAnInterface

'Select a view on the screen, generate a window spec for it and edit this spec.'

#fileSave

'Saves the window spec in the current class (as spec method).'

#fileSaveAs

'Opens a dialog to select class and selector for saving the window spec.'

#fileShowWindowSpec

'Opens a Workspace showing the current window spec.'

#generateAspectMethods

'Generates aspect methods for defined aspect selectors of the widgets.'

#generateHookMethods

'Generates startup/release methods. (#closeRequest, #postBuildWith:, #postOpenWith:)'

#helpExamples

'Show some examples uses of the GUI Painter.'

#helpFunctions

'Show the documentation on the GUI Painters menu and button functions.'

#helpLayoutTool

'Show the Layout Tools documentation.'

#helpSelectedWidget

'Show the documentation of the selected widget.'

#helpTutorial

'Show the GUI Painters documentation.'

#historyMenuItem

'Edit this windowSpec.'

#moveWidgetDown

'Moves the selected widget one step down.'

#moveWidgetInto

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

#moveWidgetOut

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

#moveWidgetUp

'Moves the selected widget one step up.'

#pasteBuffer

'Pastes the widgets of the clipboard at the current mouse position.'

#pasteWithLayout

'Pastes the widgets of the clipboard without a changing of their layouts.'

#settingsCanvas

'Shows or hides the canvas window.'

#settingsGallery

'Shows or hides the gallery window.'

#settingsGridManager

'Opens a dialog to toggle grid display or to change the grids spacing.'

#settingsRedefineAspectMethods

'Toggles the permission to overwrite existing aspect methods.'

#settingsAspectsAsInstances

'Generate aspects as instance variables (or bindings, if off).'

#settingsTranscriptHelp

'Toggles display of help texts (after opening a new GUI Painter).'

#settingsUndoManager

'Opens a dialog to undo modifications.'

#spreadSelectionHor

'Sets the horizontal spaces between the selected widgets as the same.'

#spreadSelectionVer

'Sets the vertical spaces between the selected widgets as the same.'

#testGeometryTestMode

'Toggles geometry test mode (to define ratios of variable panels and top-window dimension).'

#testStartApplication

'Starts the application with the current window spec.'

)

    "Modified: / 31.7.1998 / 19:29:53 / cg"

! !

!UIPainter class methodsFor:'helpers'!

convertString:aString maxLineSize:maxCharactersPerLine skipLineFeed:skipLineFeed

    "converts a string to a string collection with maximum characters

     per line

    "

    |stream

	max     "{ Class:SmallInteger }"

	size    "{ Class:SmallInteger }"

	start   "{ Class:SmallInteger }"

	stop    "{ Class:SmallInteger }"

	cpySz   "{ Class:SmallInteger }"

	lnSz    "{ Class:SmallInteger }"

	atBeginOfLine|

    maxCharactersPerLine < 20 ifFalse:[max := maxCharactersPerLine - 1]

			       ifTrue:[max := 20].

    (size := aString size) <= max ifTrue:[

	^ aString

    ].

    start  := 1.

    lnSz   := 0.

    stream := (String new:size) writeStream.

    atBeginOfLine := true.

    [start <= size] whileTrue:[

	(start := aString indexOfNonSeparatorStartingAt:start) == 0 ifTrue:[

	    ^ stream contents

	].

	(aString at:start) == $\ ifTrue:[

	    skipLineFeed ifFalse:[

		stream nextPut:$\

	    ].

	    start := start + 1.

	    stream cr.

	    start := start + 1.

	    lnSz := 0.

	] ifFalse:[