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.10  menu_text                                                 TOS

 Name:         »Menu Text« - ersetzt den Text eines Menüeintrags.

 AES-Nummer:   34

 Deklaration:  int16_t menu_text ( OBJECT *me_ttree, int16_t me_titem, 
               CONST int8_t *me_ttext );

 Beschreibung: Die Funktion ändert den Text in einem Menüeintrag. Auf 
               diese Art können Menütexte vom Zustand der Applikation 
               abhängig gemacht, d.h. kontext-sensitiv gestaltet 
               werden. Es gilt:

                Parameter  Bedeutung

                me_ttree   Adresse des Menü-Objektbaumes
                me_titem   Nummer des zu ändernden Menüeintrages
                me_ttext   Adresse des neuen Eintrags

               Wichtig: Der Parameter me_ttext wird von GEM nur als 
               Zeiger benutzt; es wird also keine Kopie des neuen 
               Eintrags angelegt. Ferner sollte man darauf achten, daß 
               der neue Eintrag die Länge des alten nicht 
               überschreitet.

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

 Verfügbar:    All AES versions.

 Gruppe:       Menüs

 Querverweis:  Binding   OBJECT