Oasis montaj Menus and Toolbars

A pop-up menu is a context sensitive menu that appears when the right mouse button is pressed. The menu that is displayed (popped-up) depends on what has been selected, where the mouse is located and/or the current mode of Oasis montaj. The default oasis pop-up menus are defined in the file montaj_popups.smn in the Geosoft directory. The following table lists some of the available pop-up menus:

Files to be located by name, either in OMN files, GEOBAR files, or in scripts, will be located either in their default location (<geosoft>\omn for menu files, <geosoft>\gx for GX files), or in the location explicitly identified by a full path name.  For explicitly located files, you may use a prefix <label> to identify a directory in which to locate a file.  Allowable <label> values are:

For example, if you install your custom system, including GXs, in the user\my_system directory, you can identify the GX in your OMN file as follows:

ITEM,”Run one of my GX’s”,<geosoft>\user\my_system\my_gx.gx

An ITEM can use the SHELL action to identify an operating system command to be executed.   The SHELL action syntax is as follows:

 ITEM "Text" ,SHELL(verb;file[;parameters;directory;ShowCmd] )

 ITEM "Text" ,SHELL(WinHelp;data[;nCmd])

The Windows "ShellExecute" command is called with the specified parameters.  For the WinHelp verb, the Windows WinHelp command is used.  Please refer to your Windows API documentation for the use of these parameters.  Note that the items in square brackets are optional and are for special use when full control of the Windows functions are required..  ShowCmd and nCmd are both integer values that can be set to the Windows manifest constant values as required.  By default, ShowCmd will be  1 (SW_SHOWNORMAL), and nCmd will be 258 (HELP_COMMAND).

The following are common examples show how to use the SHELL command:

ITEM "&Geosoft Website",SHELL(open;http://www.geosoft.com)
ITEM "&Geosoft Website",SHELL(open;http://www.geosoft.com)
ITEM "&Send a message",SHELL(open;"mailto:geonet@lists.geosoft.com")
ITEM "&Subscribe",SHELL(open; "mailto:majordomo@lists.geosoft.com?subject=Subscribe%20to%20GEONET%20user%20help%20list.?body=SUBSCRIBE%20gxnet")
ITEM "Ho&w to get help...",SHELL(WinHelp; "JumpID(\"oe32.hlp\",\"ID_HELP_TECH_SUPPORT_TOPIC\")") 

Menu and toolbar items can also activate an internal command, which can be named in an ITEM.  Note that internal commands are not stored in a script or in the processing log file. Only GX commands and GX parameters appear in a script of a log file. If scripting is required, most commands can be emulated by writing a GX that performs the required action. 

Menu items can display images (icons really) to stress what an item does or represents.  Icons must be 18 x 18 in size (pixels) and can be stored individually or contained in a larger bitmap file and indexed by the image number in square brackets [].  For example, if my bitmap file contains six 18 x 18 images and the item requires the 4^th image in the file you would use <image.bmp[3]> to reference that position (index count begins at 0).  Image files are .bmp files and are usually stored in the img subdirectory of Oasis montaj.

Examples:

ITEM "Run &GX...", gxrun.gx <standard.bmp[13]>
ITEM "&Load menu...", *ID_VIEW_LOADMENU <standard.bmp[14]> 

Some items should only be active if the project has a database or a map open.  You can specify the item dependency by placing one of the following qualifiers at the end of an ITEM line.  The menu item will be greyed out if the dependancy is not true:

{map}

{gdb}

{map_or_gdb}

{map_and_gdb}

{packed_map}

Examples:

ITEM "New database line", newline.gx {gdb}
ITEM "Display on the map", display.gx {map}
ITEM "Draw database line on map", drawline.gx {map_and_gdb}

Note that dependencies can be in any order at the end of a line. 

The default Oasis montaj menu will contain the minimum menu you see when you do not have a project open. This includes a File menu, a Window menu and a Help menu. When you create a new project, Oasis montaj first loads the coremenus.omn file, then loads the menu(s) specified by the Default Menu entry in the settings.gx.  When an existing project is opened, the same actions are executed and then any menus that were open when the project was last closed are also displayed.

If the user clears menus, all menus are removed except the coremenus.omn file.

If you want your application to completely control your users menu, you can change the Default Menus entry. You should look at the contents of montaj.smn and montaj_popups to see if there are any components of these menus that you want to include in your application.