Menu


There are several levels of controlling the appearance of an add-on command in the menu structure of the server application.

Almost every standard Archicad menu has at least one entry point to mount external tools into. This position can be defined in the menuPosCode parameter of the ACAPI_Register_Menu function. For example if you specify MenuCode_File as the menuPosCode, your add-on command will be inserted into the File menu after the Project Info menu item.

As a general limit none of the main menus can contain more than 63 items. If this limit would exceed by mounting an add-on, the server application opens a new submenu according to the forced menu code, and all the external commands mounted into that menu position will be reorganized into the newly inserted submenu.

Add-Ons can insert even main menus into the menu bar. In this case the menu title must be defined in the first row of the string resource that describes the menu of the Add-On. For more details refer to the ACAPI_Register_Menu section.

Furthermore you can control the accessibility of your add-on commands by appending control codes at the end of each menu item string in the ‘STR#’ resource. This facility lets you enable your command above section/elevation type windows, disable above the floor plan window or when there are no elements selected in the active window. For more information see the Required Resources section.

If you decide to put a menu command into the Floating Palettes submenu of the Window menu (MenuCode_Palettes) for controlling the visibility of your palette, please handle the Show/Hide All Palettes command as it is described in the Modeless Palettes section.