eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'MenuEvent':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: MenuEvent


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:

instance creation
o  enterMenuItem: itemOrNil index: index text: textOrNil value: valueOrNil inMenu: aMenu menuReceiver: menuReceiver

o  hideMenu: aMenu

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

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

o  showMenu: aMenu


Instance protocol:

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

o  itemIndex
the index (1..) of the menu item

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

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

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

o  menuReceiver

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


Private classes:

    MenuEnterItemEvent
    MenuHideEvent
    MenuLeaveItemEvent
    MenuSelectItemEvent
    MenuShowEvent


ST/X 7.2.0.0; WebServer 1.670 at bd0aa1f87cdd.unknown:8081; Fri, 29 Mar 2024 08:01:41 GMT