Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.15.1  menu_attach                                                TOS

 Name:         »Menu Attach« - Hinzufügen, löschen, verändern und 
               Informationen über ein Submenü ermitteln.

 AES-Nummer:   37

 Deklaration:  int16_t menu_attach ( int16_t mode, OBJECT *tree, 
               int16_t item, MENU *mdata );

 Beschreibung: Die Funktion ermöglicht das hinzufügen, löschen und 
               verändern eines Submenüs. Darüber hinaus lassen sich 
               Informationen über ein Submenü ermitteln. Es gilt:

                Parameter  Bedeutung

                mode       gewünschte Aktion
                            0 =  Information über ein Submenü 
                                 ermitteln und in mdata ablegen.
                            1 =  Hinzufügen oder verändern eines 
                                 Submenüs, dessen Beschreibung in 
                                 mdata abgelegt ist. Besitzt mdata den 
                                 Wert NULL, so wird das Submenü 
                                 entfernt.
                            2 =  Direktes entfernen eines Submenüs; 
                                 mdata sollte ein NULL-Zeiger sein
                tree       Adresse des Menü-Objektbaumes
                item       Index des Objektes, mit dem das Submenü 
                           verknüpft ist (oder werden soll) bzw. von 
                           dem das Submenü entfernt oder verändert 
                           werden soll
                mdata      MENU-Struktur des Submenüs

               Hinweis:

               Nach Möglichkeit sollte nicht mehr als eine Submenü- 
               Ebene zu einem Menüeintrag angelegt werden, obwohl bis 
               zu vier Ebenen unterstützt werden. Die Anzahl der 
               Submenüs pro Menü ist auf 64 begrenzt.

 Ergebnis:     Ein Fehler ist nur dann aufgetreten, wenn als Ergebnis 
               der Wert 0 zurückgegeben wird.

 Verfügbar:    Diese Funktion ist nur Verfügbar seit AES Version 3.30 
               und höher. In AES Version 4.0 und größer sollte 
               appl_getinfo (Opcode 9) benutzt werden ob er Aufruf 
               möglich ist.

 Gruppe:       Menüs

 Querverweis:  Binding   menu_istart   menu_settings   menu_popup 
               XMEN_MGR