Livecode Wiki
Advertisement

Specifies the number of the currently selected item of the menu that belongs to a button.Syntax:

set the menuHistory of <button> to <itemNumber>

Examples:

set the menuHistory of button "Tabs" to 1

Use the menuHistory property to change the selected item in a menu, or to find out which menu item is currently selected.

When you set the menuHistory property, a menuPick message is sent to the button.

If the button's menuMode is "comboBox", setting its menuHistory also changes the button's label to the new menu item.

If the button's menuMode is "tabbed", setting its menuHistory also changes the active tab.

If the button's menuMode is "option", setting its menuHistory changes the label. It also determines which menu item is under the [[mouse pointer]] when the menu next appears. Make sure to set the menuHistory property of an option menu whenever you change the current choice, so that the choice is under the mouse pointer when the user clicks the menu.

The effect of the menuHistory property in [[cascading menu|cascading menus]] is ambiguous. Avoid setting or relying on the menuHistory of a cascading menu.

Notes[]

When you set the menuHistory property of a menu button (any menuMode), a menuPick message is sent to the button ONLY if the button's menuHistory was changed by setting it. (3.5.0.770)

It's also possible to read the menuHistory of a tabbed button, which can be used to perform different actions based on the tab selected. For example:

switch the MenuHistory of button "foo"
  case 1
     --do one set of things
     break
  case 2
     --do a different set of things
     break 
end switch

(edgore@shinra.com)


See also: selectedText (function),menuPick (message),button (object),menuName (property),selected (property),label (property),

Advertisement