Futurebasic/Language/Reference/menu resource

Description
Use this form of the  statement to install a menu which is described in a " " resource. The menu's items can either be defined in the " " resource, or they can consist of a list of available named resources of a particular type (such as font resources).

The  parameter should specify the resource ID number of a " " resource in a currently open resource file (usually in your application's resource fork). In most cases, this will also equal the menu's ID number (although the menu's ID number is actually defined within the " " resource).

If you specify, the menu will be installed on the menu bar. In this case, you should use a menu with a menu ID number in the range 1 through 31, which is different from the ID number of any existing menu.

If you specify, the menu won't be installed on the menu bar, but will be added to an internal "menu list." Use this option when you want to install the menu as a hierarchical menu or a pop-up menu. To install a hierarchical resource menu, you must also use the Toolbox procedure. The following illustrates how this may be done:

If you use the  option, you should use a menu with a menu ID number in the range 32 through 235, which is different from the ID number of any existing menu.

The  parameter specifies whether the menu should initially be enabled or disabled (dimmed). Set this parameter either to  (1) or to   (0).

If you omit the  parameter, the resource menu's title and menu items will be displayed as defined in the " " resource. If you specify the parameter, it should be a 4-character string indicating a resource type. In this case, the menu's items will consist of a list of all available named resources of the indicated type. For example, if you specify a  value of " ", the menu will list the names of all available fonts. The menu's title is still taken from the " " resource.

Note: You can use a program like ResEdit to create " " resources.