1.95.5 Get methods

menu <-active_item: item=member:menu_item -> active=bool

Returns a boolean, indicating the active status of the referred to menu_item.

See also

menu->active_item

menu <-contains: -> items=chain

Returns the menu<-members chain of menu_item objects.

menu <-item_from_event: event=event -> item=menu_item

When event is an event that occurred on the menu, return the menu_item on which are it occurred. May be used to redefine event-handling of menu's.

Diagnostics: Fails silently when the event did not occur on a menu_item's area.

See also

menu->event

menu <-member: value=any -> member=menu_item

When the argument is a menu_item, return this menu_item if it is part of this menu. Otherwise, find the menu_item that has menu<->value equal to the provided value and return this.

Diagnostics: Fails silently on failure.

Bugs: For backward compatibility, if there is no item with menu_item<-value that matches the specification, it will return the first item for which the conversion of the argument and menu_item<-value to a name yield the same name.

See also

- menu->member
- menu->off

menu <-modified: -> modified=bool

Yields @on if the user has modified the menu since the last menu->selection, menu->modified: @off or menu->default. See also menu->apply.

If menu->modified is set to @on the graphical<-device will be informed using dialog->modified_item. See dialog_item->modified.

menu <-selection: -> values=any|chain*

When menu<-multiple_selection equals @off, returns menu_item<-value of the selected menu_item. Otherwise it returns a new chain with the menu<-value for each of the selected items (the chain may be empty).

Diagnostics: Fails if menu<-multiple_selection equals @off and no items are selected. This should only happen it there are no items in the menu.

See also

menu->selection