This function builds a "linked list" of menu items. It returns an array pointer to the top level menu that is made up of (name, value) pairs. If the value is, in turn, another array pointer, then it points to a submenu structure.


       ($name = "Item1"   , $value = "This is item1")
       ($name = "Sub Menu", $value = array reference)
                                +------> @sub_menu_struct
                                          ($name = "SubItem1", $value = ...)
See for a demonstration of using this function and its output.

On success
A reference to an array.
On failure


      $m = ars_GetCharMenuItems($ctrl, $menu_name));
      @menu_struct = @$m;

<-- Table of Contents

Last changes to this page 26th June 1997 by
© J.C.Murphy, J.W.Murphy 1997