1.97.3 Get methods

menu_item <-contained_in: -> menu

Return the menu in which this menu_item resides.

menu_item <-convert: value=any -> menu_item

When argument is an instance of class popup, create a menu_item from the graphical<-name and relate the popup with this menu_item using (menu_item->popup and popup->context). This conversion allows simple specification of pull-right menus:

new(P, popup(attributes)),
new(C, popup(colour)),
new(F, popup(font)),
send_list(C, append, [...]),	% fill sub-popups here
send_list(F, append, [...]),
send_list(P, append, [C, F]).	% associate as pullright

When the argument is not a popup, menu_item<-convert will create a menu-item using the argument as a value and leaving all other menu_item->initialise parameters @default.

See also

- menu_item->initialise
- menu_item-popup
- menu->append

menu_item <-default_label: value=any -> label=name|image

Computes the default label from the value. This method is normally called by menu_item<-initialise when the label argument is @default.

It performs the following steps:

• If the argument is a graphical object, create an image with the size of the graphical and call image->draw_in to draw the graphical in the image.
• If the argument is a name, all char_array<-label_name to map the word-separator (default’_’, see pce->syntax) to a space and capitalise all the words.
• If argument menu_item<-name yields a name, call char_array<-label_name on it and return the result.
• Call PCE's pretty-print to print the object-reference and class. The latter is an emergency to simplify debugging.

  To realise multi-language support, one might wish to redefine this method yielding labels in the user's preferred language from internal program names.

  See also

  - char_array<-label_name
  - menu_item->initialise
  - menu_item-value
  - menu_item-label