"

 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

		dropOverLine'

	classVariableNames:'ImageRetrieverClasses'

	poolDictionaries:''

	category:'Interface-UIPainter'

!

HierarchicalItem subclass:#Item

	instanceVariableNames:'menuItem'

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:MenuEditor

!

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

        listOfItemsView         <HierarcicalListView>  the view which shows the list of items

        listOfItems             <HierarchicalList>     hierarchical list of menu items

        listOfTabs              <List>                 list of current shown tab-labels

        selectionHolder         <ValueHolder>          collection of current selected items

        selectedSuperItems      <Collection>           collection of superItems derived from selection

        tabHolder               <ValueHolder>          selected tab label holder

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

        wizards                 <IdentityDictionary>   keeps all created wizard dialogs

        dropOverLine            <nil or SmallInteger>  nil: drop context not dropabel.

                                                       = 0: drop context dropable but no item specified

                                                       ~ 0: drop context dropable for item at lineNumber

                                                       used t6o restore drop indication drawings

    [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

        itemValue

        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 localFlyHelpSpecStrings)

!

helpSpec

    ^super helpSpec addPairsFrom:(self localHelpSpecStrings)

!

localFlyHelpSpecStrings

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

    ^ #(

#fileLoad

'Load Spec from Class'

#fileSave

'Save Spec'

#fileSaveAs

'Save Spec As'

#addMenuSeparator

'Add Separator'

#addMenuItem

'Add Item'

#addSubMenu

'Add Submenu'

#addDelayedMenu

'Add Delayed Menu'

#addDelayedSubMenuLink

'Add linked Delayed Menu'

#addSubMenuLink

'Add Linked Submenu.'

#browseResource

'Search for methods with image resource.'

#fileNew

'New Spec'

#filePickAMenu

'Pick from View'

#fileShowMenuSpec

'Show Spec'

)

!

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.'

#settingsRedefineAspectMethods

'Toggles the permission to overwrite existing aspect methods.'

#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'