3.36  popup-menu%

Implements: menu-item-container<%>

A popup-menu% object is created without a parent. Dynamically display a popup-menu% with , popup-menu in window<%>, or popup-menu in editor-admin%.

A popup menu is not a control. A choice% control, however, displays a single value that the user selects from a popup menu. A choice% control's popup menu is built into the control, and it is not accessible to the programmer.

• (instantiate popup-menu% () [(title _)] [(popdown-callback _)] [(demand-callback _)]) -> popup-menu% object
     title = #f : string (up to 200 characters) or #f
   popdown-callback = (lambda (m e) (void)) : procedure of two arguments: a popup-menu% object and a control-event% object
     demand-callback = void : procedure of one argument: a popup-menu% object

  If title is not #f, it is used as a displayed title at the top of the popup menu.

  If title contains an ampersand (``&''), it is handled specially, the same as for menu% titles. A popup menu mnemonic is not useful, but it is supported for consistency with other menu labels.

  The popdown-callback procedure is invoked when a popup menu is dismissed. If the popup menu is dismissed without an item being selected, popdown-callback is given a control-event% object with the event type 'menu-popdown-none. If the popup menu is dismissed via an item selection, the item's callback is invoked first, and then popdown-callback is given a control-event% object with the event type 'menu-popdown.

  The demand-callback procedure is called by the default on-demand method with the object itself.

  
  

Methods
    get-popup-target

All Methods
    get-items from menu-item-container<%>
    get-popup-target from popup-menu%
    on-demand from menu-item-container<%>