\section{Menuitem.mui}

Menuitem class describes a single menu item. You can use
all of the gadtools menus features expect 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.

\subsubsection*{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.

\subsection[MUIA\_Menuitem\_Checked]{MUIA\_Menuitem\_Checked -- (V8) [ISG], BOOL}

\subsubsection*{FUNCTION}
set/get the checked state of a checkit menu item.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Checkit, MUIA\_Menuitem\_Enabled,
MUIA\_Menuitem\_Exclude

\subsection[MUIA\_Menuitem\_Checkit]{MUIA\_Menuitem\_Checkit -- (V8) [ISG], BOOL}

\subsubsection*{FUNCTION}
Set to TRUE and this item will become a checkmarkable item.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Checked, MUIA\_Menuitem\_Enabled,
MUIA\_Menuitem\_Exclude

\subsection[MUIA\_Menuitem\_Enabled]{MUIA\_Menuitem\_Enabled -- (V8) [ISG], BOOL}

\subsubsection*{FUNCTION}
enabled/disalbe the menu item.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Checkit, MUIA\_Menuitem\_Checked,
MUIA\_Menuitem\_Exclude

\subsection[MUIA\_Menuitem\_Exclude]{MUIA\_Menuitem\_Exclude -- (V8) [ISG], LONG}

\subsubsection*{FUNCTION}
bitmask of menu item numbers that are to be deselected
when this one is selected.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Checkit, MUIA\_Menuitem\_Enabled,
MUIA\_Menuitem\_Checked

\subsection[MUIA\_Menuitem\_Shortcut]{MUIA\_Menuitem\_Shortcut -- (V8) [ISG], char}

\subsubsection*{FUNCTION}
Define the shortcut for a menu item.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Title

\subsection[MUIA\_Menuitem\_Title]{MUIA\_Menuitem\_Title -- (V8) [ISG], STRPTR}

\subsubsection*{FUNCTION}
Define the items title.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Shortcut

\subsection[MUIA\_Menuitem\_Toggle]{MUIA\_Menuitem\_Toggle -- (V8) [ISG], BOOL}

\subsubsection*{FUNCTION}
Define the state of the TOGGLE flag for this item.

\subsubsection*{SEE ALSO}
MUIA\_Menuitem\_Checkit, MUIA\_Menuitem\_Enabled,
MUIA\_Menuitem\_Checked

\subsection[MUIA\_Menuitem\_Trigger]{MUIA\_Menuitem\_Trigger -- (V8) [..G], struct MenuItem $\ast$}

\subsubsection*{FUNCTION}
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 any
maybe a bit easier with MUIA\_Application\_ReturnID,
MUIA\_Application\_MenuAction and MUIA\_Window\_MenuAction.