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_text()                                                             AES

Syntax

WORD menu_text( tree, obj, text )
OBJECT *tree;
WORD obj;
char *text;

Function       menu_text() changes the text of a menu item.

Opcode         34 (0x22)

Availability   All AES versions.

Parameters     tree specifies the object tree of the menu bar. obj
               specifies the object index of the menu item to change. text
               points to a NULL-terminated character string containing the
               new text.

Binding        intin[0] = obj;

               addrin[0] = tree;
               addrin[1] = text;

               return crys_if(0x22);

Return Value   menu_text() returns a 0 if an error occurred or non-zero
               otherwise.

Comments       The new menu item text must be no larger than the original
               menu item text.

Group          Menu Library