Class: MenuEvent

• Inheritance
• Description
• Class protocol
  • instance creation
• Instance protocol
  • accessing
  • instance creation
• Private classes

Inheritance:

   Object
   |
   +--Message
      |
      +--MessageSend
         |
         +--Event
            |
            +--WindowEvent
               |
               +--WidgetEvent
                  |
                  +--MenuEvent
                     |
                     +--MenuEvent::MenuEnterItemEvent
                     |
                     +--MenuEvent::MenuHideEvent
                     |
                     +--MenuEvent::MenuLeaveItemEvent
                     |
                     +--MenuEvent::MenuSelectItemEvent
                     |
                     +--MenuEvent::MenuShowEvent

Package:

stx:libwidg

Category:

Views-Menus

Version:

rev: 1.3 date: 2013/06/21 13:40:23

user: cg

file: MenuEvent.st directory: libwidg

module: stx stc-classLibrary: libwidg

Description:

Internal menu events.
These have been added very lately to support capture & replay inside st/x applications.
They are used internally within a menu-widget instead of direct message sends, thus
allowing interception and synthetization.

Due to some historic leftover, there are two mechanisms for menus:
    1) the (very) old MenuView (which inherits from SelectionInListView)
    2) the new MenuPanel.

The menuView uses simple text and values and it is basically index-based.
The menuPanel uses instances of MenuItem which contain the action information.

The menuView should go away, as soon as someone finds time to convert all leftover uses
of it in the system (mostly popupMenus in text views).

Class protocol:

 enterMenuItem: itemOrNil index: index text: textOrNil value: valueOrNil inMenu: aMenu menuReceiver: menuReceiver

 hideMenu: aMenu

 leaveMenuItem: itemOrNil index: index text: textOrNil value: valueOrNil inMenu: aMenu menuReceiver: menuReceiver

 selectMenuItem: itemOrNil index: indexOrNil text: textOrNil value: valueOrNil inMenu: aMenu menuReceiver: menuReceiver

 showMenu: aMenu

Instance protocol:

 item

attention: only menuPanels return something useful here;
menuview will return nil

 itemIndex

the index (1..) of the menu item

 itemLabel

the item's label text. Might be nil or non-string (image or labelAndIcon)

 itemValue

the item's value. That is completely up to the menu-widget's user.

 menu

the item's menu; either a menuPanel or a menuView

 menuReceiver

 item: itemArgOrNil index: indexArgOrNil text: textArgOrNil value: valueArgOrNil menu: aMenu menuReceiver: menuReceiverArg

Private classes:

    MenuEnterItemEvent
    MenuHideEvent
    MenuLeaveItemEvent
    MenuSelectItemEvent
    MenuShowEvent