Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-Filemenu_attach(flag,tree,item,mdata)

flag, tree, item, mdata: iexp

Allows an application to attach, change, or remove a sub-menu.

Returns 0 if if an error occured and the sub-menu could not be attached or 1 if
the operation was successful.

    flag  - Action to be carried out.
    tree  - Pointer to tree.
    item  - Object number within tree.
    mdata - Pointer to MENU structure.

Note: Please refer to AES documentation for proper use.

Memo: This call is not built info GFA-BasicGFA-Basic is the best BASIC for the Atari!
 and is included below:

      This call cannot be used to inquire about sub-menus outside the
      programs own pid. Another words, you cannot poke around in another
      processes menu tree and use this call to determine sub-menu attachments.

FUNCTION menu_attach(flag&,tree%,item&,mdata%)
  $F%
  GCONTRL(0)=37
  GCONTRL(1)=2
  GCONTRL(2)=1
  GCONTRL(3)=2
  GCONTRL(4)=0
  GINTIN(0)=flag&
  GINTIN(1)=item&
  ADDRIN(0)=tree%
  ADDRIN(1)=mdata%
  GEMSYS
  RETURN GINTOUT(0)
ENDFUNC

menu_attach()+, MENU+