CLEARALL

None

The CLEARALL keyword will clear all menus; excluding the coremenus.omn   This enables your menu to completely control the Oasis montaj environment for your specific application.  The CLEARALL keyword, if used, should be the first keyword in your menu file.

If you use this keyword, you should provide your user with access the *ID_CLEARMENU internal command somewhere in your menu system.  This command will allow your user to reset the menus to the Geosoft coremenus.omn.

MENU

Name

This identifies a new menu, which can appear on the Oasis montaj menu bar, or may be a submenu that will become part of a previously defined menu.  Each MENU line is followed by one or more ITEM lines, SUBMENU lines or SEPARATOR lines.

You can also specify the name of a pop-up menu that is activated when the right-mouse button is pressed.  Pop-up menus are context sensitive, which means that the menu that appears depends on the current mode and the object that is under the mouse cursor at the time the right-mouse button is pressed.

SUBMENU

Name
<image.bmp[i]> 

This identifies a menu entry that will be a sub-menu in the menu list.  There must be a MENU associated with the submenu later in the OMN file, and the name in the MENU must be “menu_name/sub_menu_name”.  See the above example.  Submenus may also be nested.

SEPARATOR

None

Places a separator to space items in the menu list when displayed.

LOADMENU

File

Load another menu file.  If you need to share certain menu components among applications, it is easier to store the menus in a separate menu file that can be included in other menu files.  If a menu file is never intended to be used by itself, you should give it extension “.smn” to prevent the file from appearing in the load menu browse tool.

All menu files are located in the <geosoft>\omn directory by default.  Menus that are not located in this directory must be specified explicitly (see File Names below).

LOCATE

TOP
BOTTOM
AFTER "Name"
BEFORE "Name"

Controls the location of the menu items that follow.  The AFTER and BEFORE require the name of a menu item that already exists in the menu.

ITEM

Name, Action
<image.bmp[i]>
{?context}

An ITEM in a menu identifies an action that will happen when your user selects the item.

Name is the text that appears in the menu. An "&" placed in front of a letter indicates the keyboard shortcut key (alt-key).

Action is the name of a GX, a GS script, a Python script, a Win-32 help file, a DLL or the name of an internal command. Refer to the detailed ITEM documentation below for more information. Internal commands must be one of the commands listed in the Internal Command table below.

<image.bmp[i]> is the name (and optional image index) of an icon image to display next to the item.

{?context} is a conditional context test that if not true will shade the item Name in the menu.  See Controlling Item Activation.