Item
Item objects represent items, toggle items, user defined buttons in Toolbar, Graphics, and Table form objects, and submenus in the menu bar, toolbar, ribbon, and file menus. The following methods are available:
Name
Syntax
Description
getParentItem
Item getParentItem()
Returns the parent item, or null for a top-level item.
hasProperty
boolean hasProperty(String name)
Returns true if there is a modifiable property with the specified name.
item
ItemList item()
Returns the list of subitems.
item
Item item(String name)
Returns the subitem with the specified name.
The Item class contains the following properties:
Property
Value
Default
Description
enabled
on | off
on
If the value is on, the item can be activated by the user. If the value is off, the item cannot be activated.
icon
String
Generated automatically
The icon name. Valid values are images defined in the Images > Libraries node in the Application Builder.
text
String
Generated automatically
The text for a menu or ribbon item.
title
String
Generated automatically
The title text for a menu or submenu.
tooltip
String
""
The tooltip text.
visible
on | off
on
Controls whether the item is visible or not.
In order for an item to be enabled, the enabled property needs to have the value on for the item itself as well as for all of its parents. In other words, disabling an item also disables all of its subitems.
Item objects also include separators. However, separators do not have any accessible properties.
Item objects for user-defined buttons do not have the title and tooltip properties. For Table form objects, predefined items such as “move up” and “move down” do not have any modifiable properties.
Example Code
app.mainWindow().menuBar("menu1").set("title", "new title");
app.mainWindow().menuBar("menu1").item("toggle_item1").set("text",     "test");