Mtype

mtype (Num) specifies any valid combination of options from the following table:

Symbol

Value

Meaning

MBF_CMDLIN

&h00000000

Normal. Selecting the menu item causes the contents of cmd to be executed as a Windows command line, as if it had been executed via HOSTEX.SBR. As with HOSTEX.SBR, you can refer to the current A-Shell executable (and its current miame.ini) via the macro symbol $ASHELL, and you can use the suffix characters available to HOSTEX.SBR. For example, "$ASHELL –e run armenu" would launch a new A-Shell instance, run the program armenu, and suspend the current session until armenu exited.

MBF_DLL

&h00000001

DLL. Selecting the menu item causes the function (func) with the associated DLL (defined in cmd) to be loaded and executed.

MBF_CHKMNU

&h00000004

Menu item is "checkable".  See MBST_CHECKED in Mstate

MBF_RADIOMNU

&h00000008

Menu item is part of a radio button group.  Same idea as MBF_CHKMNU except only one item in a group of contiguous radio button items may be selected.

MBF_SUBMNU

&h00000010

Submenu. Selecting the menu item will cause a submenu to appear. As of 5.1.1154, nested submenus are supported.  To create a nested submenu, assign a unique Itemid to the parent item, i.e. the one with the MBF_SUBMNU type, and then specify that itemid in the Menuid of the child items (one or more of which can themselves be submenus).

MBF_SEP

&h00000800

Separator. Item displays a s horizontal separator bar. Separators cannot be selected and only serve to visually organize submenus. Even though separators do not display the mnutxt contents, they still need a unique mnutxt string to allow the item to be deleted later.

MBF_KBD

&h00010000

Keyboard. Selecting the menu item causes the contents of cmd to be forced into the keyboard buffer. This technique may minimize the impact on the program, since to it, menu selections may appear just like ordinary keyboard responses, but you have to be careful to disable such menus when the program context is not correct to interpret such responses. See cmd for further notes on designing and encoding keyboard sequences.

MBF_SHLEXC

&h00020000

Shell execute. Selecting the menu item causes the contents of cmd to be interpreted as an object (file or URL) to be opened using the associated application defined in the Windows registry. For example, if CMD="http://www.microsabio.com", then selecting it would launch the browser and go to the specified web page. If CMD= "mydata.xls", selecting the menu would probably launch Excel to open the spreadsheet.

If the file object specified in CMD does not contain a drive or directory specifier, then it will be assumed to be in A-Shell’s "DOC" subdirectory (e.g. c:\vm\miame\doc). Otherwise, you need to specify a native pathspec (unless the file is in the system search PATH). Refer to MX_FSPEC for converting AMOS directories to their native equivalents.

MBF_MENUID

&h00040000

Internal menu command identifier.  This is the type of the internal or built-in menus.  When clicked, then just send a message with their ID to the A-Shell message handler. See Adding/Deleting Internal Menu Items for further details.

Hex-Decimal Values