When @on, the
menu_item may be selected by the user. When @off,
the menu_item is insensitive to events. Normally the menu will indicate
this by greying the menu_item.
Defaults: @on
(active to events)
- See also
- - menu
->off
- menu_item-condition
- menu->active_all_items
Colour used to paint the label of this menu_item. Normally used only to
create colour palets.
Defaults:
@default (its
default value) will paint the menu_item in the colour of its associated menu_item<-menu.
- See also
- - menu_item
-label
- menu_item-font
Applicable to popup-menu's only. When not @nil,
the truth value of this
code object is tested
just before the popup menu is mapped on the screen and the item is made menu_item<-active
according the this truth value.
Tested by popup->update.
Defaults: @nil
(popup->update
does not change activation status).
- See also
- - menu
->off
- popup->update
- menu_item-active
- popup-update_message
Popup-menus only. When @on,
a line is painted between this item and the next.
Defaults: @off
(no line is painted).
Font used to paint the menu_item<-label.
Normally used to realise font-selection menus.
Defaults: When @default, menu<-value_font
of the associated menu_item<-menu
is used.
The combo box of a cycle menu (see menu->kind)
shows the items in this font, or in the font of the attribute
preview_font if present. Items whose font cannot display
the label are omitted. As the size of the menu is computed using
menu_item<-font, preview_font
avoids loading the fonts of a long menu that previews many fonts.
- See also
- - menu
-value_font
- menu_item-label
- menu_item-colour
When a name, the menu will display this text in the menu_item<-colour
and menu_item<-font
specified with this item. When is is an image, the menu will display
this image in menu_item<-colour.
When it is a markup
object, the menu displays the text with the fonts, colours, etc. of the
markup, on top of
menu_item<-colour
and menu_item<-font.
For example:
menu_item(save, @default, markup('<b>Save</b> all'))
The mnemonic is chosen from the text without the markup and
underlined. The list that opens from a cycle menu shows the
markup as well.
The initial value is normally computed by menu_item<-default_label
from the
menu_item<-value
by menu_item->initialise.
- See also
- - menu_item
-value
- menu_item->initialise
- menu_item<-default_label
- menu_item-colour
- menu_item-font
Menu I'm part of. Used to forward changes to the associated menu which
is responsible for the visual representation and event-processing for
this menu_item.
The menu maintains a list of menu_items manipulated in menu<-members.
- See also
- menu
-members
Message executed when the item is selected. When @nil,
no message will be sent. When @default,
the menu_item<-message
from the associated menu_item<-menu
will be sent.
The arguments forwarded depend on the menu. See description with
class menu.
- See also
- class menu
Value associated with this item. Menu items have both a value and a
label. The latter is displayed while the value is used for internal
communication in the program.
This separation is useful for two purposes. First of all menu's are
often used to select some value. For example a colour in a drawing tool.
In this case the colour
object is used as a value, while an all-1's image with is used as label
and menu_item<->colour
is set to
menu_item<->value.
When the user selects a menu-item, the colour
object to be used may be read directly from the menu_item<->value
object of the menu_item.
Second, this mechanism may be used to implement multi-language
interfaces. In this case the menu_item<->value
represents the internal name used by the program and the menu_item<->label
the external name that may be in a different language.
The default menu_item<->label
is compute from the initial menu_item<->value
using
menu_item<-default_label.
- See also
- - menu_item
<-default_label
- menu_item-label
