Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileMenu Library
menu_register()                                                         AES

Syntax

WORD menu_register( ap_id, title )
WORD ap_id;
char *title;

Function       menu_register() registers desk accessories in the 'Desk'
               menu and renames MultiTOS applications which appear there.

Opcode         35 (0x23)

Availability   All AES versions.

Parameters     ap_id specifies the application identifier of the
               application to register. title points to a NULL-terminated
               string containing the title which is to appear in the
               'Desk' menu for the accessory or application.
               If ap_id is set to REG_NEWNAME (-1) then the process name
               given in title will be used as the new process name. The
               new process name should be exactly eight characters
               terminated with a NULL. Pad the string with space
               characters if necessary.

Binding        intin[0] = ap_id;

               addrin[0] = title;

               return crys_if(0x23);

Return Value   menu_register() returns a -1 if an error occurred or the
               menu identifier otherwise.

Version Notes  Applications other than desk accessories should not call
               this function unless they are running under MultiTOS.

Comments       Desk accessories should store the return value as this is
               the value that will be included with future AC_OPEN
               messages to identify the accessory.
               Applications running under MultiTOS may use this function
               to provide a more functional title for the 'Desk' menu than
               the program's filename.
               Calling menu_register() with a parameter of REG_NEWNAME is
               used to change the internal process name of the application
               returned by appl_find() and appl_search(). This is useful
               if you know another process will attempt to find your
               application as a specific process name and the user may
               have renamed your application filename (normally used as
               the process name).

Group          Menu Library