menuHistory
Type
property
Summary
Specifies the number of the currently selected item of the menu that belongs to a button.
Syntax
set the menuHistory of <button> to <itemNumber>
Description
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 menus is ambiguous. Avoid setting or relying on the menuHistory of a cascading menu.
Examples
set the menuHistory of button "Tabs" to 1
Related
function: menuButton, selectedText
glossary: property, message, mouse pointer, menu item, cascading menu
keyword: integer, menu, button
message: menuPick
object: button
property: menuName, selected, label
command: pulldown
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile