Family.mui

Menuitem class describes a single menu item. You can use all of the gadtools menus features except Image menus here.

Since Menuitem class is a subclass of Family class, you can add other menu items as children of a menu item to indicate sub menus. MUI does not limit the level of sub menus, but the operating system currently allows a maximum nesting level of one. Because of this, children of menu items should not contain other menu items for now, the results are unpredictable.

Note: For handling menu items, MUIA_UserData and the methods MUIM_SetUData, MUIM_GetUData and MUIM_FindUData can become quite useful. See the Menu demo program and the accompanying documentation for details.

MUIA_Menuitem_AISSName -- V21 [ISG], STRPTR, 0x804248f2

Define an optional AISS image to be placed in front of the item's text. This name is simply the file name as it is contained in the TBIMAGES: directory, i.e. "cut" or "copy".

The image will be displayed only if the following conditions are met:

• AISS is installed
• the image can be loaded via datatypes.library
• the menu is displayed by MUI's Popmenu class
• the user has enabled the option on the Menu page of MUI prefs

MUIA_Menuitem_Checked -- V8 [ISG], BOOL, 0x8042562a

Set/get the checked state of a checkit menu item.

MUIA_Menuitem_Checkit, MUIA_Menuitem_Enabled, MUIA_Menuitem_Exclude

MUIA_Menuitem_Checkit -- V8 [ISG], BOOL, 0x80425ace

Set to TRUE and this item will become a checkmarkable item.

MUIA_Menuitem_Checked, MUIA_Menuitem_Enabled, MUIA_Menuitem_Exclude

MUIA_Menuitem_CommandString -- V16 [ISG], BOOL, 0x8042b9cc

Set to TRUE if MUIA_Menuitem_Shortcut points to a command string (e.g. "shift alt q") instead of a simple letter. Note that MUI won't check if these keys are pressed (just like intuition), you'll have to do this yourself.

MUIA_Menuitem_Shortcut

MUIA_Menuitem_CopyStrings -- V16 [I..], BOOL, 0x8042dc1b

Set to TRUE if the title string defined by MUIA_Menuitem_Title is to be copied. Otherwise the title will be used directly and must remain valid throughout the object's life time.

Defaults to FALSE.

MUIA_Menuitem_Title

MUIA_Menuitem_Enabled -- V8 [ISG], BOOL, 0x8042ae0f

Enabled/disable the menu item.

MUIA_Menuitem_Checkit, MUIA_Menuitem_Checked, MUIA_Menuitem_Exclude

MUIA_Menuitem_Exclude -- V8 [ISG], LONG, 0x80420bc6

Bitmask of menu item numbers that are to be deselected when this one is selected.

MUIA_Menuitem_Checkit, MUIA_Menuitem_Enabled, MUIA_Menuitem_Checked

MUIA_Menuitem_FreeImage -- V20 [I..], BOOL, 0x8042f95f

Define whether the image object passed to MUIA_Menuitem_Image will be disposed automatically or not. If this attribute is set to FALSE it is the responsibility of the application to dispose the image object itself.

Defaults to TRUE.

MUIA_Menuitem_Image

MUIA_Menuitem_Image -- V20 [ISG], struct Image *, 0x8042080b

Define an optional image to be placed in front of the item's text. This MUST be a BOOPSI image created by imageclass of intuition.library (or one of its subclasses). The image will be disposed automatically unless MUIA_Menuitem_FreeImage is set to FALSE. This also applies for images being replaced by OM_SET.

For normal pull down menus such images are fully supported by AmigaOS4 only and only if intuition.library V54.6+ is used. However, for MUI's own internal menu class these images are supported for AmigaOS3 as well and without any further requirements regarding intuition.library.

MUIA_Menuitem_FreeImage

MUIA_Menuitem_Menuitem -- V20 [ISG], Object *, 0x80424b21

During OM_NEW and OM_SET this attribute will copy all settings from the specified Menuitem object to the current object. During OM_GET this attribute will copy all settings from the current object to the specified Menuitem object. All strings and images of the destination object will be freed if required before the new string and images are copied over from the source object.

MUIA_Menuitem_Shortcut -- V8 [ISG], STRPTR, 0x80422030

• MUIV_Menuitem_Shortcut_Check

Define the shortcut for a menu item.

The special value MUIV_Menuitem_Short_Check will interpret the menu item's title in such a way, that the first character will be used as shortcut and must be followed by a NUL byte and finally the real title string.

/* create a "Quit" menu item with "Q" as shortcut */
MenuitemObject,
  MUIA_Menuitem_Title, "Q\0Quit",
  MUIA_Menuitem_Shortcut, MUIV_Menuitem_Shortcut_Check,
  End;

MUIA_Menuitem_Title

MUIA_Menuitem_Title -- V8 [ISG], STRPTR, 0x804218be

Define the items title. May be NM_BARLABEL to create a horizontal bar.

MUIA_Menuitem_Shortcut

MUIA_Menuitem_Toggle -- V8 [ISG], BOOL, 0x80424d5c

Define the state of the TOGGLE flag for this item.

MUIA_Menuitem_Checkit, MUIA_Menuitem_Enabled, MUIA_Menuitem_Checked

MUIA_Menuitem_Trigger -- V8 [.SG], struct MenuItem *, 0x80426f32

This attribute is set to a pointer to the struct MenuItem of the item object when the item is selected. By setting up notification on this attribute with MUIV_EveryTime, you can react on menu actions and query the MenuItems flags immediately.

Note that menu reactions are also possible and maybe a bit easier with MUIA_Application_ReturnID, MUIA_Application_MenuAction and MUIA_Window_MenuAction.

The passed struct MenuItem pointer for a notification is strictly READ-ONLY and no other fields than the flags field should be examined.