"

 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.

"

"{ Package: 'stx:libtool2' }"

ResourceSpecEditor subclass:#MenuEditor

	instanceVariableNames:'selectionHolder tabHolder listOfItems listOfTabs

		selectedSuperItems notifyDisabledCounter wizards listOfItemsView

		redefineAspectMethods'

	classVariableNames:'ImageRetrieverClasses'

	poolDictionaries:''

	category:'Interface-UIPainter'

!

HierarchicalItem subclass:#Item

	instanceVariableNames:'menuItem'

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

MenuEditor::Item subclass:#ItemAction

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

MenuEditor::Item subclass:#ItemLinkedMenu

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

MenuEditor::Item subclass:#ItemMenu

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

MenuEditor::ItemMenu subclass:#ItemRoot

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

MenuEditor::Item subclass:#ItemSeparator

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

ApplicationModel subclass:#ResourceEditor

	instanceVariableNames:'selectorHolder iconAndLabelHolder retrieverHolder imageHolder

		imageList imageViewer'

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

HierarchicalItem subclass:#ResourceEditorItem

	instanceVariableNames:'selector icon'

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

!MenuEditor 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

"

    The MenuEditor allows you to create, modify or just inspect

    menus.

    [Instance variables:]

	selectionHolder         <ValueHolder>        collection of current selected items

	tabHolder               <ValueHolder>        selected tab label holder

	listOfItems             <HierarchicalList>   hierarchical list of menu items

	listOfTabs              <List>               list of current shown tab-labels

	wizards                 <IdentityDictionary> keeps all created wizard dialogs

	selectedSuperItems      <Collection>         collection of superItems derived from selection

	notifyDisabledCounter   <SmallInteger>       ~~ 0 than change notifications are discard

    [Class variables:]

	ImageRetrieverClasses   <Collection>        sorted collection of image receivers

    [start with:]

	MenuEditor open

	MenuEditor openOnClass:MenuEditor andSelector:#menu

    [author:]

	Claus Atzkern, eXept Software AG

	Thomas Zwick, eXept Software AG

"

! !

!MenuEditor class methodsFor:'initialization'!

initialize

    ImageRetrieverClasses := #( 

				Icon

				SystemBrowser 

				ToolbarIconLibrary

			      ). 

    "

     self initialize

    "

! !

!MenuEditor class methodsFor:'instance creation'!

openModalOnMenu: aMenu

    "Open a MenuEditor modal on aMenu

     self openModalOnMenu: (self perform: #menu) decodeAsLiteralArray

    "

    ^self new openModalOnMenu:aMenu

! !

!MenuEditor class methodsFor:'accessing image retriever'!

addNewImageRetriever:aSymbolOrClass

    "add a class to the imageRetriever list"

    |key|

    aSymbolOrClass isBehavior ifTrue:[

	key := aSymbolOrClass nameWithNameSpacePrefix

    ] ifFalse:[

	key := aSymbolOrClass

    ].

    key size ~~ 0 ifTrue:[

	key := key asSymbol.

	(ImageRetrieverClasses includes:key) ifFalse:[

	    ImageRetrieverClasses := ImageRetrieverClasses asOrderedCollection.

	    ImageRetrieverClasses add:key.

	    ImageRetrieverClasses sort.

	]

    ].

!

imageRetrieverClasses

    "returns a collection of image retrievers

    "

    ^ ImageRetrieverClasses

! !

!MenuEditor class methodsFor:'aspects'!

aspects

    "get the aspects for the attributes of the menu components"

    ^#(

	rawLabel

	accessCharacterPosition

	showBusyCursorWhilePerforming

	horizontalLayout

	triggerOnDown

	font

	argument

	submenuChannel

	keepLinkedMenu

	enabled

	value

	nameKey

	indication

	choice

	choiceValue

	translateLabel

	isButton

	shortcutKeyCharacter

	startGroup

	isVisible

	hideMenuOnActivated

	auxValue

	activeHelpKey

	resourceRetriever

     )

! !

!MenuEditor class methodsFor:'defaults'!

aboutImage

    "the image to be displayed in my about-box;

     If nil is returned, the ST/X default image is used.

    "

    ^ Image fromFile:'bitmaps/xpmBitmaps/misc_tools/setup_menus.xpm'

!

resourceType

    "get the type of the resource of the method generated by the MenuEditor

    "

    ^ #menu

! !

!MenuEditor class methodsFor:'help specs'!

flyByHelpSpec

    ^super flyByHelpSpec addPairsFrom:(self localHelpSpecStrings)

!

helpSpec

    ^super helpSpec addPairsFrom:(self localHelpSpecStrings)

!

localHelpSpecStrings

    "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:MenuEditor    

    "

    <resource: #help>

    ^ #(

#addDelayedMenu

'Add a new delayed menu to item.'

#addDelayedSubMenuLink

'Add a new linked delayed menu to item.'

#addMenuItem

'Add a new menu item.'

#addMenuSeparator

'Add a new menu separator.'

#addSubMenu

'Add a new sub menu.'

#addSubMenuLink

'Add a new linked sub menu.'

#basicsAction

'An action selector with 0, 1 (the argument field), or 2 (the selected item) arguments.'

#basicsArgument

'An optional arg passed with above selector, if it is a 1 or 2 arg selector (enter a Smalltalk literal).'

#basicsChoice

'Aspect for a boolean holder, block or method, specifying the choices state (RadioButton behavior).'

#basicsChoiceValue

'That choices value (typically number or symbol).'

#basicsIndication

'Aspect for boolean holder, block, or method, specifying the indication state (CheckToggle behavior).'

#basicsIsButton

'Enable/disable button-like behavior.'

#basicsKey

'Internal key of the item (optional, for programmed accesses).'

#basicsLabel

'Label of the item.'

#basicsMenu

'Aspect providing the sub menu to be opened if item is selected (provide spec or valueHolder).'

#basicsMenuArgument

'An argument passed with the menu selector.'

#basicsNameKey

'Unique identifier of the item (optional).'

#basicsSelector

'Selector under which the generated menu spec is saved.'

#basicsSeparatorType

'List of valid separators.'

#basicsTranslateLabel

'Translate the label via the classes resource file (internationalization).'

#browseResource

'Search for methods with image resource.'

#detailsAccelerator

'Accelerator key to select the menu item from the keyboard (Cmdx or Ctrlx).'

#detailsAccessCharaterPosition

'Index of the access character position of the textual label (obsolete, VW compatibility).'

#detailsAuxValue

'Some additional value - for arbitrary use by the program'

#detailsEnabled

'Aspect or binding providing a boolean value holder for the enable-state of the menu item.'

#detailsStartGroup

'Specify start of a right-aligned item group.'

#detailsVisibility

'Aspect or binding providing a boolean value holder for the visibility-state of the menu item.'

#fileLoad

'Open a dialog to select and load a menu spec from a class.'

#fileNew

'Create a new menu spec.'

#filePickAMenu

'Select a menu from an open view and read its specification'

#fileSave

'Save the menu spec (and the help spec, if modified).'

#fileSaveAs

'Open a dialog to save the menu spec (and the help spec, if modified).'

#fileShowMenuSpec

'Opens a Workspace showing the current menu spec.'

#generateAspectMethods

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

#hideMenuOnActivated

'If on, the menu hides itself after the item was activated.'

#horizontalLayout

'If on, the submenu organizes its items horizontal insteat of vertical (default).'

#imageImageAndLabel

'Toggle display of both image and textual label.'

#imageImageEditor

'Open an Image Editor on the resource method defined by retriever and selector.'

#imageImageList

'Currently existing image resources.'

#imageRetriever

'Class implementing the image resource method. If no class is given, the current application class will be taken.'

#imageSelector

'Selector returning an image (sent to above or the application).'

#keepLinkedMenu

'Keep the linked menu after activation (do not destroy).'

#showBusyCursorWhilePerforming

'If on, a busy cursor is shown while the items action is performing.'

#triggerOnDown

'If on, the items action is performed on mouse-button press (default is on button-release).'

)

! !

!MenuEditor class methodsFor:'image specs'!

iconUnknown

    "returns an image used for picked items containing an image

    "

    <resource: #fileImage>

    ^ MenuPanelSpec icon

! !

!MenuEditor class methodsFor:'interface specs'!

windowSpec

    "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:MenuEditor andSelector:#windowSpec

     MenuEditor new openInterface:#windowSpec

     MenuEditor open

    "

    <resource: #canvas>

    ^ 

     #(#FullSpec

        #name: #windowSpec

        #window: 

       #(#WindowSpec

          #label: 'Menu Editor'

          #name: 'Menu Editor'

          #min: #(#Point 550 385)

          #max: #(#Point 1152 900)

          #bounds: #(#Rectangle 117 275 693 750)

          #menu: #menu

          #returnIsOKInDialog: false

          #escapeIsCancelInDialog: false

        )

        #component: 

       #(#SpecCollection

          #collection: #(

           #(#MenuPanelSpec

              #name: 'toolbar'

              #layout: #(#LayoutFrame 0 0.0 0 0 0 1.0 32 0)

              #tabable: true

              #menu: #toolbar

              #showSeparatingLines: true

            )

           #(#VariableHorizontalPanelSpec

              #name: 'VariableHorizontalPanel'

              #layout: #(#LayoutFrame 0 0.0 34 0.0 0 1.0 -26 1.0)

              #component: 

             #(#SpecCollection

                #collection: #(

                 #(#HierarchicalListViewSpec

                    #name: 'ListOfItemsView'

                    #model: #selectionHolder

                    #menu: #editMenu

                    #hasHorizontalScrollBar: true

                    #hasVerticalScrollBar: true

                    #miniScrollerHorizontal: true

                    #miniScrollerVertical: true

                    #listModel: #listOfItems

                    #multipleSelectOk: true

                    #useIndex: false

                    #highlightMode: #label

                    #doubleClickSelector: #indicatorClickedAt:

                    #selectConditionSelector: #canSelect:

                    #showLeftIndicators: false

                    #indicatorSelector: #indicatorClickedAt:

                    #properties: 

                   #(#PropertyListDictionary

                      #dragArgument: nil

                      #dropObjectSelector: #dropObjects

                      #dropArgument: nil

                      #canDropSelector: #canDrop:

                      #dropSelector: #doDrop:

                    )

                    #postBuildCallback: #postBuildListOfItemsView:

                  )

                 #(#ViewSpec

                    #name: 'Box'

                    #level: -1

                    #component: 

                   #(#SpecCollection

                      #collection: #(

                       #(#NoteBookViewSpec

                          #name: 'NoteBook'

                          #layout: #(#LayoutFrame 1 0.0 0 0.0 1 1.0 -30 1.0)

                          #enableChannel: #hasSingleSelectionChannel

                          #tabable: true

                          #model: #tabHolder

                          #menu: #listOfTabs

                          #fitLastRow: false

                          #canvas: #wizardHolder

                          #keepCanvasAlive: true

                        )